ATOM Documentation

ā† Back to App

ATOM SaaS Documentation

"The First AI Workforce You Can Actually Trust"

Welcome to the comprehensive documentation for ATOM SaaS - a multi-tenant AI agent platform with cognitive architectures, learning engines, and enterprise-grade governance.

Quick Links

šŸš€ Get Started Fast

Documentation by Audience

šŸ‘¤ For Users

Getting Started

Agent Management

Integrations

Canvas & Marketplace

Desktop App

šŸ’» For Developers

Setup & Configuration

Development Standards

Architecture

API Reference

šŸŒ Tenant API Reference

  • Authentication Guide - API keys and OAuth 2.0 setup
  • Interactive Docs: https://[your-tenant].atomagentos.com/api/docs
  • Base API URL: https://[your-tenant].atomagentos.com/api/v1

Development Workflows

šŸ”§ For Administrators

Deployment

Operations

Security & Governance

Troubleshooting

šŸ“š Key Concepts

Brain Systems

ATOM SaaS includes six cognitive brain systems that enable human-like intelligence:

  • Cognitive Architecture - Reasoning, memory, attention, language processing
  • Learning Engine - Experience-based learning and adaptation
  • World Model - Long-term memory with semantic search
  • Reasoning Engine - Proactive intelligence and interventions
  • Cross-System Reasoning - Multi-system data correlation
  • Backend Intelligence - Business logic and communication processing

āš ļø Warning: Brain systems are critical - changes affect all agent behavior. See Brain System Usage.

Multi-Tenancy

Every operation is scoped to a tenant using:

  • Subdomain-based routing (tenant.atomagentos.com or custom domains)
  • Row-Level Security (RLS) in PostgreSQL
  • S3 prefix isolation (s3://atom-saas/{tenant_id}/)
  • Redis namespace separation (tenant:{tenant_id}:...)

šŸ”“ Critical: Always extract tenant context. Never skip tenant_id filtering. See Tenant Isolation Patterns.

Agent Maturity & Calibration

Agents progress through four maturity levels (Student, Intern, Supervised, Autonomous). The Maturity Calibration Service uses AI to analyze Episodic Memory and automatically promotes or demotes agents based on their zero-intervention ratio and success rate.

Capability Graduation

Agents can earn autonomy in specific domains via Capability Graduation. This allows an agent to be "Autonomous" in Marketing but remain as a "Student" in Financial operations until it proves competency in that specific sector.

Self-Evolution (Alpha Evolver)

The Alpha Evolver engine allows agents to autonomously improve their own code and tools. It generates mutations, tests them in Secure Sandboxes, and adopts the highest-performing variants.

BYOK (Bring Your Own Key)

Tenants provide their own LLM API keys stored in tenant_settings table. The platform automatically routes to tenant-provided keys for all AI operations.

šŸŽÆ Architecture Diagram

See full architecture diagrams ā†’

šŸš€ Quick Start

For Users

  1. Create Account (2 min)

    # Visit https://[your-tenant].atomagentos.com
# Click "Sign Up" and verify email

  2. Create Agent (2 min)

    # Navigate to Agents > Create Agent
# Name: "My Assistant"
# Role: General Assistant
# Maturity: Student

  3. Run Task (1 min)

    # Open agent chat
# Type: "Search for recent AI articles"
# Click Execute

šŸ“– Full Quick Start Guide ā†’

For Developers

  1. Clone Repository

    git clone https://github.com/your-org/atom-saas.git
cd atom-saas

  2. Install Dependencies

    # Frontend (Node.js 20+)
npm install

# Backend (Python 3.11+)
cd backend-saas
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

  3. Start Development Servers

    # Terminal 1: Frontend
npm run dev  # :3000

# Terminal 2: Backend
cd backend-saas
uvicorn core.main:app --reload  # :8000

šŸ“– Full Development Setup ā†’

šŸ“– Documentation Index

Architecture

API Reference

Development

User Guides

Deployment

Operations

Troubleshooting

šŸ¤ Contributing

Found a documentation issue? Please:

  1. Check for existing issues in GitHub
  2. Create a new issue with detailed description
  3. Submit a PR with your improvements

Contribution Guidelines ā†’

šŸ“ž Support

Last Updated: 2025-02-06 Documentation Version: 1.0.0 Platform Version: 8.0 (Production Ready)