ATOM Platform
Open-Source AI Agent Platform for Self-Hosted Automation
Developer Note: For technical setup and architecture, see docs/development/overview.md.
Automate your workflows by talking to an AI — and let it remember, search, and handle tasks like a real assistant.
What is Atom?
Atom is an open-source, self-hosted AI agent platform that combines visual workflow builders with intelligent LLM-based agents.
Just speak or type your request, and Atom's specialty agents will plan, verify, and execute complex workflows across your entire tech stack.
Key Difference: Atom runs entirely on your infrastructure. Your data never leaves your environment.
Comparing alternatives? See Atom vs OpenClaw for a detailed feature comparison.
Atom vs OpenClaw: Quick Comparison
| Aspect | Atom | OpenClaw | |--------|------|----------| | Best For | Business automation, multi-agent workflows | Personal productivity, messaging workflows | | Agent Model | Multi-agent system with specialty agents | Single-agent runtime | | Governance | ✅ 4-tier maturity (Student → Autonomous) | ❌ No maturity levels | | Memory | ✅ Episodic memory with graduation validation | ✅ Persistent Markdown files | | Integrations | 46+ business (CRM, support, dev tools) | 50+ personal (smart home, media, messaging) | | Architecture | Python + FastAPI + PostgreSQL/SQLite | Node.js + local filesystem | | Setup | Docker Compose (~15-30 min) | Single script (~10-30 min) |
Architecture
Single-Tenant Deployment
Atom is designed for self-hosted deployment:
- Simpler Setup: No tenant isolation, no subdomain routing
- Better Performance: Direct database access without overhead
- Self-Hosted: Your data never leaves your infrastructure
- Unlimited Usage: No subscription fees or quota limits
Key Features:
- Uses
user_idfor user identification - No billing system or quota enforcement
- Fleet recruitment limited by system resources only
- All governance, routing, and graduation features work identically
Meta-Agent Routing ✨
Intelligent CHAT/WORKFLOW/TASK routing with governance checks and dynamic fleet recruitment
Quick Start
# Install Atom
pip install atom-os
# Initialize
atom init
# Add your API keys to .env
# OPENAI_API_KEY=sk-...
# MINIMAX_API_KEY=... (optional, for MiniMax M2.7 support)
# (Optional) Connect to marketplace for commercial specialty skills
# MARKETPLACE_API_TOKEN=at_saas_your_token # Get from https://atomagentos.com
# Start Atom
atom start
# Open dashboard
open http://localhost:8000
That's it! 🚀
Optional: Connect to Marketplace →
Choose your edition:
- Personal Edition - Free, single-user, SQLite (default)
- Enterprise Edition - Multi-user, PostgreSQL, monitoring →
pip install atom-os[enterprise]
Key Features
🎙️ Voice Interface
- Build complex workflows using just your voice
- Natural language understanding — no proprietary syntax
- Real-time feedback as Atom visualizes its reasoning
🤖 Specialty Agents
- Sales, Marketing, Engineering: CRM pipelines, campaigns, deployments, incidents
- Hive Orchestration: Queen Agent (architectural design) and FleetAdmiral (dynamic specialist recruitment)
- Self-Evolving Capabilities: Memento Skills learns from failures, AlphaEvolver optimizes via mutation ✨ NEW
- Governance: Progress from "Student" to "Autonomous" as they gain trust
Special Agents Guide → | Queen Agent → | Auto-Dev →
🎨 Canvas Presentations & Real-Time Guidance ✨
Rich interactive presentations (charts, forms, markdown) with live operation visibility, multi-view orchestration, smart error resolution, and AI accessibility (canvas state exposed to agents)
🧠 Autonomous Self-Evolution & Graduation ✨
Experience-based learning with recursive self-evolution, dual-trigger graduation (SUPERVISED → AUTONOMOUS), and hybrid PostgreSQL + LanceDB storage
🛡️ Agent Governance System
- 4-tier maturity-based routing and approval system
- AI-powered training duration estimation
- Every action logged, timestamped, and traceable
🔌 Deep Integrations
- 46+ business integrations: Slack, Gmail, HubSpot, Salesforce, Zendesk
- 9 messaging platforms: Real-time communication
- Marketplace Connection: Access 5,000+ community skills and agent templates ✨ NEW
- Use
/run,/workflow,/agentsfrom your favorite chat app
🔍 Knowledge Graph & GraphRAG ✨
Recursive knowledge retrieval via BFS traversal, canonical anchoring to database records, bidirectional sync, and D3-powered visual explorer
🌐 Community Skills & Package Marketplace ✨
5,000+ OpenClaw/ClawHub skills with PostgreSQL marketplace, LLM-powered security scanning (21+ malicious patterns), DAG skill composition, Python + npm auto-installation with vulnerability scanning, and supply chain protection
Community Skills Guide → | Python Packages → | npm Packages →
🔍 Browser & Device Automation
- Browser automation via CDP (scraping, form filling)
- Device control (camera, location, notifications)
- Maturity-governed for security
Installation Options
🐳 Docker (5 minutes)
git clone https://github.com/rush86999/atom.git
cd atom
cp .env.personal .env
docker-compose -f docker-compose-personal.yml up -d
🚀 DigitalOcean (1-Click Deploy)
Launch Atom on DigitalOcean App Platform with one click:
💻 Native (10 minutes)
git clone https://github.com/rush86999/atom.git
cd atom
cd backend && python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cd ../frontend-nextjs && npm install
cp .env.personal .env
# Start backend: cd backend && python -m uvicorn main_api_app:app --reload
# Start frontend: cd frontend-nextjs && npm run dev
Marketplace (Commercial Service)
Commercial marketplace for agents, domains, components, and skills at atomagentos.com. Requires API token connection. Core platform is AGPL v3 (open source), marketplace items are proprietary. See LICENSE.md for terms.
Setup: Add ATOM_SAAS_API_TOKEN to .env and restart. Marketplace Documentation →
Example Use Cases
| Department | Scenario | |----------------|-------------| | Sales | New lead in HubSpot → Research → Score → Notify Slack | | Finance | PDF invoice in Gmail → Extract → Match QuickBooks → Flag discrepancies | | Support | Zendesk ticket → Analyze sentiment → Route urgent → Draft response | | HR | New employee in BambooHR → Provision → Invite → Schedule orientation |
Security & Privacy
Self-hosted deployment, BYOK (OpenAI/Anthropic/Gemini/DeepSeek/MiniMax), encrypted storage (Fernet), audit logs, human-in-the-loop approvals, package security scanning, supply chain protection, comprehensive testing (495+ tests), AI-enhanced bug discovery, and stress testing
Security Documentation → | Testing Guide →
Documentation
User Guides ⭐
- User Guide Index - Complete user documentation (START HERE)
- Quick Start Guide - Get started in 15 minutes
- User Guide - Core features and daily workflows
Core Features
- Agent System - Multi-agent governance and orchestration
- Community Skills Guide - 5,000+ skills with Python & npm packages
- Python Package Support - NumPy, Pandas, 350K+ packages
- npm Package Support - Lodash, Express, 2M+ packages
- Episodic Memory - Agent learning system
- Agent Graduation - Promotion framework
- Student Training - Maturity routing
Testing & Quality ✨ NEW
- Quality Assurance Guide - Comprehensive QA practices and standards
- Quality Metrics Dashboard - Live quality metrics and trends
- Bug Fix Process - TDD-based bug fixing workflow
- Coverage Report Guide - Coverage measurement and improvement
- E2E Testing Guide - 91+ comprehensive end-to-end tests
- Bug Discovery Infrastructure - AI-enhanced bug discovery
- Test Quality Standards - Testing best practices
- [Cross-Pla