zejzl.net

Multi-Agent AI Orchestration Framework

zejzlAI Framework

9-Agent Pantheon Orchestration System

An async message bus AI framework that orchestrates multiple AI models through a specialized 9-agent system for complex task decomposition, execution, validation, and continuous learning.

9 Specialized Agents
7 AI Providers
408K+ Msg/sec Throughput
11/11 Tests Passing

📊 Live System Status

Real-time metrics and performance indicators from the zejzlAI framework.

GitHub Repository

Loading...
Stars
Loading...
Forks
Loading...
Watchers
Fetching last commit...
Last Updated
View on GitHub →

Performance

0 msg/sec
MessageBus Throughput
0 ms
Latency (avg)

Test Suite

ALL TESTS PASSING
11/11 tests passed
100%
🛡️

System Health

API Providers
7/7
Agents
9/9
Message Bus
Active
Persistence
Ready

🚀 Development Phases

Phase 1-3: Foundation
Phase 4: Self-Healing
Phase 5: Advanced AI
Phase 6-7: Enterprise
Phase 9-10: MCP
All development phases complete • Version 0.0.10.0

🚀 Quick Start

Get zejzlAI running in under 5 minutes. Choose your preferred installation method:

📦 Manual Installation

Full control with Python virtual environment:

bash
# 1. Clone repository
git clone https://github.com/zejzl/zejzlAI.git
cd zejzlAI/zejzl_net

# 2. Install dependencies
pip install -r requirements.txt

# 3. Configure API keys (optional)
cp .env.example .env
# Edit .env with your API keys

# 4. Run the framework
python main.py
⏱️ Ready in: ~5 minutes

📋 Prerequisites

🐍 Python 3.10+
🐳 Docker (optional)
💾 Redis (optional - auto fallback to SQLite)
🔑 API keys (optional - works with stubs)

✨ What's Next?

1
Run Interactive Menu python main.py

Choose from single agent, collaboration, or full pantheon mode

2
Start Web Dashboard python web_dashboard.py

Access real-time monitoring at http://localhost:8000

3
Read the Docs Full Documentation →

Architecture guides, API reference, and examples

💡 Quick Examples

Single Agent Mode
python ai_framework.py chat chatgpt "Explain quantum computing"
Collaboration Mode
python main.py -mb --task "Design REST API for todo app"
Full Pantheon
python main.py --pantheon --task "Analyze codebase"

💬 Need help? Check the GitHub Issues or read the full documentation.

📊 System Architecture & Visuals

Explore the internal workings of the zejzlAI framework through interactive diagrams and system visualizations.

🏗️ System Architecture

System Architecture

Complete system overview showing the 9-agent pantheon, message bus, and AI provider integration.

🔄 Message Bus Flow

Message Bus Flow

High-performance async message routing with 408K+ msg/sec throughput and priority queuing.

🤖 Agent Communication

Agent Communication

Observer → Reasoner → Actor → Validator flow with parallel execution and consensus detection.

✨ Multi-Agent Orchestration

Multi-Agent Orchestration

Real-time collaboration between specialized agents with consensus detection and task distribution.

⚡ Performance Metrics

Performance Metrics

Throughput benchmarks, latency tracking, and system telemetry dashboard with real-time monitoring.

🛡️ Self-Healing Magic System

Magic System

Circuit breakers, vitality boosts, and auto-recovery mechanisms for resilient operations.

┌─────────────────────────────────────────────────────────────┐
│                   🖥️  CLI Interface                         │
│                   (Interactive Menu)                         │
├─────────────────────────────────────────────────────────────┤
│              🔄  AsyncMessageBus Layer                      │
│         ┌────────────────────────────────────┐              │
│         │  • Provider Management              │              │
│         │  • Message Routing (408K+ msg/sec)  │              │
│         │  • Conversation History             │              │
│         │  • Circuit Breakers                 │              │
│         └────────────────────────────────────┘              │
├─────────────────────────────────────────────────────────────┤
│                  🤖  9-Agent Pantheon                       │
│                                                              │
│    👁️ Observer ──→ 🧠 Reasoner ──→ ⚡ Actor ──→ ✅ Validator    │
│         ↓              ↓              ↓            ↓         │
│    🔧 Executor ←── 💾 Memory ←── 📊 Analyzer ←── 📚 Learner    │
│                          ↓                                   │
│                     ✨ Improver                              │
│                   (Magic System)                             │
├─────────────────────────────────────────────────────────────┤
│             🌐  AI Provider Layer (7 Providers)             │
│   ChatGPT │ Claude │ Gemini │ Grok │ DeepSeek │ Qwen │ Zai │
│         • Rate Limiting (60/min, 1000/hour)                 │
│         • Smart Retry with Exponential Backoff              │
│         • Circuit Breakers & Auto-Recovery                  │
├─────────────────────────────────────────────────────────────┤
│          💾  Persistence Layer (Hybrid Storage)             │
│              Redis (Primary) + SQLite (Fallback)            │
│         • Conversation History  • Agent State               │
│         • Performance Metrics   • Security Audit            │
└─────────────────────────────────────────────────────────────┘
                

Click any image above to view full-screen! 🔍

📚 Explore Full Documentation

🤖 The 9-Agent Pantheon

Each agent has a unique personality with specialized communication styles and expertise areas, working together through an async message bus for complex AI orchestration.

👁️

Observer

Analytical

Thorough task analysis with systematic decomposition and pattern recognition.

🧠

Reasoner

Logical

Strategic planning with risk assessment and dependency mapping.

Actor

Direct

Practical execution with efficient action planning and rapid deployment.

Validator

Analytical

Rigorous quality assurance with detailed validation reports and testing.

🔧

Executor

Pragmatic

Performs validated tasks with comprehensive error handling and recovery.

💾

Memory

Persistent

Stores and recalls execution state, history, and learned patterns.

📊

Analyzer

Technical

Deep performance analysis with actionable insights and metrics tracking.

📚

Learner

Adaptive

Identifies patterns, bottlenecks, and generates optimization strategies.

Improver

Creative

Innovative system optimization with magic-based self-healing capabilities.

⚡ Key Features

🔄

Async Message Bus

High-performance async/await architecture with 408K+ msg/sec throughput and sub-millisecond (0.007ms) latency.

🤝

Multi-Provider Support

Integrate ChatGPT, Claude, Gemini, Grok, DeepSeek, Qwen, and custom AI models seamlessly.

💾

Hybrid Persistence

Redis primary with SQLite fallback for reliable state management and data persistence.

Self-Healing Magic

Circuit breakers, auto-recovery, and vitality boosts for resilient operations.

🔐

Enterprise Security

End-to-end AES-256-GCM encryption, secure key management, and GDPR compliance.

📊

Performance Monitoring

Real-time telemetry, profiling, and comprehensive analytics dashboard.

🐳

Docker Ready

Production-ready containerization with health checks and orchestration support.

🎯

MCP Integration

Model Context Protocol support with 6+ built-in servers and 36+ tools.

📚 Documentation Hub

Comprehensive guides, API references, and tutorials to get the most out of zejzlAI.

Can't find what you're looking for?

🛠️ Tech Stack

Python 3.10+ AsyncIO Redis SQLite FastAPI WebSocket Docker OpenAI API Anthropic Claude Google Gemini xAI Grok MCP Protocol