Skillget

atom

agent
SUMMARY

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

README.md

ATOM Platform

Open-Source AI Agent Platform for Self-Hosted Automation

Developer Note: For technical setup and architecture, see docs/DEVELOPMENT.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: Unlike SaaS alternatives, 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 →

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)

# Start Atom
atom start

# Open dashboard
open http://localhost:8000

That's it! 🚀

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 Agent: CRM pipelines, lead scoring, outreach
  • Marketing Agent: Campaigns, social posting, analytics
  • Engineering Agent: PR notifications, deployments, incidents
  • Hive Orchestration: Autonomous multi-agent coordination with Queen (Architectural Design) and King (Execution Orchestration). ✨ NEW
  • Intelligent request routing: Automatic intent classification to route requests to the most capable specialty agent. ✨ NEW
  • Autonomous Workflow Realization: Convert natural language requests into persistent, executable blueprints via the Queen Agent. ✨ NEW
  • Governance: Progress from "Student" to "Autonomous" as they gain trust

🎨 Canvas Presentations & Real-Time Guidance ✨

  • Rich interactive presentations (charts, forms, markdown)
  • Live operation visibility: See exactly what agents are doing
  • Multi-view orchestration (browser, terminal, canvas)
  • Smart error resolution with actionable suggestions
  • Full Details →

🧠 Autonomous Self-Evolution & Graduation ✨ NEW

  • Experience-based learning: Agents store and retrieve past experiences using the Reflection Pool.
  • Recursive Self-Evolution: Autonomous critique-based optimization loop (optimized for MiniMax M2.7).
  • Dual-Trigger Graduation: Skills progress from SUPERVISED to AUTONOMOUS via post-task event hooks and background audits.
  • Dynamic Streak Rule: Promotion based on "Clean Run" streaks (Success + No Intervention + High Compliance).
  • Hybrid storage: PostgreSQL for state + LanceDB for mistake memory.
  • 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
  • Atom SaaS Sync: Bidirectional sync with Atom marketplace for skills and ratings ✨ NEW
  • Use /run, /workflow, /agents from your favorite chat app

🔍 Knowledge Graph & GraphRAG ✨ NEW

  • Recursive Knowledge Retrieval: Higher-order reasoning via BFS graph traversal.
  • Canonical Anchoring: Link graph nodes to concrete database records (Users, Tickets, Formulas).
  • Bidirectional Sync: Update entity metadata directly from the Graph UI.
  • Visual Explorer: Interactive D3-powered graph visualization at /graph.
  • GraphRAG Documentation →

🌐 Community Skills & Package Marketplace ✨

  • 5,000+ OpenClaw/ClawHub skills: Import community-built tools
  • Skill Marketplace: PostgreSQL-based with search, ratings, categories
  • Enterprise security: LLM-powered scanning (21+ malicious patterns) with hazard sandbox
  • Skills Registry: Import with status tracking (Untrusted → Active → Banned)
  • Dynamic Skill Loading: importlib-based hot-reload with watchdog monitoring
  • Skill Composition: DAG workflows with parallel execution and rollback
  • Auto-Installation: Python + npm with conflict detection and automatic rollback
  • Python Package Support: NumPy, Pandas, 350K+ PyPI packages with vulnerability scanning
  • npm Package Support: Lodash, Express, 2M+ npm packages with governance
  • Supply Chain Security: Typosquatting detection, dependency confusion prevention, postinstall malware blocking
  • Community Skills Guide →

🔍 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

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 Only: Your data never leaves your environment
  • BYOK: Bring your own OpenAI, Anthropic, Gemini, DeepSeek, or MiniMax keys
  • Encrypted Storage: Sensitive data encrypted at-rest (Fernet)
  • Audit Logs: Every agent action logged and traceable
  • Human-in-the-Loop: Configurable approval policies
  • Package Security: Vulnerability scanning (pip-audit, Safety), postinstall script blocking, container isolation
  • Supply Chain Protection: Typosquatting detection, dependency confusion prevention, malicious pattern detection
  • Comprehensive Testing: 495+ tests with 99%+ pass rate, E2E validation with real services ✨
  • AI-Enhanced Bug Discovery: Automated fuzzing, property-based testing, chaos engineering ✨ NEW
  • Stress Testing: Load testing with k6 (10/50/100 concurrent users), network simulation, failure injection ✨ NEW

Documentation

Core

Testing & Quality ✨ NEW

Platform

Advanced

Complete Documentation Index →

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Support

Built with ActivePieces | LangChain | FastAPI | Next.js

Experience the future of self-hosted AI automation.

⭐ Star us on GitHub — it helps!

Yorumlar (0)

Sonuc bulunamadi