Skip to content
Back to search

jarvis

Private local AI assistant for your desktop. Voice and text chat, personal memory, dictation and MCP tools. Runs offline with Ollama or OpenAI-compatible servers on macOS, Windows and Linux.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/isair/jarvis with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/isair/jarvis'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/isair--jarvis/badge.svg)](/listings/isair--jarvis)

HTML

<a href="/listings/isair--jarvis"><img src="/api/listings/isair--jarvis/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**1. Download the app.** Choose your platform from [GitHub Releases](https://github.com/isair/jarvis/releases).

| Platform | Package | Open | | :--- | :--- | :--- | | macOS · Apple Silicon | `Jarvis-macOS-arm64.zip` | Extract, move to Applications, then right-click → Open | | macOS · Intel | `Jarvis-macOS-x64.zip` | Extract, move to Applications, then right-click → Open | | Windows · x64 | `Jarvis-Windows-x64.zip` | Extract, then run `Jarvis.exe` | | Linux · x64 | `Jarvis-Linux-x64.tar.gz` | Extract, then run `./Jarvis/Jarvis` |

**2. Choose your local models.** The setup wizard guides you through speech recognition and a model server. Use [Ollama](https://ollama.com/download), or connect an OpenAI-compatible server you already run, such as LM Studio, oMLX or llama.cpp.

**3. Make it yours.** Allow microphone access and let the first model downloads finish. When Jarvis reports that it is listening, try:

> “Jarvis, help me think through my day.”

Right-click the face or use the tray menu to open **Chat**. Text replies are silent.

<details> <summary><strong>Hardware and model choices</strong></summary>

Memory needs depend on model size, quantisation, context length and speech recognition. Both Ollama and OpenAI-compatible setup show a memory budget; you can edit estimates for models served through an OpenAI-compatible endpoint. Smaller models trade capability for lower resource use.

| Starting point | Chat model | | :--- | :--- | | Smaller hardware | `qwen3.5:0.8b` | | Constrained memory | `gemma4:e2b` | | Default | `gemma4:e4b` | | Larger local setup | `qwen3.8:27b` |

Budget memory for Whisper and, when different from chat, the fast model used for voice intent and tool routing. Apple Silicon uses unified memory; other GPUs use dedicated VRAM. Setup budgets chat and fast together alongside the selected Whisper model, using E2B for fast tasks when it fits or sharing E4B across both roles to save memory. Apple Silicon estimates reserve memory for macOS. Saved model choices are preserved, and insufficient memory shows CPU fallback guidance.

For an experimental 27B alternative, see the [Bonsai 2 local setup guide](docs/BONSAI.md).

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 287 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # Jarvis
  3. ### Your intelligence. Your hardware.
  4. A private, local-first AI assistant with voice and text chat.<br>
  5. Talk naturally, as if Jarvis were a third person in the room.
  6. **Voice-first · Local AI · Personal memory · No subscription**
  7. [**Download Jarvis →**](https://github.com/isair/jarvis/releases) &nbsp; · &nbsp; [Website](https://barissencan.com/jarvis/) &nbsp; · &nbsp; [Get started](#quick-install) &nbsp; · &nbsp; [Explore the app](#inside-jarvis) &nbsp; · &nbsp; [Support the project](#support)
  8. </div>
  9. ---
  10. ## An assistant that lives with you, not in the cloud
  11. Jarvis is built to be part of the conversation. Talk through an idea, discuss plans with a friend, then ask “Jarvis, what do you think?” While listening, it keeps a short, temporary rolling transcript of nearby speech so it can join an ongoing conversation using what was just discussed.
  12. Address Jarvis by name anywhere in a sentence and follow up naturally. Speech recognition, language models and speech synthesis run on hardware you control.
  13. Your diary and knowledge graph stay on your computer. Speech and chat models run locally when you use a local model server. Sensitive information is redacted before reaching model context or the saved diary. Web search, weather and connected tools use the network for those requests.
  14. <p align="center">
  15. <img src="docs/img/face.png" alt="Jarvis's floating amber face, with no frame or background" width="420">
  16. </p>
  17. <p align="center"><sub>A voice, a face, and a place in the conversation.</sub></p>
  18. ## Quick Install
  19. **1. Download the app.** Choose your platform from [GitHub Releases](https://github.com/isair/jarvis/releases).
  20. | Platform | Package | Open |
  21. | :--- | :--- | :--- |
  22. | macOS · Apple Silicon | `Jarvis-macOS-arm64.zip` | Extract, move to Applications, then right-click → Open |
  23. | macOS · Intel | `Jarvis-macOS-x64.zip` | Extract, move to Applications, then right-click → Open |
  24. | Windows · x64 | `Jarvis-Windows-x64.zip` | Extract, then run `Jarvis.exe` |
  25. | Linux · x64 | `Jarvis-Linux-x64.tar.gz` | Extract, then run `./Jarvis/Jarvis` |
  26. **2. Choose your local models.** The setup wizard guides you through speech recognition and a model server. Use [Ollama](https://ollama.com/download), or connect an OpenAI-compatible server you already run, such as LM Studio, oMLX or llama.cpp.
  27. **3. Make it yours.** Allow microphone access and let the first model downloads finish. When Jarvis reports that it is listening, try:
  28. > “Jarvis, help me think through my day.”
  29. Right-click the face or use the tray menu to open **Chat**. Text replies are silent.
  30. <details>
  31. <summary><strong>Hardware and model choices</strong></summary>
  32. Memory needs depend on model size, quantisation, context length and speech recognition. Both Ollama and OpenAI-compatible setup show a memory budget; you can edit estimates for models served through an OpenAI-compatible endpoint. Smaller models trade capability for lower resource use.
  33. | Starting point | Chat model |
  34. | :--- | :--- |
  35. | Smaller hardware | `qwen3.5:0.8b` |
  36. | Constrained memory | `gemma4:e2b` |
  37. | Default | `gemma4:e4b` |
  38. | Larger local setup | `qwen3.8:27b` |
  39. Budget memory for Whisper and, when different from chat, the fast model used for voice intent and tool routing. Apple Silicon uses unified memory; other GPUs use dedicated VRAM. Setup budgets chat and fast together alongside the selected Whisper model, using E2B for fast tasks when it fits or sharing E4B across both roles to save memory. Apple Silicon estimates reserve memory for macOS. Saved model choices are preserved, and insufficient memory shows CPU fallback guidance.
  40. For an experimental 27B alternative, see the [Bonsai 2 local setup guide](docs/BONSAI.md).
  41. </details>
  42. ## What you can do
  43. - **A third person in the room.** Bring Jarvis into an ongoing conversation with friends, talk through a problem aloud, or ask it to weigh in on a decision. “Jarvis, what do you think?” draws on the recent discussion, not just that one sentence.
  44. - **Remember beyond one session.** Ask about past conversations, preferences and plans. Browse your local diary and knowledge graph in the Memory Viewer.
  45. - **Get things done.** Built-in tools cover web search, weather, time, screenshot OCR, file access, optional search across your text and Markdown folders, nutrition tracking and optional location awareness.
  46. - **Connect your own tools.** MCP servers add browser automation, smart-home controls and other integrations.
  47. - **Dictate into other apps.** Hold a hotkey, speak, then release to paste locally transcribed text. See the [platform limitations](#known-limitations) first.
  48. - **Type when you need to.** The companion chat shares your voice conversation and memory. Text replies are silent, and you can rewind a sent message to regenerate from that point.
  49. - **Optional background work.** Enable Background Tasks in Settings to queue work locally, follow results and cancel requests. Off by default.
  50. ### Bring Jarvis into the discussion
  51. > **You:** We could have a picnic tomorrow.
  52. >
  53. > **A friend:** Depends on the weather. Should we plan something indoors instead?
  54. >
  55. > **You:** Jarvis, what do you think?
  56. Jarvis can use the recent conversation to understand that you are asking about the weather for the picnic, rather than treating the last sentence as an isolated question. This is the experience it is built around. Personalised requests can also draw on saved conversation history when no external tools are needed. How reliably it understands the context depends on speech recognition and your chosen model; see the [evaluation results](EVALS.md).
  57. ## Inside Jarvis
  58. Keep setup, activity and settings within reach.
  59. ### A guided start
  60. Choose the runtime that fits your machine. Setup walks through local models, speech and optional capabilities without requiring you to edit a configuration file.
  61. <p align="center">
  62. <img src="docs/img/setup-provider.png" alt="Current setup wizard with separate cards for Ollama and an OpenAI-compatible local server" width="900">
  63. </p>
  64. ### Progress you can actually follow
  65. The activity timeline keeps ordinary events readable. Downloads have a separate card with transferred bytes, percentage, speed and remaining time when the downloader provides them. Loading and warmup are distinct stages.
  66. <p align="center">
  67. <img src="docs/img/logs.png" alt="Jarvis Logs showing a speech model download at 48 percent, transferred bytes, speed, remaining time and a yellow optional-location warning" width="900">
  68. </p>
  69. ### Your setup, without the JSON
  70. Choose models, tune speech recognition, configure tools and enable Low Power Mode from **Settings** in the tray menu.
  71. <p align="center">
  72. <img src="docs/img/settings-window.png" alt="Jarvis Settings with a category sidebar and speech recognition controls" width="900">
  73. </p>
  74. ### A quiet companion to voice
  75. Open Chat for silent replies in the same conversation. **Pause Voice Listening** stops room transcription during meetings while chat and dictation stay available.
  76. <p align="center">
  77. <img src="docs/img/chat-window.png" alt="Jarvis companion chat in its rounded graphite phone-style window, showing illustrative messages and an amber composer" width="480">
  78. </p>
  79. ## Known limitations
  80. Jarvis is developed primarily on macOS. Windows and Linux behaviour may differ. See the [evaluation results](EVALS.md) for tested capabilities.
  81. - **Accuracy and speed depend on your models and hardware.** Smaller models can miss parts of complex requests, and slow speech recognition can drop utterances.
  82. - **Dictation is unavailable on macOS 26+** ([#172](https://github.com/isair/jarvis/issues/172)). Linux dictation requires X11, with limited Wayland support.
  83. - **Spoken “stop” can be mistaken for echo** while Jarvis is speaking ([#24](https://github.com/isair/jarvis/issues/24)).
  84. - **No mobile app** is available ([#17](https://github.com/isair/jarvis/issues/17)).
  85. ## Configuration
  86. Most people can use **Settings** from the tray. Advanced setups can edit `~/.config/jarvis/config.json`.
  87. [**Open the configuration guide →**](docs/CONFIGURATION.md)
  88. The guide covers local model servers, speech recognition, Low Power Mode, voices, dictation, location, MCP integrations and troubleshooting.
  89. ### Dictation at a glance
  90. | Platform | Default hotkey |
  91. | :--- | :--- |
  92. | Windows | Ctrl + Win |
  93. | macOS, where supported | Ctrl + Option |
  94. | Linux | Ctrl + Alt |
  95. Hold to record and release to paste. Double-tap for hands-free recording. Optional filler-word removal, a custom dictionary and dictation history are available in Settings. macOS needs Accessibility permission; Linux requires X11, with limited Wayland support.
  96. ### Bring your own tools
  97. Connect MCP servers for browser automation, Home Assistant, GitHub, databases and more. Credentials and network access depend on the tools you choose. Review a server's permissions before enabling it.
  98. [Integration examples and server settings →](docs/CONFIGURATION.md#mcp-integrations)
  99. ## Troubleshooting
  100. - 🔇 **Speech output unavailable:** A voice-model or dependency failure disables speech output for the current run. Check the reason in Logs, correct the voice model settings or missing dependencies, then restart Jarvis.
  101. - 🔊 **Piper download interruptions:** Connection resets and timeouts receive bounded retries. If they persist, check connectivity and restart Jarvis; completed voice files are retained. Certificate errors require correcting the trust configuration.
  102. - 📥 **Whisper download failures:** Faster-whisper downloads run in a separate process with a five-minute limit. If a download crashes or times out, restart Jarvis to resume it; cached models stay available offline.
  103. - 🎤 **Whisper cache errors:** Jarvis attempts one clean download recovery per startup. If it fails, check connectivity and free disk space, then follow the printed cache guidance and restart. Device fallbacks retain files downloaded during recovery.
  104. <details>
  105. <summary><strong>No default microphone found</strong></summary>
  106. Select an available microphone in Jarvis Settings, or set a default recording input in your system Settings, then restart Jarvis. Jarvis keeps the selected input throughout startup and does not choose another microphone automatically when the default is unavailable.
  107. </details>
  108. <details>
  109. <summary><strong>Bluetooth microphone will not start</strong></summary>
  110. Select the headset's microphone/input profile in Settings, not its playback device. Jarvis uses the selected input for listening and dictation, tries compatible mono, stereo and device-native capture formats, then converts multichannel input to mono for speech recognition. If that input is unavailable, select another microphone in Settings. If capture still fails, check that the microphone works in your system's recorder and share the error from Logs; Bluetooth driver/profile limitations can still prevent capture.
  111. </details>
  112. <details>
  113. <summary><strong>Linux says Listening, but never hears speech</strong></summary>
  114. Check Logs for missing-callback or silent-input warnings. Verify the recording source and mute state in PipeWire/PulseAudio, and select a microphone rather than an output monitor. Set `JARVIS_VOICE_DEBUG=1` for capture-level diagnostics. See the [troubleshooting guide](docs/CONFIGURATION.md#troubleshooting).
  115. </details>
  116. <details>
  117. <summary><strong>Downloads look paused</strong></summary>
  118. Open **Logs** from the tray. The progress card shows transfer details when available and elapsed waiting time when updates pause. After downloading, loading the model into memory is a separate step.
  119. </details>
  120. <details>
  121. <summary><strong>Warmup passed, but a request timed out</strong></summary>
  122. Warmup checks model loading with a small probe, not a full request. Voice intent detection has a separate timeout from chat. Check the limit shown in the log and your local server's responsiveness.
  123. </details>
  124. <details>
  125. <summary><strong>The Mac gets warm, or I want lower background usage</strong></summary>
  126. Enable **Settings → Features → Low Power Mode**. It skips LLM startup warmup and shortens Ollama model residency while keeping speech recognition ready. The first model request after idle may take longer.
  127. </details>
  128. [More troubleshooting →](docs/CONFIGURATION.md#troubleshooting)
  129. ## For Developers
  130. <details>
  131. <summary><strong>Run from source</strong></summary>
  132. Source installations require Python 3.11 or later.
  133. ```bash
  134. git clone https://github.com/isair/jarvis.git
  135. cd jarvis
  136. # macOS
  137. bash scripts/run_macos.sh
  138. # Windows (PowerShell, with Micromamba)
  139. pwsh -ExecutionPolicy Bypass -File scripts\run_windows.ps1
  140. # Linux
  141. bash scripts/run_linux.sh
  142. ```
  143. Running from source also enables Chatterbox TTS. Piper works in both packaged and source installations.
  144. </details>
  145. <details>
  146. <summary><strong>Refresh the screenshots</strong></summary>
  147. With the desktop dependencies installed in your Python environment:
  148. ```bash
  149. PYTHONPATH=src python scripts/capture_readme_screenshots.py
  150. ```
  151. The capture script uses the real widgets and illustrative data, isolates configuration in a temporary directory, and blocks network connections and background workers. It does not launch the daemon or use personal conversations. Keep screenshots on separate rows at readable widths.
  152. </details>
  153. [Evaluation results](EVALS.md) · [Report a bug](https://github.com/isair/jarvis/issues) · [Contribute](https://github.com/isair/jarvis/pulls)
  154. ## Privacy & Storage
  155. Local AI is the default, not a paid upgrade. No cloud AI service is required.
  156. - **Local files:** browsing and edits stay inside your home directory. Optional document search reads only text and Markdown folders you explicitly enable.
  157. - **Conversation memory:** stored locally under `~/.local/share/jarvis`.
  158. - **Sensitive information:** redacted before model context and saved diary entries. The in-memory chat still shows what you typed.
  159. - **Network boundaries:** model downloads, web tools and enabled integrations can make network requests. An external model endpoint receives the requests you send to it.
  160. <details>
  161. <summary><strong>Reduce optional network access</strong></summary>
  162. Use a local model endpoint, download the required models first, disable web tools and leave MCP integrations empty. These settings turn off search and automatic location detection:
  163. ```json
  164. {
  165. "web_search_enabled": false,
  166. "wikipedia_fallback_enabled": false,
  167. "brave_search_api_key": "",
  168. "mcps": {},
  169. "location_auto_detect": false,
  170. "location_cgnat_resolve_public_ip": false,
  171. "location_enabled": false
  172. }
  173. ```
  174. These options are not a network firewall. Other online tools and app update checks may still use the network; enforce network restrictions separately if required.
  175. </details>
  176. ## Support
  177. Jarvis is **free for personal use**. For commercial use, [get in touch](mailto:baris@writeme.com).
  178. If it earns a place on your desktop, help keep it growing.
  179. [**Sponsor on GitHub**](https://github.com/sponsors/isair) · [Buy a coffee](https://ko-fi.com/isair) · [Join the discussion](https://github.com/isair/jarvis/discussions)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.