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.

Full Comparison →

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_id for user identification
• No billing system or quota enforcement
• Fleet recruitment limited by system resources only
• All governance, routing, and graduation features work identically

Full Architecture Guide →

Intelligent CHAT/WORKFLOW/TASK routing with governance checks and dynamic fleet recruitment

Meta-Agent Guide →

# 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]

Full Installation Guide →

• Build complex workflows using just your voice
• Natural language understanding — no proprietary syntax
• Real-time feedback as Atom visualizes its reasoning

• 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 →

Rich interactive presentations (charts, forms, markdown) with live operation visibility, multi-view orchestration, smart error resolution, and AI accessibility (canvas state exposed to agents)

Canvas Guide →

Experience-based learning with recursive self-evolution, dual-trigger graduation (SUPERVISED → AUTONOMOUS), and hybrid PostgreSQL + LanceDB storage

Agent Graduation Guide →

• 4-tier maturity-based routing and approval system
• AI-powered training duration estimation
• Every action logged, timestamped, and traceable

• 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, /agents from your favorite chat app

Recursive knowledge retrieval via BFS traversal, canonical anchoring to database records, bidirectional sync, and D3-powered visual explorer

GraphRAG Documentation →

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 automation via CDP (scraping, form filling)
• Device control (camera, location, notifications)
• Maturity-governed for security

git clone https://github.com/rush86999/atom.git
cd atom
cp .env.personal .env
docker-compose -f docker-compose-personal.yml up -d

Launch Atom on DigitalOcean App Platform with one click:

See Cloud Deployment Guide →

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

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 →

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 →

• User Guide Index - Complete user documentation (START HERE)
• Quick Start Guide - Get started in 15 minutes
• User Guide - Core features and daily workflows

• 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

• 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-Platform Testing - Mobile/desktop testing

• Development Guide - Technical setup
• Installation Guide - Complete instructions
• Atom vs OpenClaw - Feature comparison

• Canvas Reference - Canvas operations
• Agent Governance - Maturity levels and permissions
• Meta-Agent Routing - Intent classification and fleet recruitment
• Personal Edition - Local deployment

Complete Documentation Index → | Reorganization Plan →

We welcome contributions! See CONTRIBUTING.md for guidelines.

All contributions must meet quality standards:

1. Tests pass (100% pass rate) - All tests must pass before merge
2. Coverage adequate (≥70%) - New code must have test coverage
3. Code reviewed - At least one approval required
4. Documentation updated - Update docs for new features

See Quality Assurance Guide for details.

• Documentation: docs/INDEX.md - Complete index
• Developer Guide: docs/development/overview.md - Setup
• User Guide Index: docs/USER_GUIDE_INDEX.md - User documentation
• Blog: Substack - Latest updates & insights
• Issues: GitHub Issues
• License: AGPL v3 - LICENSE.md