Install

Requirements

• Node.js ≥ 22.5
• One supported runtime route:
  • Install Claude Code or Codex CLI locally and sign in with your existing account or subscription; or
  • On macOS or Linux, use the DeepSeek Harness bundled with Soloco and enter your own DeepSeek API key in Soloco. No separate DSH install is required.
• Soloco platforms: macOS · Windows · Linux. DSH currently supports macOS and Linux only; use Claude Code or Codex CLI on Windows.

See Agent runtimes for the platform and capability matrix.

Install via npm

npm i -g @soloco/client@latest

Then start it:

soloco

On first run, Soloco walks you through setup, detects the agent runtimes available on your machine, offers the bundled DSH route where supported, and opens the local UI in your browser.

Install via an AI assistant

Because Soloco is built for the agent-first workflow, you can also let an AI assistant set it up. Paste this into Claude Code or Codex:

Install Soloco for me. First check Node.js ≥ 22.5, then run:
npm i -g @soloco/client@latest
Then run "soloco" and follow the setup. It is a local-first orchestrator. I can
use an existing Claude Code or Codex CLI account. On macOS or Linux, I can
instead choose the DeepSeek Harness bundled with Soloco and enter my own
DeepSeek API key in the Soloco UI. Do not ask me to paste an API key into this
chat, and do not enter credentials on my behalf. If a step needs my account,
API key, or payment, stop and ask me.

Stay up to date

soloco update

Or reinstall the latest version: npm i -g @soloco/client@latest.

Check your install

If something isn't working, run the built-in diagnostic:

soloco doctor

It reports each item with a next step: your Node version (Soloco needs Node ≥ 22.5), whether the daemon is running and serving the local UI, and whether a supported runtime is ready. On too-old Node, soloco prints an upgrade message instead of running — install Node 22.5 or newer, then reinstall with npm i -g @soloco/client@latest.

To see which runtimes Soloco detected, run soloco runtimes.

Notes

• Claude Code and Codex CLI are separate local tools: install and sign in to the one you want to use. DSH is bundled with Soloco and does not need a separate install.
• DSH requires your own DeepSeek API key and outbound network access. It is not available on Windows and is never selected automatically. See Agent runtimes for its current capability limits.
• Soloco V2 core is currently closed-source; registration is open — install it and sign in with your account.