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). Ifgit --versiongives no version, runxcode-select --installonce. 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
-
Open Terminal and 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==>. If it stops withgit 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. -
When Hermes asks for a provider (
No provider credential yet), sign in from the same terminal. The wizard is the easiest way:hermes modelPick 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-keyhermes auth add openrouter --type api-key -
Run the installer again. This time it checks that Hermes answers and 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.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:
-
Ask which version is the newest (replace
install.shat the end of your line's address withlatest):curl -fsSL https://get.example.com/k7q2m9x4p8w3n6tz/latest -
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 -
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.