Installation see the installation file and bash the commands in terminal file
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.
- 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
- 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 is useful for testing without a microphone or camera:
python jarvis.py --textpython jarvis.py --once "open Safari"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.
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}The shell is waiting for a closing double quote. Press Control+C and retry
the command with matching quotes.
Make sure the Ollama server is running in another Terminal:
ollama serveThen confirm that the model exists:
ollama listYou should see llama3.2. If not, run ollama pull llama3.2.
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.
Check Microphone permission for the application launching Python, confirm that
portaudio is installed, and test with text mode:
python jarvis.py --textOpen 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.
- 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.