Skip to content
Shriyans737Public

About

Friday is a local voice assistant for macOS. You can speak commands such as "open Spotify", "set the volume to 30", or "remind me to call Mom". It uses Needle for local tool routing and Ollama for open-ended questions. No cloud API key is required. The only online part of voice mode is Google's speech-to-text service. Text mode works without it.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Installation see the installation file and bash the commands in terminal file

Friday for Mac

Friday is a local voice assistant for macOS. You can speak commands such as "open Spotify", "set the volume to 30", or "remind me to call Mom". It uses Needle for local tool routing and Ollama for open-ended questions.

No cloud API key is required. The only online part of voice mode is Google's speech-to-text service. Text mode works without it.

What Friday can do

  • Open or quit Mac applications
  • Set, mute, or unmute system volume
  • Set brightness, sleep the display, lock the screen, or empty the Trash
  • Tell the time or date
  • Search the web, check weather, or open a website in Safari
  • Create Reminders and Notes
  • Answer open-ended questions through a local Ollama model

Requirements

  • A Mac running macOS
  • Python 3.9 or newer
  • Homebrew
  • A microphone for voice mode
  • Ollama for open-ended answers

Modes:

A small always-on-top window shows whether Friday is ready, listening, thinking, or speaking. It also displays what it heard and what it says.

Say commands beginning with “Friday”. The current configuration also accepts phrases without the wake word. To require the wake word every time, set REQUIRE_WAKE_WORD = True in jarvis.py.

Text mode

Text mode is useful for testing without a microphone or camera:

python jarvis.py --text

Run one command

python jarvis.py --once "open Safari"

Example commands

open Spotify
set volume to 20
what is the time
search the web for laptop deals
open youtube.com
what is the weather in Mumbai
remind me to call Mom
create a note saying buy milk
lock my screen

Use stop, exit, or quit to close Friday. Be careful with commands such as quit Terminal, lock my screen, and empty the Trash.

How routing works

Needle reads the functions and docstrings in tools.py and chooses a local tool. Local tools run first. The Ollama fallback is used only when no local tool returns a result. Weather is exposed to Needle only when the request explicitly contains a weather-related word.

To add a command, create a function in tools.py, decorate it with @needle.tool, and add it to ALL_TOOLS:

@needle.tool
def toggle_wifi(state: str):
    "Turn Wi-Fi on or off. state should be 'on' or 'off'."
    subprocess.run(["networksetup", "-setairportpower", "en0", state])
    return {"wifi": state}

Troubleshooting

dquote> appears in Terminal

The shell is waiting for a closing double quote. Press Control+C and retry the command with matching quotes.

Friday says it cannot reach Ollama

Make sure the Ollama server is running in another Terminal:

ollama serve

Then confirm that the model exists:

ollama list

You should see llama3.2. If not, run ollama pull llama3.2.

The camera is unavailable

Close apps that may already be using the camera, check macOS Camera permissions, and disconnect Continuity Camera if your iPhone is selected. Friday tries several camera devices and continues without face checking if no camera is available.

The microphone does not work

Check Microphone permission for the application launching Python, confirm that portaudio is installed, and test with text mode:

python jarvis.py --text

An app action is blocked

Open System Settings → Privacy & Security → Accessibility and allow the Terminal, iTerm, or VS Code application running Friday. AppleScript actions may also require one-time permission approval.

Limitations

  • Friday currently runs from a Terminal rather than as a menu-bar application.
  • Voice transcription uses Google's Web Speech API and therefore needs internet access.
  • Voice mode uses a camera face-presence check; text mode does not.
  • Needle and the Ollama model download weights the first time they are used.

About

Friday is a local voice assistant for macOS. You can speak commands such as "open Spotify", "set the volume to 30", or "remind me to call Mom". It uses Needle for local tool routing and Ollama for open-ended questions. No cloud API key is required. The only online part of voice mode is Google's speech-to-text service. Text mode works without it.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages