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 installcurlorgitwhen they are missing, and to switch on linger once (below). curlandtar, 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
-
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 | bashIt downloads the newest release (
Downloading JARVIS Ultra 1.31), unpacks it into~/jarvis-ultraand 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. -
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. -
When Hermes asks for a provider (
No provider credential yet), sign in from the same terminal:hermes modelThe wizard asks for a provider, your key (for example
<your-anthropic-key>) and a default model.hermes auth add anthropic --type api-keyneeds no browser. An OAuth sign-in prints a link you can open on any device. -
Run the installer again. It checks that Hermes answers, then creates the team:
~/jarvis-ultra/install.shThe team step asks each agent who they are, which spends a few model turns.
-
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:8830there: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.