# gayealiassaikou-dev/mon-jarvis-ia architecture

> Architecture diagram of the GitHub repository gayealiassaikou-dev/mon-jarvis-ia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gayealiassaikou-dev/mon-jarvis-ia
- Repository: https://github.com/gayealiassaikou-dev/mon-jarvis-ia

## Overview

Jarvis is a conversational assistant with web and voice entry points. A request reaches the Jarvis coordinator, which prepares context and a decision, filters permitted tools, and asks the AI engine to respond or act; actions are verified before the answer is returned. The repository also includes mission planning and execution, persistent conversational memory, project/file/code/GitHub tools, music, and trigger-driven mission creation. Some capabilities are documented by imports or README rather than sampled implementation, so their internal links are shown only where supported.

Main entry points: [`core/jarvis.py`](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/jarvis.py) (Jarvis coordinator), [`core/ai_engine.py`](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_engine.py) (AI engine), [`core/tools.py`](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools.py) (Tool dispatcher), [`interface/app.py`](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/interface/app.py) (Web API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_web["Web API<br/>[app.py]"]
  node_conversation[("Conversation store")]
  node_voice["Voice manager<br/>[voice_manager.py]"]
end

subgraph group_orchestration["Assistant orchestration"]
  node_jarvis["Jarvis coordinator<br/>[jarvis.py]"]
  node_decision["Decision engine<br/>[decision_engine.py]"]
  node_brain["Local brain<br/>[local_brain.py]"]
  node_memory[("Memory manager<br/>[memory_manager.py]")]
end

subgraph group_actions["Reasoning and actions"]
  node_ai["AI engine<br/>[ai_engine.py]"]
  node_router["AI router<br/>[ai_router.py]"]
  node_providers["AI providers<br/>[ai_providers.py]"]
  node_tool_catalog["Tool schema<br/>[tools_schema.py]"]
  node_tool_dispatch["Tool dispatcher<br/>[tools.py]"]
  node_file_tools["File tools<br/>[tools_fichiers.py]"]
  node_project_tools["Project tools<br/>[tools_projets.py]"]
  node_github_tools["GitHub tools<br/>[tools_github.py]"]
  node_python_tools["Python tools<br/>[tools_python.py]"]
  node_web_tools["Web search<br/>[tools_web.py]"]
  node_music["Music manager<br/>[music_manager.py]"]
  node_verifiers["Action verifiers<br/>[verifiers.py]"]
  node_validation["Result validation"]
end

subgraph group_state["Missions and memory"]
  node_missions[("Mission manager<br/>[mission_manager.py]")]
  node_planner["Mission planner<br/>[mission_planner.py]"]
  node_executor["Subtask executor"]
  node_triggers["Trigger engine<br/>[trigger_engine.py]"]
end

node_user(("User"))

node_user -->|"sends request"| node_web
node_web -->|"routes chat"| node_jarvis
node_web -->|"stores messages"| node_conversation
node_web -->|"uses voice"| node_voice
node_web -->|"returns response"| node_user
node_jarvis -->|"requests decision"| node_decision
node_jarvis -->|"loads context"| node_brain
node_jarvis -->|"records exchange"| node_memory
node_jarvis -->|"requests response"| node_ai
node_decision -->|"reads agent context"| node_brain
node_ai -->|"routes request"| node_router
node_ai -->|"uses tool definitions"| node_tool_catalog
node_ai -->|"dispatches tools"| node_tool_dispatch
node_ai -->|"checks actions"| node_verifiers
node_ai -.->|"validates results"| node_validation
node_router -.->|"selects provider"| node_providers
node_tool_dispatch -->|"re-exports tools"| node_file_tools
node_tool_dispatch -->|"re-exports tools"| node_project_tools
node_tool_dispatch -->|"re-exports tools"| node_github_tools
node_tool_dispatch -->|"re-exports tools"| node_python_tools
node_tool_dispatch -->|"re-exports search"| node_web_tools
node_ai -->|"imports music actions"| node_music
node_voice -.->|"captures speech"| node_user
node_missions -.->|"plans mission"| node_planner
node_jarvis -->|"creates missions"| node_missions
node_jarvis -->|"requests planning"| node_planner
node_jarvis -->|"starts execution"| node_executor
node_triggers -->|"creates due mission"| node_missions

click node_web "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/interface/app.py"
click node_conversation "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/interface/conversation_store.py"
click node_voice "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/voice_manager.py"
click node_jarvis "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/jarvis.py"
click node_decision "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/decision_engine.py"
click node_brain "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/local_brain.py"
click node_memory "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/memory_manager.py"
click node_ai "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_engine.py"
click node_router "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_router.py"
click node_providers "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_providers.py"
click node_tool_catalog "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_schema.py"
click node_tool_dispatch "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools.py"
click node_file_tools "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_fichiers.py"
click node_project_tools "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_projets.py"
click node_github_tools "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_github.py"
click node_python_tools "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_python.py"
click node_web_tools "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_web.py"
click node_music "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/music_manager.py"
click node_verifiers "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/verifiers.py"
click node_validation "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/validation_manager.py"
click node_missions "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/mission_manager.py"
click node_planner "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/mission_planner.py"
click node_executor "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/subtask_executor.py"
click node_triggers "https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/trigger_engine.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_conversation,node_voice,node_user toneBlue
class node_jarvis,node_decision,node_brain,node_memory toneAmber
class node_ai,node_router,node_providers,node_tool_catalog,node_tool_dispatch,node_file_tools,node_project_tools,node_github_tools,node_python_tools,node_web_tools,node_music,node_verifiers,node_validation toneMint
class node_missions,node_planner,node_executor,node_triggers toneRose
```

## Components

### User interfaces

- [Web API](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/interface/app.py): `interface/app.py`
- [Conversation store](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/interface/conversation_store.py): `interface/conversation_store.py`
- [Voice manager](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/voice_manager.py): `core/voice_manager.py`

### Assistant orchestration

- [Jarvis coordinator](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/jarvis.py): `core/jarvis.py`
- [Decision engine](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/decision_engine.py): `core/decision_engine.py`
- [Local brain](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/local_brain.py): `core/local_brain.py`
- [Memory manager](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/memory_manager.py): `core/memory_manager.py`

### Reasoning and actions

- [AI engine](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_engine.py): `core/ai_engine.py`
- [AI router](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_router.py): `core/ai_router.py`
- [AI providers](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/ai_providers.py): `core/ai_providers.py`
- [Tool schema](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_schema.py): `core/tools_schema.py`
- [Tool dispatcher](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools.py): `core/tools.py`
- [File tools](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_fichiers.py): `core/tools_fichiers.py`
- [Project tools](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_projets.py): `core/tools_projets.py`
- [GitHub tools](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_github.py): `core/tools_github.py`
- [Python tools](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_python.py): `core/tools_python.py`
- [Web search](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/tools_web.py): `core/tools_web.py`
- [Music manager](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/music_manager.py): `core/music_manager.py`
- [Action verifiers](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/verifiers.py): `core/verifiers.py`
- [Result validation](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/validation_manager.py): `core/validation_manager.py`

### Missions and memory

- [Mission manager](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/mission_manager.py): `core/mission_manager.py`
- [Mission planner](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/mission_planner.py): `core/mission_planner.py`
- [Subtask executor](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/subtask_executor.py): `core/subtask_executor.py`
- [Trigger engine](https://github.com/gayealiassaikou-dev/mon-jarvis-ia/blob/main/core/trigger_engine.py): `core/trigger_engine.py`

### Other components

- **User**

## Connections

- User → Web API: sends request (evidence: `interface/app.py`)
- Web API → Jarvis coordinator: routes chat (evidence: `interface/app.py`)
- Web API → Conversation store: stores messages (evidence: `interface/app.py`)
- Web API → Voice manager: uses voice (evidence: `interface/app.py`)
- Web API → User: returns response (evidence: `interface/app.py`)
- Jarvis coordinator → Decision engine: requests decision (evidence: `core/jarvis.py`)
- Jarvis coordinator → Local brain: loads context (evidence: `core/jarvis.py`)
- Jarvis coordinator → Memory manager: records exchange (evidence: `core/jarvis.py`)
- Jarvis coordinator → AI engine: requests response (evidence: `core/jarvis.py`)
- Decision engine → Local brain: reads agent context (evidence: `core/decision_engine.py`)
- AI engine → AI router: routes request (evidence: `core/ai_engine.py`)
- AI engine → Tool schema: uses tool definitions (evidence: `core/ai_engine.py`)
- AI engine → Tool dispatcher: dispatches tools (evidence: `core/ai_engine.py`)
- AI engine → Action verifiers: checks actions (evidence: `core/ai_engine.py`)
- AI engine → Result validation: validates results
- AI router → AI providers: selects provider
- Tool dispatcher → File tools: re-exports tools (evidence: `core/tools.py`)
- Tool dispatcher → Project tools: re-exports tools (evidence: `core/tools.py`)
- Tool dispatcher → GitHub tools: re-exports tools (evidence: `core/tools.py`)
- Tool dispatcher → Python tools: re-exports tools (evidence: `core/tools.py`)
- Tool dispatcher → Web search: re-exports search (evidence: `core/tools.py`)
- AI engine → Music manager: imports music actions (evidence: `core/ai_engine.py`)
- Voice manager → User: captures speech
- Mission manager → Mission planner: plans mission
- Jarvis coordinator → Mission manager: creates missions (evidence: `core/jarvis.py`)
- Jarvis coordinator → Mission planner: requests planning (evidence: `core/jarvis.py`)
- Jarvis coordinator → Subtask executor: starts execution (evidence: `core/jarvis.py`)
- Trigger engine → Mission manager: creates due mission (evidence: `core/trigger_engine.py`)
