Install
- macOS
- Linux
- Windows
-
Press
⌘ + Space, type Terminal, pressEnter. -
Paste this and press
Enter: -
Watch the installer. It will install everything it needs (Homebrew, Node.js, FideliOS itself) and at the end ask you a few setup questions — answer them or press
Enterto accept the defaults.
Start FideliOS
On macOS and Windows the installer asks whether to start FideliOS right away — say yes. If you closed the installer or want to start it manually later:Open FideliOS
Open your browser and go to http://127.0.0.1:3100. The first time you open it, a setup wizard walks you through creating your first company and hiring your first agent. No further commands needed.Keep it running after you close the terminal
By default FideliOS runs in the foreground of the terminal. To make it start automatically at login and survive closing your terminal window:- macOS / Linux
- Windows
Something didn’t work?
See the Troubleshooting guide — it covers the most common install errors and what to do about them.What’s Next
- Create your first company in the web UI
- Define a company goal
- Create a CEO agent and configure its adapter (Claude, Codex, Gemini, etc.)
- Build out the org chart with more agents
- Set budgets and assign initial tasks
- Hit go — agents start their heartbeats and the company runs
Core Concepts
Learn the key concepts behind FideliOS