Repository homepage: the canonical entry for stars and forks is the root README.md. Stats sync: intro copy, badges, aggregate tables, and footer counts must match the root README and docs/reference/inventory.md (refresh via uv run python scripts/doc_inventory.py and pytest --collect-only as documented there).

🐜 Codomyrmex

AI-Native Modular Coding Workspace

Modular, agentic Python workspace for software engineering, personal AI infrastructure, and multi-agent orchestration.

Codomyrmex is a production-grade library of 130 top-level modules under src/codomyrmex/ spanning AI agents, cloud infrastructure, security, finance, multimedia, and more — all built on a strict Zero-Mock testing policy ensuring every method is real, tested, documented, and functional. The ecosystem exposes 608 runtime MCP tools from 623 production @mcp_tool lines in Python sources for Claude, Gemini, GPT, and any Model Context Protocol client (docs/reference/inventory.md). It includes 3,000+ Python files, 35,375 collected tests (uv run pytest tests/ --collect-only -q --no-header --override-ini='addopts=' --import-mode=importlib), 1,203 markdown files under docs/ (recursive; see inventory), and 37 GitHub Actions workflows.

# Install
git clone https://github.com/docxology/codomyrmex.git && cd codomyrmex
uv sync --all-groups

# Verify
uv run codomyrmex doctor --all

📋 Table of Contents

• Documentation Hub
• System Architecture
• Module Inventory
• Module Dependency Architecture
• Agent Orchestration Pipeline
• Project Structure
• Aggregate Statistics
• LLM Provider Matrix
• Agent Dispatch Architecture
• Testing Philosophy
• Configuration Architecture
• Personal AI Dashboard
• Quick Start
• Documentation Standards
• GitHub Actions Workflows
• License

✨ Why Codomyrmex?

📚 Documentation Hub

Top-Level Documents

Documentation Directories

📐 System Architecture

graph TB
    subgraph Core["🧠 Core Intelligence"]
        LLM["LLM Subsystem"]
        Agents["Agent Framework"]
        Cerebrum["Cerebrum Reasoning"]
        Orchestrator["Orchestrator"]
        MCP["Model Context Protocol"]
    end

    subgraph AI["🤖 AI & ML"]
        EvolutionaryAI["Evolutionary AI"]
        GraphRAG["Graph RAG"]
        PromptEng["Prompt Engineering"]
        VectorStore["Vector Store"]
        Coding["Coding Agents"]
        Skills["Skills Engine"]
    end

    subgraph Infra["☁️ Infrastructure"]
        Cloud["Cloud (AWS/GCP/Azure)"]
        Containerization["Containerization"]
        CICD["CI/CD Automation"]
        Deployment["Deployment"]
        EdgeComputing["Edge Computing"]
        Networking["Networking"]
    end

    subgraph Data["💾 Data & Storage"]
        DB["Database Management"]
        Cache["Cache Layer"]
        DataLineage["Data Lineage"]
        Serialization["Serialization"]
        Documents["Documents"]
        FeatureStore["Feature Store"]
    end

    subgraph Security["🔒 Security"]
        Auth["Authentication"]
        Crypto["Cryptography"]
        Encryption["Encryption"]
        Privacy["Privacy"]
        Defense["Defense"]
        Identity["Identity"]
    end

    subgraph Media["🎨 Multimedia"]
        Audio["Audio"]
        Video["Video"]
        Multimodal["Multimodal"]
        DataViz["Data Visualization"]
        Meme["Meme Generator"]
    end

    subgraph PAI["🏠 Personal AI"]
        Email["Email"]
        Calendar["Calendar"]
        Finance["Finance"]
        Wallet["Wallet"]
        Website["Website"]
        PAIDash["PAI Dashboard"]
    end

    subgraph DevTools["🛠️ Developer Tools"]
        CLI["CLI"]
        IDE["IDE Integration"]
        GitOps["Git Operations"]
        GitAnalysis["Git Analysis"]
        TreeSitter["Tree-sitter"]
        StaticAnalysis["Static Analysis"]
        Terminal["Terminal Interface"]
    end

    Core --> AI
    Core --> Infra
    Core --> Data
    Core --> Security
    Core --> Media
    Core --> PAI
    Core --> DevTools

    LLM --> Agents
    Agents --> Orchestrator
    Orchestrator --> MCP
    MCP --> Skills

🗂️ Complete Module Inventory

Every module links directly to its source, docs, config, and scripts directories. 130 top-level modules across 10 capability layers — from foundation utilities to ML training primitives.

🧠 Core Intelligence Modules

🤖 AI & Machine Learning Modules

☁️ Infrastructure & DevOps Modules

💾 Data & Storage Modules

🔒 Security & Identity Modules

🎨 Multimedia & Visualization Modules

🏠 Personal AI (PAI) Modules

🛠️ Developer Tooling Modules

⚙️ Configuration & Operations Modules