# jjjjstiyyyy/apix architecture

> Architecture diagram of the GitHub repository jjjjstiyyyy/apix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jjjjstiyyyy/apix
- Repository: https://github.com/jjjjstiyyyy/apix

## Overview

APIX is a desktop AI-agent collaboration platform: a user works in the Electron/Vue client, which presents agent conversations and workspace features; the backend runs agent tasks and exposes supporting file, memory, and task-flow services. The graph preserves documented capabilities such as multi-agent work, tools, scheduled tasks, sandboxing, and configurable workflows. Some client-to-service wiring and unsampled subsystems are documented only at product level, so those links are dashed rather than inferred from directory names.

Main entry points: [`AGENT/agent_module/apix_agent/apix_agent_core/agent.py`](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent.py) (Agent orchestration), [`CLIENT/apix-app/src/main/app/app.js`](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/app/app.js) (Electron main), [`CLIENT/apix-app/src/renderer/src/App.vue`](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/renderer/src/App.vue) (Vue workspace), [`AGENT/agent_module/main.py`](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/main.py) (Agent service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_renderer["Vue workspace<br/>[App.vue]"]
  node_client_state["Workspace state<br/>[app.js]"]
  node_electron["Electron main<br/>[app.js]"]
  node_ipc["AI IPC handlers<br/>[ai_chat.js]"]
  node_ws["WebSocket client<br/>[wsClient.js]"]
end

subgraph group_runtime["Agent runtime"]
  node_agent_entry["Agent service<br/>[main.py]"]
  node_agent_core["Agent orchestration<br/>[agent.py]"]
  node_generation["Generation manager"]
  node_context["Context processing<br/>[context_process.py]"]
  node_models["Model adapters<br/>[llm_adapter.py]"]
  node_agents["Multi-agent nodes"]
  node_tools["Agent tools"]
  node_sandbox["Code sandbox"]
end

subgraph group_events["Events and scheduling"]
  node_event_pipe["Event pipeline"]
  node_cron["Scheduled tasks"]
end

subgraph group_services["Data services"]
  node_file_api["File and RAG service<br/>[rag_record.py]"]
  node_file_manager["File data manager"]
  node_file_stores[("File stores<br/>[mysql_server.py]")]
  node_memory["Memory service"]
end

subgraph group_workflow["Task workflows"]
  node_task_flow["Custom task flows<br/>[task_manager.py]"]
end

node_user(("Desktop user"))

node_user -.->|"uses"| node_renderer
node_renderer -->|"updates state"| node_client_state
node_electron -->|"loads UI"| node_renderer
node_electron -->|"registers"| node_ipc
node_electron -->|"registers"| node_ws
node_ipc -.->|"requests"| node_agent_entry
node_ws -.->|"streams events"| node_agent_entry
node_agent_entry -.->|"routes"| node_agent_core
node_agent_core -.->|"manages generation"| node_generation
node_agent_core -.->|"uses context"| node_context
node_agent_core -.->|"calls model"| node_models
node_agent_core -.->|"delegates work"| node_agents
node_agent_core -.->|"invokes tools"| node_tools
node_tools -.->|"runs code"| node_sandbox
node_agent_core -->|"streams output"| node_event_pipe
node_cron -->|"writes events"| node_event_pipe
node_file_api -->|"submits actions"| node_file_manager
node_file_manager -->|"uses stores"| node_file_stores
node_agent_core -.->|"uses file service"| node_file_api
node_agent_core -.->|"uses memory service"| node_memory
node_agent_core -.->|"runs workflows"| node_task_flow

click node_renderer "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/renderer/src/App.vue"
click node_client_state "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/renderer/src/store/app.js"
click node_electron "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/app/app.js"
click node_ipc "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/ipc/ai_chat.js"
click node_ws "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/ws/wsClient.js"
click node_agent_entry "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/main.py"
click node_agent_core "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent.py"
click node_generation "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/generation_manager.py"
click node_context "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/context_manager/context_process.py"
click node_models "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/LLM/llm_adapter.py"
click node_agents "https://github.com/jjjjstiyyyy/apix/tree/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent_factory/agent_node"
click node_tools "https://github.com/jjjjstiyyyy/apix/tree/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/tools"
click node_sandbox "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/sandbox_manager/agent_sandbox_manager.py"
click node_event_pipe "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_event_pipe/stream_event/agent_stream_writer.py"
click node_cron "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent_task/cron_task_manager.py"
click node_file_api "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/routers/rag_record.py"
click node_file_manager "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/core/domain/data_server_manager.py"
click node_file_stores "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/core/domain/mysql_server.py"
click node_memory "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/MEMORY/memory_module/core/domain/data_server_manager.py"
click node_task_flow "https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/TASK/task_flow_module/app/core/task_manager.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_renderer,node_client_state,node_electron,node_ipc,node_ws,node_user toneBlue
class node_agent_entry,node_agent_core,node_generation,node_context,node_models,node_agents,node_tools,node_sandbox toneAmber
class node_event_pipe,node_cron toneMint
class node_file_api,node_file_manager,node_file_stores,node_memory toneRose
class node_task_flow toneIndigo
```

## Components

### Desktop client

- [Vue workspace](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/renderer/src/App.vue): `CLIENT/apix-app/src/renderer/src/App.vue`
- [Workspace state](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/renderer/src/store/app.js): `CLIENT/apix-app/src/renderer/src/store/app.js`
- [Electron main](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/app/app.js): `CLIENT/apix-app/src/main/app/app.js`
- [AI IPC handlers](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/ipc/ai_chat.js): `CLIENT/apix-app/src/main/ipc/ai_chat.js`
- [WebSocket client](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/CLIENT/apix-app/src/main/ws/wsClient.js): `CLIENT/apix-app/src/main/ws/wsClient.js`

### Agent runtime

- [Agent service](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/main.py): `AGENT/agent_module/main.py`
- [Agent orchestration](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent.py): `AGENT/agent_module/apix_agent/apix_agent_core/agent.py`
- [Generation manager](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/generation_manager.py): `AGENT/agent_module/apix_agent/apix_agent_core/generation_manager.py`
- [Context processing](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/context_manager/context_process.py): `AGENT/agent_module/apix_agent/apix_agent_core/context_manager/context_process.py`
- [Model adapters](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/LLM/llm_adapter.py): `AGENT/agent_module/apix_agent/apix_agent_core/LLM/llm_adapter.py`
- [Multi-agent nodes](https://github.com/jjjjstiyyyy/apix/tree/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent_factory/agent_node): `AGENT/agent_module/apix_agent/apix_agent_core/agent_factory/agent_node`
- [Agent tools](https://github.com/jjjjstiyyyy/apix/tree/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/tools): `AGENT/agent_module/apix_agent/apix_agent_core/tools`
- [Code sandbox](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/sandbox_manager/agent_sandbox_manager.py): `AGENT/agent_module/apix_agent/apix_agent_core/sandbox_manager/agent_sandbox_manager.py`

### Events and scheduling

- [Event pipeline](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_event_pipe/stream_event/agent_stream_writer.py): `AGENT/agent_module/apix_agent/apix_event_pipe/stream_event/agent_stream_writer.py`
- [Scheduled tasks](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/AGENT/agent_module/apix_agent/apix_agent_core/agent_task/cron_task_manager.py): `AGENT/agent_module/apix_agent/apix_agent_core/agent_task/cron_task_manager.py`

### Data services

- [File and RAG service](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/routers/rag_record.py): `FILE/file_service/routers/rag_record.py`
- [File data manager](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/core/domain/data_server_manager.py): `FILE/file_service/core/domain/data_server_manager.py`
- [File stores](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/FILE/file_service/core/domain/mysql_server.py): `FILE/file_service/core/domain/mysql_server.py`
- [Memory service](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/MEMORY/memory_module/core/domain/data_server_manager.py): `MEMORY/memory_module/core/domain/data_server_manager.py`

### Task workflows

- [Custom task flows](https://github.com/jjjjstiyyyy/apix/blob/Version_2.2/TASK/task_flow_module/app/core/task_manager.py): `TASK/task_flow_module/app/core/task_manager.py`

### Other components

- **Desktop user**

## Connections

- Desktop user → Vue workspace: uses (evidence: `README.md`)
- Vue workspace → Workspace state: updates state (evidence: `CLIENT/apix-app/src/renderer/src/App.vue`)
- Electron main → Vue workspace: loads UI (evidence: `CLIENT/apix-app/src/main/app/app.js`)
- Electron main → AI IPC handlers: registers (evidence: `CLIENT/apix-app/src/main/app/app.js`)
- Electron main → WebSocket client: registers (evidence: `CLIENT/apix-app/src/main/app/app.js`)
- AI IPC handlers → Agent service: requests
- WebSocket client → Agent service: streams events
- Agent service → Agent orchestration: routes (evidence: `AGENT/agent_module/main.py`)
- Agent orchestration → Generation manager: manages generation
- Agent orchestration → Context processing: uses context
- Agent orchestration → Model adapters: calls model
- Agent orchestration → Multi-agent nodes: delegates work (evidence: `README.md`)
- Agent orchestration → Agent tools: invokes tools (evidence: `README.md`)
- Agent tools → Code sandbox: runs code (evidence: `README.md`)
- Agent orchestration → Event pipeline: streams output
- Scheduled tasks → Event pipeline: writes events (evidence: `AGENT/agent_module/apix_agent/apix_agent_core/agent_task/cron_task_manager.py`)
- File and RAG service → File data manager: submits actions (evidence: `FILE/file_service/routers/rag_record.py`)
- File data manager → File stores: uses stores (evidence: `FILE/file_service/core/domain/data_server_manager.py`)
- Agent orchestration → File and RAG service: uses file service (evidence: `README.md`)
- Agent orchestration → Memory service: uses memory service (evidence: `README.md`)
- Agent orchestration → Custom task flows: runs workflows (evidence: `README.md`)
