Personal Jarvis / docs ← Back to site GitHub

Getting Started

Installation

Installation paths for Windows, macOS, and Linux. Windows is the hardware-tested desktop target.


Personal Jarvis is a full, downloadable desktop app — one product with three native faces. The installer pulls every feature in one step; you bring your own API keys on first run.

Requirements

  • Python 3.11+
  • Node 18+ (only for the npx install path)
  • A microphone and speakers for the voice experience (optional — see headless)
  • No GPU required. Local models are an installed-by-default upgrade, never a hard requirement.

The fastest path. It downloads the signed verifier from the latest stable GitHub Release, builds a Python virtual environment, installs everything, and launches the first-run wizard.

Windows (PowerShell):

irm https://personaljarvis.ai/install.ps1 | iex

macOS · Linux:

curl -fsSL https://personaljarvis.ai/install.sh | bash

Installs the latest verified stable release. Personal Jarvis is provided under the MIT License without warranty. Review permissions before installation.

Developer / Bleeding Edge

These commands track main directly. Use them only when you want the latest development installer instead of the verified stable release.

Windows (PowerShell):

irm https://raw.githubusercontent.com/PersonalJarvis/PersonalJarvis/main/install/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/PersonalJarvis/PersonalJarvis/main/install/install.sh | bash

Manual

Clone it, read every line, then run.

git clone https://github.com/PersonalJarvis/PersonalJarvis
cd PersonalJarvis
python -m venv .venv && source .venv/bin/activate   # Windows: .\.venv\Scripts\Activate.ps1
pip install -e .[full]
jarvis serve

Install flags

FlagEffect
--headlessAPI + WebSocket only, no desktop window or voice
--with-voice-localPull the local STT/TTS/wake models on install
--no-launchInstall only; do not start the app
--no-wizardSkip the first-run key wizard

Headless / servers

No GPU and no audio hardware required. Run Jarvis headless on any Linux box and reach the full experience through the browser UI (over WebSocket) or a channel adapter — Telegram, Discord, SMS, or webhook. The base install boots cleanly on a bare python:3.11-slim container; desktop-only capabilities degrade to a logged no-op where the hardware is absent.

Next: first run & bringing your keys.