Install
You build Rhizome from source on a Mac and run it from there. This takes a few minutes, mostly for the first build.
Before you start
Section titled “Before you start”You need:
- macOS with the Xcode Command Line Tools (
xcode-select --install) - Node.js
^20.19.0or>=22.12.0 - pnpm
- Rust
1.77.2or newer - git
Prime Agent is not required for Chat. Rhizome’s own engine is the only chat engine. Prime and Hermes are no longer chat engines (ADR-0189); leftover code is still in the repo until the follow-up PRs.
Build and run
Section titled “Build and run”git clone https://github.com/tuckcode/rhizome-agent.gitcd rhizome-agent./install.shpnpm tauri dev./install.sh installs the project’s dependencies. If Prime Agent isn’t on the machine, it may still download Prime’s command-line tool. Chat doesn’t use it (ADR-0189), and that step comes out with the leftover engine code. Rhizome doesn’t include a copy of Prime or Node. Chat runs on Rhizome’s own engine.
pnpm tauri dev builds the app and opens it.
Set up Prime (legacy)
Section titled “Set up Prime (legacy)”Skip this section unless you use Prime from the CLI. New chats use Rhizome’s own engine. Add a provider key or use Taproot in Settings → AI Agents. See Set up models and keys.
The first time prime-agent runs in a terminal, it asks you to run /login and choose a model provider. Rhizome’s Settings no longer has a Prime sign-in.
Prime stops when the terminal that started it closes. To keep it running in the background:
(prime-agent --mode daemon >/dev/null 2>&1 &) && sleep 2 && prime-agent statusIf you already have a built copy
Section titled “If you already have a built copy”Quit /Applications/Rhizome.app before you run pnpm tauri dev. Both use the bundle id ai.rhizome.agent, so a second launch attaches to the copy that’s already open.
Look at the interface without an engine
Section titled “Look at the interface without an engine”pnpm devThen open http://localhost:5202. This runs the interface in a browser. Chat doesn’t answer.
First launch: open a vault and send your first message.