JARVIS UltraManualv1.31

Get started

Install on Linux

The installer works on any distribution with systemd user services. Ubuntu 24.04 is the reference; Debian 12, Fedora and Arch work the same way. No desktop is needed: the dashboard is a web page you open from any browser, so a headless server over SSH is fine.

Before you start

  • A user account with sudo. The installer uses it only to install curl or git when they are missing, and to switch on linger once (below).
  • curl and tar, which nearly every distribution has. On a minimal Debian or Ubuntu: sudo apt-get install -y curl.
  • 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.
  • systemd. Without it, the dashboard still runs, but by hand (see Options).
  • About 15 minutes and an internet connection.

Install with one line

YOUTHE INSTALLERSTATUSPaste your install linein a terminalDownload and first rununpack jarvis-ultra · uv syncfolders · Hermes · systemd 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. In a terminal, as your own user (not with sudo), 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 ==>. To read the script before it runs: curl -fsSL <your line's address> | less.

  2. When the installer asks for linger (Switching linger on for <you>, so the dashboard runs with nobody logged in; sudo may ask for your password.), type your password. Linger keeps the dashboard running after you log out and brings it back after a reboot.

  3. When Hermes asks for a provider (No provider credential yet), sign in from the same terminal:

    hermes model
    

    The wizard asks for a provider, your key (for example <your-anthropic-key>) and a default model. hermes auth add anthropic --type api-key needs no browser. An OAuth sign-in prints a link you can open on any device.

  4. Run the installer again. It checks that Hermes answers, then creates the team:

    ~/jarvis-ultra/install.sh
    

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

  5. 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.
    

    A fresh install usually also lists one item under Left to do:: telling the agents who you are. The dashboard does that on its first screen (First sign-in).

The line takes three settings, written before bash: JARVIS_DIR=~/apps/jarvis installs into that folder instead of ~/jarvis-ultra, JARVIS_VOICE=1 also installs Piper and eight voices, and JARVIS_NO_SERVICE=1 installs no service (see Options). For example: curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/install.sh | JARVIS_NO_SERVICE=1 bash.

Install from the archive

The same folder holds each release as a file, if you would rather download it yourself. Replace install.sh at the end of your line's address with latest to see the newest version, then download, unpack and install it:

curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/latest
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

Then go on from step 2 above.

What the installer does

Step What happens
Tools Installs what is missing: uv in ~/.local/bin; curl through apt-get; git through apt-get, dnf or pacman. pnpm and Node.js (in ~/.local/share/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/ (mode 700: 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 systemd user unit, ~/.config/systemd/user/jarvis-ultra.service, with linger on

Every step is safe to run again. Exit code 0 means nothing is left, 2 means the dashboard answers but a step is left for you, and 1 means a step failed (the Stopped: line says why).

Options

Option What it does
--voice Also installs Piper and eight voices (about 500 MB). See Talk to your agents.
--no-hermes Skips the Hermes and team steps
--no-service Installs no service. Use it on a Linux without systemd, and start the dashboard yourself with cd api && uv run python -m app

WSL2

Install Ubuntu from the Microsoft Store and switch systemd on once. Add these lines to /etc/wsl.conf inside Ubuntu:

[boot]
systemd=true

Then run wsl --shutdown in Windows, open Ubuntu again and follow the steps above. The service runs whenever WSL is running, and http://127.0.0.1:8830 opens from the Windows browser.

Open it from another computer

The dashboard listens on 127.0.0.1 only, on purpose. To reach a Linux box from your laptop, use either:

  • An SSH tunnel. Run this on your laptop, then open http://127.0.0.1:8830 there:

    ssh -L 8830:127.0.0.1:8830 you@the-box
    
  • Tailscale, which also works from your phone: Remote access with Tailscale.

Check that it works

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

The last line reads Status: running. To check the port:

ss -ltnp 'sport = :8830'

It should show 127.0.0.1:8830 and nothing wider. Now go on to First sign-in. If something stopped, see Install and service problems.