NeoAgent

The personal AI agent you host yourself.

Its own computer, a memory, a schedule and a voice.
On your hardware, with the model you choose.

https://github.com/user-attachments/assets/ba50e0a5-1846-4738-9720-3fbf732d3659

🏠 On your hardware Home server, NAS, VPS or your own PC. Desktop app, Docker or one script.

🔐 Yours Open source under AGPL-3.0. Any model, local ones included.

✅ Asks, then acts Approval before risky actions.

---

🚀 Install

🖥️ Desktop app	macOS, Windows, Linux. Installs and runs the server for you, no terminal.	Download
🐳 Docker	Home servers, NAS boxes and VPS.	Guide
📜 Script	Linux or macOS with Git and Node.js 20.19+.	Guide

Docker

curl -fsSLO https://raw.githubusercontent.com/NeoLabs-Systems/NeoAgent/main/compose.yaml
docker compose up -d

Script

bash <(curl -fsSL https://raw.githubusercontent.com/NeoLabs-Systems/NeoAgent/main/install.sh)

Then open http://localhost:3333 (or your server's address). The first account you create is automatically assigned administrator privileges.

✨ What it does

🖐️ Its own computer A private Linux desktop with browser and terminal. Watch it work or take over.	🧠 Memory People, preferences and decisions, kept apart from chat history. Browse it as a graph.	⏰ 42 triggers Schedules, new mail, calendar, GitHub, Home Assistant, location, weather and more.
🎙️ Voice Live voice chats, a ringing call when it needs you, and an ESP32 wearable.	💬 24 chat channels WhatsApp, Telegram, Signal, Discord, Slack, Teams, Matrix, iMessage and more.	📱 Devices Its own Android emulator, plus your desktop with per-capability permission.
🎓 Learns by example Teach Mode turns one demonstration into a reusable skill.	🛡️ Guardrails Per-tool permissions, read-only integrations, Bitwarden logins the model never sees.	👥 Multi-user Each account gets its own memory, agents and cloud computer.

Models: OpenAI, Anthropic, Google, xAI, OpenRouter, NVIDIA NIM, MiniMax, GitHub Copilot, Ollama and any OpenAI-compatible endpoint.

🧭 Explore it

💬 Chat	⏰ Automation
🧠 Memory	🔎 Runs

📚 Docs

Start	Use	Run
Installation	Automation	Docker
Models	Memory	Operations
Why NeoAgent	Integrations	Security

Full docs: neolabs-systems.github.io/NeoAgent/docs

🧪 Project status

• Beta. Maintained mainly by one person. Expect breaking changes.
• Security. Read the security boundaries before connecting sensitive accounts.
• Help. Discussions for questions, Issues for bugs, SECURITY.md for vulnerabilities.

📄 License

AGPL-3.0-only. The licensing decision explains why.

_{Made with ❤️ by Neo · NeoLabs Systems}