🚀 Install

NeoAgent supports macOS and Linux hosts. You need Node.js 20 or newer and Docker for the isolated browser and terminal runtime; the installer handles the rest of the application setup and pre-builds the guest runtime image when Docker is available.

npm install -g neoagent
neoagent install

Open http://localhost:3333, create the first account, and configure a model. Local models can run through Ollama; hosted providers can be configured in the application.

Read the installation guide before exposing the service to a network.

✨ What makes it different

• It is a service, not just a chat window. NeoAgent keeps tasks, integrations, memory, connected devices, and messaging channels available between sessions.
• Memory is stored as structured local data. Durable facts are separated from conversation history, scoped by user and agent, and updated when newer information replaces older information. NeoAgent can also index supported integration content with source references. See How memory works.
• It operates real devices. The agent can use an isolated browser and shell, control an Android device or emulator over ADB, or work through a paired Chrome extension and desktop companion.
• Automation can start without a message. Tasks can run on a schedule or from supported Gmail, Outlook, Slack, Teams, personal WhatsApp, and weather events. Android notifications can also start an agent run.
• Agents and users have separate state. Specialist agents can have their own memory, settings, tools, account assignments, conversations, and task history. Multi-user deployments include administrative account controls and optional email confirmation.
• SaaS billing is built in and off by default. Set NEOAGENT_BILLING_ENABLED=true to activate Stripe subscriptions, plan management, free trials, and model access restrictions. When disabled, no payment routes or UI appear anywhere. See Billing.
• The same server has several interfaces. NeoAgent includes web, Android, desktop, and Android launcher clients, messaging bridges, a Chrome extension, and firmware for a supported ESP32-S3 wearable.

🖥️ Interfaces

| Operator interface | Memory | Remote devices | | --- | --- | --- | | | | |

🔎 NeoAgent, OpenClaw, and Hermes

NeoAgent is aimed at people who want a UI-first, self-hosted agent with structured local memory, multi-user administration, automation, and direct Android control in one installation.

OpenClaw has a broader gateway and node ecosystem. Hermes is oriented around a terminal-first agent workflow. NeoAgent is a different tradeoff rather than a blanket replacement for either project.

The comparison page records the concrete differences and links to the source material used.

🧪 Project status

NeoAgent is beta software maintained primarily by one person. Expect breaking changes and rough edges. Review the security boundaries before connecting sensitive accounts or giving the agent access to a personal workstation.

📊 Benchmarks

See Benchmarking for the reproducibility details and suite coverage.

Start with the documentation. Use GitHub Discussions for questions and GitHub Issues for reproducible bugs. Security reports belong in the process described by SECURITY.md.

Made with ❤️ by Neo · NeoLabs Systems