ATOM Platform

Developer Note: For current status, architecture, and handover instructions, please see docs/developer_handover.md.

ATOM (Advanced Task Orchestration & Management) is an AI-powered automation platform.

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

"Just talk to Atom - your AI agent that automates complex workflows through simple conversation"

✨ Meet Your Atom Agent

Atom is your conversational AI agent that automates complex workflows through natural language chat. Now with Computer Use Agent capabilities, Atom can see and interact with your desktop applications, automate repetitive tasks, and create visual workflows that bridge web services with local desktop software.

Key Features:

• ✅ Computer Use Agent System - Desktop automation with visual understanding
• ✅ 8/8 marketing claims verified - Platform Complete
• ✅ 33+ service integrations - 5 actively connected (Slack, Google Calendar, Salesforce, HubSpot, Discord)
• ✅ Natural language workflow creation - Just describe what you want
• ✅ Cross-platform coordination - Works across all your tools
• ✅ Production-ready architecture - FastAPI backend, Next.js frontend

🎯 The Atom Difference

Traditional Approach	With Atom
❌ Complex workflow builders	✅ "Just describe what you want"
❌ Manual setup	✅ Conversational automation
❌ Separate tools	✅ One chat interface for everything
❌ Web-only automation	✅ Desktop + Web integration
❌ Can't see your screen	✅ Visual understanding & interaction

🚀 Quick Start

Option 1: Setup Wizard (Recommended)

# 1. Clone the repository
git clone https://github.com/rush86999/atom.git
cd atom

# 2. Run interactive setup wizard
python3 backend/scripts/setup_wizard.py

# 3. Validate your configuration
python3 backend/scripts/validate_credentials.py

# 4. Start the backend
cd backend && python3 main_api_app.py

# 5. Start the frontend (new terminal)
cd frontend-nextjs && npm install && npm run dev

Option 2: Manual Setup

# 1. Clone & configure
git clone https://github.com/rush86999/atom.git
cd atom
cp .env.example .env

# 2. Edit .env with your credentials
# See docs/missing_credentials_guide.md for details

# 3. Install dependencies
cd frontend-nextjs && npm install
cd ../backend && pip install -r requirements.txt

# 4. Start services
python3 backend/main_api_app.py  # Terminal 1
npm run dev --prefix frontend-nextjs  # Terminal 2

Access the application: http://localhost:3000

📖 Documentation:

• Credentials Guide - Configure 117+ integrations
• Developer Handover - Architecture & status
• NextAuth Setup - Authentication config

2. Start Backend

cd backend
python main_api_app.py
# or use: python start_simple_backend.py

3. Start Frontend

cd frontend-nextjs
npm install
npm run dev

4. Start Talking

Open http://localhost:3000 and try these commands:

"Atom, search for my project documents" "Show me my messages from Sarah" "What tasks are due today?" "Automate my meeting follow-ups" "Schedule a team meeting for next week" "Open Excel and create a sales report" "Copy data from my desktop app to Google Sheets" "Automate filling out this form on my screen"

🔍 Specialized Interfaces

🎯 Search UI

• Cross-platform semantic search
• Real-time indexing across all services
• Context-aware results

💬 Communication UI

• Unified inbox (email, Slack, Teams)
• Smart notifications and prioritization
• Cross-platform messaging

📋 Task UI

• Aggregated tasks from all services
• AI-powered prioritization
• Project coordination

⚙️ Workflow Automation UI

• Natural language workflow creation
• Visual drag-and-drop designer
• Multi-step automation builder
• Computer Use Agent - Desktop application control

🖥️ Desktop Automation UI

• Screen capture and visual understanding
• Desktop application integration
• Automated form filling and data entry
• Cross-platform desktop workflows

📅 Scheduling UI

• Unified calendar view
• Smart scheduling and conflict detection
• Meeting coordination

🛠️ Architecture

Frontend

• Next.js 15.5 with TypeScript
• React 18 with Chakra UI + Material-UI
• Real-time collaboration across all services

Backend

• Python FastAPI/Flask APIs
• PostgreSQL with robust data persistence
• LanceDB vector database for AI memory
• OAuth 2.0 security across all integrations

AI & Orchestration

• Advanced NLU System - Understands complex requests
• Multi-Agent Coordination - Specialized AI teams
• Context Management - Remembers conversation history
• Voice Integration - Seamless voice-to-action

🔗 Available Integrations

📄 Document Storage

• Google Drive, OneDrive, Dropbox, Box

💬 Communication

• Slack, Microsoft Teams, Discord, Gmail, Outlook

🎯 Productivity

• Asana, Notion, Linear, Monday.com, Trello

💻 Development

• GitHub, GitLab, Jira

🏢 CRM & Business

• Salesforce, HubSpot, Zendesk, Freshdesk

💰 Financial

• Stripe, QuickBooks, Xero

📊 Current Status

Platform Status: Production Ready

• ✅ 8/8 core claims validated
• ✅ 33 services registered
• ✅ 5 services actively connected
• ✅ Natural language workflow generation
• ✅ Complete BYOK system
• ✅ 132 blueprints loaded

🚢 Deployment

Docker (Recommended)

docker-compose up -d

Manual Setup

# Backend
cd backend
pip install -r requirements.txt
python main_api_app.py

# Frontend  
cd frontend-nextjs
npm install
npm run build
npm start

🤝 Contributing

We welcome contributions! Please see our development guidelines in the docs/ directory.

📄 License

AGPL License - See LICENSE.md for details.

📞 Support

• Issues: GitHub Issues
• Documentation: Check docs/ directory
• Integration Guides: Service-specific implementation docs

---

Start talking to Atom today and experience the future of workflow automation!