# xiaoyuanda666-ship-it/bailongma architecture

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

- Interactive diagram: https://gitdiagram.com/xiaoyuanda666-ship-it/bailongma
- Repository: https://github.com/xiaoyuanda666-ship-it/bailongma

## Overview

Bailongma is a continuously running desktop AI agent: users send messages through Brain UI or connected social channels, the local service routes them into the agent loop, and the agent responds using an LLM and selectively exposed tools. Around that path, it injects context and persistent memory, supports knowledge and media features, and streams state back to the UI. The README documents these major subsystems and their interactions; sampled source offers only limited additional relationship evidence, so unsampled internals are represented at subsystem level.

Main entry points: [`src/index.js`](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/index.js) (Agent loop), [`src/ui/brain-ui/app.js`](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/ui/brain-ui/app.js) (Brain UI), [`src/context/gatherer.js`](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/context/gatherer.js) (Context selection), [`src/api.js`](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/api.js) (Local HTTP service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop and access"]
  node_desktop_shell["Electron shell<br/>[main.cjs]"]
  node_local_service["Local HTTP service<br/>[api.js]"]
end

subgraph group_agent["Agent runtime"]
  node_agent_loop["Agent loop<br/>[index.js]"]
  node_llm["LLM layer<br/>[llm.js]"]
end

subgraph group_state["Memory and context"]
  node_context["Context selection<br/>[gatherer.js]"]
  node_memory["Memory system<br/>[injector.js]"]
  node_database[("SQLite persistence<br/>[db.js]")]
  node_knowledge["Knowledge retrieval<br/>[retrieval.js]"]
  node_resource_scanners["Local resource sensing"]
end

subgraph group_actions["Capabilities and integrations"]
  node_capabilities["Capability registry"]
  node_executor["Tool executor<br/>[executor.js]"]
  node_tool_modules["Built-in tools"]
  node_mcp["Browser and MCP<br/>[client-manager.js]"]
  node_social["Social connectors<br/>[index.js]"]
end

subgraph group_experience["User-facing features"]
  node_brain_ui["Brain UI<br/>[app.js]"]
  node_voice["Voice services<br/>[manager.js]"]
  node_ui_panels["UI panels and cards<br/>[knowledge.js]"]
end

node_user(("User"))

node_user -->|"sends messages"| node_brain_ui
node_brain_ui -->|"calls HTTP APIs"| node_local_service
node_local_service -->|"routes messages"| node_agent_loop
node_social -->|"forwards inbound messages"| node_agent_loop
node_agent_loop -->|"requests completions"| node_llm
node_agent_loop -->|"selects runtime context"| node_context
node_context -->|"injects relevant memory"| node_memory
node_context -.->|"adds retrieved knowledge"| node_knowledge
node_memory -->|"reads and writes"| node_database
node_agent_loop -->|"selects tools"| node_capabilities
node_capabilities -->|"routes tool calls"| node_executor
node_executor -->|"executes tools"| node_tool_modules
node_tool_modules -.->|"uses browser tools"| node_mcp
node_agent_loop -->|"routes replies"| node_social
node_agent_loop -->|"generates speech"| node_voice
node_resource_scanners -->|"provides host context"| node_context
node_database -->|"shares chat state"| node_brain_ui
node_local_service -->|"serves panel APIs"| node_ui_panels
node_brain_ui -->|"configures voice"| node_voice
node_desktop_shell -->|"hosts desktop UI"| node_brain_ui

click node_desktop_shell "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/electron/main.cjs"
click node_local_service "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/api.js"
click node_brain_ui "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/ui/brain-ui/app.js"
click node_agent_loop "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/index.js"
click node_llm "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/llm.js"
click node_context "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/context/gatherer.js"
click node_memory "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/memory/injector.js"
click node_database "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/db.js"
click node_knowledge "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/knowledge/retrieval.js"
click node_capabilities "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/capabilities/capability-registry.js"
click node_executor "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/capabilities/executor.js"
click node_tool_modules "https://github.com/xiaoyuanda666-ship-it/bailongma/tree/main/src/capabilities/tools"
click node_mcp "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/mcp/client-manager.js"
click node_social "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/social/index.js"
click node_voice "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/voice/manager.js"
click node_resource_scanners "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/local-resources-scanner.js"
click node_ui_panels "https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/ui/brain-ui/knowledge.js"

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_desktop_shell,node_local_service,node_user toneBlue
class node_agent_loop,node_llm toneAmber
class node_context,node_memory,node_database,node_knowledge,node_resource_scanners toneMint
class node_capabilities,node_executor,node_tool_modules,node_mcp,node_social toneRose
class node_brain_ui,node_voice,node_ui_panels toneIndigo
```

## Components

### Desktop and access

- [Electron shell](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/electron/main.cjs): `electron/main.cjs`
- [Local HTTP service](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/api.js): `src/api.js`

### Agent runtime

- [Agent loop](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/index.js): `src/index.js`
- [LLM layer](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/llm.js): `src/llm.js`

### Memory and context

- [Context selection](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/context/gatherer.js): `src/context/gatherer.js`
- [Memory system](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/memory/injector.js): `src/memory/injector.js`
- [SQLite persistence](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/db.js): `src/db.js`
- [Knowledge retrieval](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/knowledge/retrieval.js): `src/knowledge/retrieval.js`
- [Local resource sensing](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/local-resources-scanner.js): `src/local-resources-scanner.js`

### Capabilities and integrations

- [Capability registry](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/capabilities/capability-registry.js): `src/capabilities/capability-registry.js`
- [Tool executor](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/capabilities/executor.js): `src/capabilities/executor.js`
- [Built-in tools](https://github.com/xiaoyuanda666-ship-it/bailongma/tree/main/src/capabilities/tools): `src/capabilities/tools`
- [Browser and MCP](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/mcp/client-manager.js): `src/mcp/client-manager.js`
- [Social connectors](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/social/index.js): `src/social/index.js`

### User-facing features

- [Brain UI](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/ui/brain-ui/app.js): `src/ui/brain-ui/app.js`
- [Voice services](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/voice/manager.js): `src/voice/manager.js`
- [UI panels and cards](https://github.com/xiaoyuanda666-ship-it/bailongma/blob/main/src/ui/brain-ui/knowledge.js): `src/ui/brain-ui/knowledge.js`

### Other components

- **User**

## Connections

- User → Brain UI: sends messages
- Brain UI → Local HTTP service: calls HTTP APIs
- Local HTTP service → Agent loop: routes messages
- Social connectors → Agent loop: forwards inbound messages
- Agent loop → LLM layer: requests completions
- Agent loop → Context selection: selects runtime context
- Context selection → Memory system: injects relevant memory
- Context selection → Knowledge retrieval: adds retrieved knowledge
- Memory system → SQLite persistence: reads and writes
- Agent loop → Capability registry: selects tools
- Capability registry → Tool executor: routes tool calls
- Tool executor → Built-in tools: executes tools
- Built-in tools → Browser and MCP: uses browser tools (evidence: `src/mcp/client-manager.js`)
- Agent loop → Social connectors: routes replies
- Agent loop → Voice services: generates speech
- Local resource sensing → Context selection: provides host context
- SQLite persistence → Brain UI: shares chat state
- Local HTTP service → UI panels and cards: serves panel APIs
- Brain UI → Voice services: configures voice
- Electron shell → Brain UI: hosts desktop UI
