# aetherframeworkai/aether-framework architecture

> Architecture diagram of the GitHub repository aetherframeworkai/aether-framework, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aetherframeworkai/aether-framework
- Repository: https://github.com/aetherframeworkai/aether-framework

## Overview

##### Main Components Organization

a) Core Layer:
- Meta Pattern Detector and Node Autonomy components
- Modular Agent and Node systems

b) Agent Layer:
- AI Agents system
- Swarm Intelligence components
- Task Scheduling and Execution

c) Integration Layer:
- Blockchain connections (Solana & Ethereum)
- IPFS Storage
- LLM Providers
- Database Systems (MongoDB, Neo4j, Qdrant, SQLite)

d) API & Interface Layer:
- Dashboard
- Advanced API
- Server components

##### Specific Implementation Details

**[Dashboard UI] ←→ [Advanced API]**
- ↑
**[Server Layer]**
- ↑
**┌─────────────────────────────────────┐**
- Core Processing                     │
- ┌─────────┐ ┌─────────┐ ┌────────┐ │
- Decision │ │Lattice  │ │Pattern │ │
- Engine   │ │Engine   │ │Detector│ │
- ┘ └─────────┘ └────────┘ │
- ┘
- ↑               ↑
**┌─────────────┐ ┌─────────────┐**
- AI Agents    │ │Swarm        │
- System       │ │Intelligence │
- ┘ └─────────────┘
- ↑               ↑
**┌─────────────────────────────────────┐**
- Integration Layer                   │
- ┌─────────┐ ┌─────────┐ ┌────────┐ │
- Blockchain│ │IPFS     │ │LLM     │ │
- Services  │ │Storage  │ │Services│ │
- ┘ └─────────┘ └────────┘ │
- ┘

##### Important Elements

a) Core Processing:
- Decision engine's connection to all components
- Lattice engine's role in organizing agents
- Meta pattern detection flow

b) Agent System:
- Modular agent architecture
- Swarm behavior patterns
- Reinforcement learning feedback loops

c) Storage & Integration:
- Database connections (MongoDB, Neo4j, Qdrant, SQLite)
- IPFS storage flow
- Blockchain integration points

d) Communication Flows:
- Task delegation paths
- Consensus mechanisms
- Multi-modal processing routes

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and Classes
    classDef core fill:#b3d1ff,stroke:#333,stroke-width:2px
    classDef agent fill:#90EE90,stroke:#333,stroke-width:2px
    classDef integration fill:#FFB366,stroke:#333,stroke-width:2px
    classDef database fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef api fill:#A9A9A9,stroke:#333,stroke-width:2px

    %% Legend
    subgraph Legend
        L1[Core Components]:::core
        L2[Agent Components]:::agent
        L3[Integration Components]:::integration
        L4[Database Systems]:::database
        L5[API & Interface]:::api
    end

    %% API & Interface Layer
    subgraph Interface
        Dashboard[Dashboard Interface]
        AdvAPI[Advanced API]
        Server[Server Component]
    end

    %% Core Processing Layer
    subgraph CoreProcessing
        DecisionEngine[Decision Engine]
        LatticeEngine[Lattice Engine]
        PatternDetector[Meta Pattern Detector]
        NodeAutonomy[Node Autonomy]
        ModularAgent[Modular Agent System]
    end

    %% Agent Layer
    subgraph AgentSystem
        AIAgents[AI Agents System]
        SwarmIntel[Swarm Intelligence]
        TaskScheduler[Task Scheduling]
        SwarmConsensus[Swarm Consensus]
        TaskExecutor[Task Execution]
    end

    %% Integration Layer
    subgraph IntegrationLayer
        Blockchain[Blockchain Integration]
        IPFS[IPFS Storage]
        LLM[LLM Providers]
    end

    %% Database Layer
    subgraph Databases
        MongoDB[(MongoDB)]
        Neo4j[(Neo4j)]
        Qdrant[(Qdrant)]
        SQLite[(SQLite)]
    end

    %% Relationships
    Dashboard --> AdvAPI
    AdvAPI --> Server
    Server --> CoreProcessing

    DecisionEngine <--> LatticeEngine
    LatticeEngine <--> PatternDetector
    PatternDetector <--> NodeAutonomy
    NodeAutonomy <--> ModularAgent

    CoreProcessing <--> AgentSystem
    AIAgents <--> SwarmIntel
    SwarmIntel <--> TaskScheduler
    TaskScheduler <--> SwarmConsensus
    SwarmConsensus <--> TaskExecutor

    CoreProcessing <--> IntegrationLayer
    AgentSystem <--> IntegrationLayer
    IntegrationLayer <--> Databases

    %% Click Events
    click DecisionEngine "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/core/decision_engine.py"
    click LatticeEngine "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/core/lattice_engine.py"
    click PatternDetector "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/core/meta_pattern_detector.py"
    click NodeAutonomy "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/core/node_autonomy.py"
    click ModularAgent "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/core/modular_agent.py"
    click AIAgents "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/agents/ai_agent.py"
    click SwarmIntel "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/swarm/swarm_behavior.py"
    click TaskScheduler "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/swarm/task_scheduler.py"
    click Blockchain "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/integrations/blockchain.py"
    click IPFS "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/integrations/ipfs_storage.py"
    click LLM "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/integrations/llm_providers.py"
    click MongoDB "https://github.com/AetherFrameworkAI/aether-framework/blob/main/MongoDB/mongodb_client.py"
    click Neo4j "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/neo4j/neo4j_client.py"
    click Qdrant "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/qdrant/qdrant_client.py"
    click SQLite "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/sqlite/sqlite_client.py"
    click Dashboard "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/dashboard/dashboard_server.py"
    click AdvAPI "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/api/advanced_api.py"
    click Server "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/api/server.py"
    click SwarmConsensus "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/swarm/swarm_consensus.py"
    click TaskExecutor "https://github.com/AetherFrameworkAI/aether-framework/blob/main/src/network/task_executor.py"
```
