You need Node.js 20+ and npm.
- Verify installation:
node -v && npm -v - Install (if missing):
- Mac/Linux: We recommend using nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install 20 - Windows: Download from nodejs.org
- Mac/Linux: We recommend using nvm:
npm install && npm run build| Mode | Command | Description |
|---|---|---|
| Terminal with Yolo Mode(Recommended) | npm run start -- --yolo |
Fully automated execution (no confirmation prompts). |
| Terminal | npm run start |
Default interactive CLI mode. |
| Web UI | npm run start -- web --dev |
Launches backend (port 3333) & frontend (localhost:3000). |
| Daemon Mode | npm run start -- onboard --install-daemon --yolo |
Installs and runs the Actus Agent as a background daemon (with auto-execution enabled) + gmail chatapi gateway setuped . |
To run the backend and frontend independently:
- Backend:
npm run start -- web - Frontend:
cd packages/web && npm run dev
Before submitting PRs, run the full validation suite:
npm run preflight