GitHub - rush86999/atom: Atom Agent, automate your workflows by talking to an AI — and let it remember, search, and handle tasks like a real assistant

6 min read Original article ↗

ATOM Platform

Open-Source AI Agent Platform for Self-Hosted Automation

Developer Note: For technical setup and architecture, see docs/development/overview.md.

Atom Platform

Automate your workflows by talking to an AI — and let it remember, search, and handle tasks like a real assistant.

License Status

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)

Full Comparison →

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

Meta-Agent Routing ✨

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

Meta-Agent Guide →

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]

Full Installation Guide →

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)

Canvas Guide →

🧠 Autonomous Self-Evolution & Graduation ✨

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

Agent Graduation Guide →

🛡️ 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, /agents from 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

GraphRAG Documentation →

🌐 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:

Deploy to DO

See Cloud Deployment Guide →

💻 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 ⭐

Core Features

Testing & Quality ✨ NEW

Platform

Advanced

Complete Documentation Index → | Reorganization Plan →

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Quality Standards

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.

Support