NeoAgent documentation
Everything you need to install, operate, and extend a self-hosted NeoAgent service.
NeoAgent is a self-hosted AI agent that runs continuously on a macOS or Linux server. It provides an operator interface for chat, automation, integrations, memory, and connected devices.
Install it on a machine you administer, start with restricted tool permissions, and read the security guide before connecting sensitive accounts.
🚀 Start here
bash <(curl -fsSL https://raw.githubusercontent.com/NeoLabs-Systems/NeoAgent/main/install.sh)
On a new machine, the bare command detects that NeoAgent is not installed, runs
the installer, and guides you through AI provider API keys. It starts the
service and prints any host-specific action items. Open
http://localhost:3333 when it finishes.
Continue with:
- Install and complete the first run
- Choose and configure a model
- Understand the security boundaries
- Migrate from OpenClaw or Hermes
🧭 User guide
| Guide | Use it for |
|---|---|
| Installation | Host requirements, installation, first run |
| Models | Local, API-key, and account-backed model providers |
| Agents and users | Specialist agents and multi-user administration |
| Automation | Schedules, event triggers, delivery, and run history |
| Memory | What NeoAgent remembers and how to manage it |
| Integrations | Connected app accounts and messaging channels |
| Devices and interfaces | Android, desktop, Chrome, launcher, and wearable surfaces |
| Health | Health Connect |
| Skills and MCP | Reusable instructions and external tool servers |
| Operations | Updates, backups, logs, and recovery |
| Billing | Stripe subscriptions, plans, trials, and webhooks |
| Configuration | Environment and runtime reference |
| Why NeoAgent | Factual comparison with OpenClaw and Hermes |
🛠️ Developer guide
The developer guide explains the implementation rather than the product setup. Start with Architecture, then follow the subsystem links in the developer section of the sidebar.
Contributors must also follow GUIDELINES.md and CONTRIBUTING.md.