Get FideliOS running on macOS with a single command.

​
Prerequisites

  • macOS 12 (Monterey) or later
  • Terminal (built-in — search Spotlight for “Terminal”)
No other software required. The installer handles everything.

​
Install

Open Terminal and run: 
curl -fsSL https://fidelios.nl/install.sh | bash
The script:
  1. Checks for Node.js and installs it if missing
  2. Installs the fidelios CLI globally
  3. Runs a quick health check

​
Start FideliOS

fidelios run
Then open http://127.0.0.1:3100 in your browser. The first time you open it, a setup wizard walks you through creating your first company and hiring your first agent.

​
Stop and Restart

Press Ctrl+C in the terminal window to stop FideliOS. To start it again: 
fidelios run
Your data is preserved between restarts.

​
Where Your Data Lives

DataLocation
Config~/.fidelios/instances/default/config.json
Database~/.fidelios/instances/default/db
Secrets key~/.fidelios/instances/default/secrets/master.key
Logs~/.fidelios/instances/default/logs

​
Access from Other Devices on the Same Network

By default FideliOS only accepts connections from your Mac. To reach it from another device (phone, tablet, another laptop), use Tailscale: 
HOST=0.0.0.0 fidelios run
Then open FideliOS using your Mac’s local IP or Tailscale address. See Tailscale Private Access for the full setup.

​
What’s Next

Core Concepts

Learn how agents, tasks, and goals fit together

Adapters

Connect FideliOS to Claude, Codex, or your own model