JARVIS UltraManualv1.31

Get started

Install on macOS

One line installs everything into your home folder and sets JARVIS Ultra up as a service that starts again after a crash or a restart. You do not need Homebrew.

Before you start

  • macOS 13 or newer.
  • git, from Apple's Command Line Tools (Hermes' installer uses it). If git --version gives no version, run xcode-select --install once. The installer also notices and opens that window for you.
  • Your install line. Backers get it in a backers-only Kickstarter update; it looks like the example below, with a folder name of its own.
  • About 15 minutes and an internet connection.

Install with one line

YOUTHE INSTALLERSTATUSPaste your install linein TerminalDownload and first rununpack jarvis-ultra · uv syncfolders · Hermes · launchd serviceSign in to a providerhermes modelthen run the installer againSecond runHermes answers, so itcreates the teamOpen 127.0.0.1:8830set your password; the firstscreen takes your briefstartsstops for your keyruns it againdashboard answersexit 2Sign-in leftexit 2Brief leftReady
Most installs take two runs. The install line downloads the release, sets everything up and starts the dashboard, then stops for your provider key; the second run creates the team. Every step is safe to run again.
  1. Open Terminal and paste your install line, for example:

    curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/install.sh | bash
    

    It downloads the newest release (Downloading JARVIS Ultra 1.31), unpacks it into ~/jarvis-ultra and runs its installer there. Each step prints a line starting with ==>. If it stops with git needs Apple's Command Line Tools, finish the window that opened, then paste the line again.

    To read the script before it runs, open it first: curl -fsSL <your line's address> | less.

  2. When Hermes asks for a provider (No provider credential yet), sign in from the same terminal. The wizard is the easiest way:

    hermes model
    

    Pick a provider, paste your key (for example <your-anthropic-key>) or sign in, and pick a default model. Other ways to sign in:

    hermes auth add anthropic --type api-key
    
    hermes auth add openrouter --type api-key
    
  3. Run the installer again. This time it checks that Hermes answers and creates the team:

    ~/jarvis-ultra/install.sh
    

    The team step asks each agent who they are, which spends a few model turns.

  4. Read the last lines. You should see:

    JARVIS Ultra answers at http://127.0.0.1:8830. Open it in your browser and set your password.
    

    followed by Left to do: if anything is still open. A fresh install usually lists one item: telling the agents who you are. The dashboard does that for you on its first screen, so you can leave it for First sign-in.

The line takes three settings, written before bash:

Setting What it does
JARVIS_DIR=~/apps/jarvis Installs into that folder instead of ~/jarvis-ultra
JARVIS_VOICE=1 Also installs Piper and eight voices (--voice below)
JARVIS_NO_SERVICE=1 Installs no service (--no-service below)

For example: curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/install.sh | JARVIS_VOICE=1 bash.

Install from the archive

The same folder holds each release as a file, if you would rather download it yourself:

  1. Ask which version is the newest (replace install.sh at the end of your line's address with latest):

    curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/latest
    
  2. Download that version's .tar.gz, unpack it in your home folder and run its installer:

    curl -fLO https://get.example.com/k7q2m9x4p8w3n6tz/jarvis-ultra-1.31.tar.gz
    tar -xzf jarvis-ultra-1.31.tar.gz -C ~
    cd ~/jarvis-ultra
    ./install.sh
    
  3. Go on from step 2 above.

What the installer does

Step What happens
Tools Installs what is missing: uv in ~/.local/bin. pnpm and Node.js (in ~/Library/pnpm) only once you change the web app and it must be built
1. The API's Python environment uv sync makes api/.venv
2. The web app Comes built in web/dist. After you change the web app yourself, pnpm install and pnpm build build it here
3. Folders data/ (only you can read it), logs/ and docs/
4. Hermes Installs Hermes into ~/.hermes, with the hermes command in ~/.local/bin
5. The team scripts/create-team.sh sets up the Orchestrator and five specialists, once Hermes answers
Voice Only with --voice: Piper and eight local voices
The always-on service A launchd agent, ~/Library/LaunchAgents/com.jarvis-ultra.app.plist

Every step is safe to run again, and a run picks up where the last one stopped. The step numbers shift when a step is skipped.

The installer's exit code tells you where you are:

Code Meaning
0 Nothing left to do
2 The dashboard answers, but a step is left for you (the list says which)
1 A step failed; the line starting with Stopped: says why

Options

Option What it does
--voice Also installs Piper and eight voices for spoken replies (about 500 MB). See Talk to your agents.
--no-hermes Skips the Hermes and team steps
--no-service Builds everything but installs no service; start the dashboard yourself with cd api && uv run python -m app

Check that it works

cd ~/jarvis-ultra
uv run scripts/service.py status

The last line reads Status: running. The service runs whenever you are logged in to your Mac.

Now open http://127.0.0.1:8830 in your browser and go on to First sign-in. If something stopped, see Install and service problems.