# upsonic/gpt-computer-assistant architecture

> Architecture diagram of the GitHub repository upsonic/gpt-computer-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/upsonic/gpt-computer-assistant
- Repository: https://github.com/upsonic/gpt-computer-assistant

## Overview

Upsonic is a Python framework for building autonomous and traditional AI agents. The primary workflow is a developer-created task submitted to an agent, which uses a selected language model and can invoke tools to produce a result. The repository also documents a separate layered OCR workflow and includes substantial subsystems for agent orchestration, model/provider support, tools, knowledge and memory, and integrations. Arrows are limited to relationships stated in the README or visible in the SOURCE INDEX; many implementation details were not sampled.

Main entry points: [`src/upsonic/agent/agent.py`](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/agent.py) (Traditional agent), [`src/upsonic/tasks/tasks.py`](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tasks/tasks.py) (Task), [`src/upsonic/models/__init__.py`](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/__init__.py) (Model interface), [`src/upsonic/ocr/ocr.py`](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/ocr/ocr.py) (OCR interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Agent runtime"]
  node_task["Task<br/>[tasks.py]"]
  node_agent["Traditional agent<br/>[agent.py]"]
  node_autonomous["Autonomous agent"]
  node_pipeline["Execution pipeline<br/>[manager.py]"]
  node_runoutput["Run results<br/>[output.py]"]
  node_team["Agent teams<br/>[team.py]"]
end

subgraph group_models["Models and tools"]
  node_model["Model interface<br/>[__init__.py]"]
  node_openai["OpenAI model<br/>[openai.py]"]
  node_settings["Model settings<br/>[settings.py]"]
  node_tools["Tool execution<br/>[builtin_tools.py]"]
  node_mcp["MCP tools<br/>[mcp.py]"]
end

subgraph group_knowledge["Knowledge and state"]
  node_kb["Knowledge base<br/>[knowledge_base.py]"]
  node_loaders["Document loaders<br/>[json.py]"]
  node_memory["Agent memory<br/>[memory.py]"]
  node_storage[("Storage interface<br/>[base.py]")]
end

subgraph group_extensions["Extensions"]
  node_ocr["OCR interface<br/>[ocr.py]"]
  node_ocrprep["Document preparation"]
  node_ocrengines["OCR engines"]
  node_interfaces["Messaging interfaces<br/>[manager.py]"]
  node_graph["Graph workflows<br/>[graph.py]"]
  node_usage["Usage tracking<br/>[usage.py]"]
end

node_developer(("Developer"))

node_developer -->|"creates agent"| node_agent
node_developer -->|"defines task"| node_task
node_developer -->|"creates agent"| node_autonomous
node_agent -->|"runs task"| node_task
node_autonomous -->|"runs task"| node_task
node_agent -->|"uses model"| node_model
node_agent -->|"executes through"| node_pipeline
node_pipeline -->|"produces results"| node_runoutput
node_agent -->|"executes tools"| node_tools
node_task -->|"defines tools"| node_tools
node_model -->|"supports provider"| node_openai
node_model -->|"uses settings"| node_settings
node_tools -.->|"extends with MCP"| node_mcp
node_task -->|"can use knowledge"| node_kb
node_kb -.->|"loads documents"| node_loaders
node_agent -->|"uses memory"| node_memory
node_memory -.->|"persists through"| node_storage
node_developer -->|"requests text extraction"| node_ocr
node_ocr -->|"prepares documents"| node_ocrprep
node_ocr -->|"runs engine"| node_ocrengines
node_developer -.->|"connects interfaces"| node_interfaces
node_developer -.->|"builds workflows"| node_graph
node_agent -.->|"coordinates agents"| node_team
node_agent -->|"records usage"| node_usage

click node_task "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tasks/tasks.py"
click node_agent "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/agent.py"
click node_autonomous "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/autonomous_agent/autonomous_agent.py"
click node_pipeline "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/pipeline/manager.py"
click node_runoutput "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/run/agent/output.py"
click node_team "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/team/team.py"
click node_model "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/__init__.py"
click node_openai "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/openai.py"
click node_settings "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/settings.py"
click node_tools "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tools/builtin_tools.py"
click node_mcp "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tools/mcp.py"
click node_kb "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/knowledge_base/knowledge_base.py"
click node_loaders "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/loaders/json.py"
click node_memory "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/memory/memory.py"
click node_storage "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/storage/base.py"
click node_ocr "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/ocr/ocr.py"
click node_ocrprep "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/ocr/layer_0/document_converter.py"
click node_ocrengines "https://github.com/upsonic/gpt-computer-assistant/tree/master/src/upsonic/ocr/layer_1/engines"
click node_interfaces "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/interfaces/manager.py"
click node_graph "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/graph/graph.py"
click node_usage "https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/usage.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_task,node_agent,node_autonomous,node_pipeline,node_runoutput,node_team toneBlue
class node_model,node_openai,node_settings,node_tools,node_mcp toneAmber
class node_kb,node_loaders,node_memory,node_storage toneMint
class node_ocr,node_ocrprep,node_ocrengines,node_interfaces,node_graph,node_usage toneRose
class node_developer toneIndigo
```

## Components

### Agent runtime

- [Task](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tasks/tasks.py): `src/upsonic/tasks/tasks.py`
- [Traditional agent](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/agent.py): `src/upsonic/agent/agent.py`
- [Autonomous agent](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/autonomous_agent/autonomous_agent.py): `src/upsonic/agent/autonomous_agent/autonomous_agent.py`
- [Execution pipeline](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/agent/pipeline/manager.py): `src/upsonic/agent/pipeline/manager.py`
- [Run results](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/run/agent/output.py): `src/upsonic/run/agent/output.py`
- [Agent teams](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/team/team.py): `src/upsonic/team/team.py`

### Models and tools

- [Model interface](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/__init__.py): `src/upsonic/models/__init__.py`
- [OpenAI model](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/openai.py): `src/upsonic/models/openai.py`
- [Model settings](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/models/settings.py): `src/upsonic/models/settings.py`
- [Tool execution](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tools/builtin_tools.py): `src/upsonic/tools/builtin_tools.py`
- [MCP tools](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/tools/mcp.py): `src/upsonic/tools/mcp.py`

### Knowledge and state

- [Knowledge base](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/knowledge_base/knowledge_base.py): `src/upsonic/knowledge_base/knowledge_base.py`
- [Document loaders](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/loaders/json.py): `src/upsonic/loaders/json.py`
- [Agent memory](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/memory/memory.py): `src/upsonic/memory/memory.py`
- [Storage interface](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/storage/base.py): `src/upsonic/storage/base.py`

### Extensions

- [OCR interface](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/ocr/ocr.py): `src/upsonic/ocr/ocr.py`
- [Document preparation](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/ocr/layer_0/document_converter.py): `src/upsonic/ocr/layer_0/document_converter.py`
- [OCR engines](https://github.com/upsonic/gpt-computer-assistant/tree/master/src/upsonic/ocr/layer_1/engines): `src/upsonic/ocr/layer_1/engines`
- [Messaging interfaces](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/interfaces/manager.py): `src/upsonic/interfaces/manager.py`
- [Graph workflows](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/graph/graph.py): `src/upsonic/graph/graph.py`
- [Usage tracking](https://github.com/upsonic/gpt-computer-assistant/blob/master/src/upsonic/usage.py): `src/upsonic/usage.py`

### Other components

- **Developer**

## Connections

- Developer → Traditional agent: creates agent (evidence: `README.md`)
- Developer → Task: defines task (evidence: `README.md`)
- Developer → Autonomous agent: creates agent (evidence: `README.md`)
- Traditional agent → Task: runs task (evidence: `README.md`)
- Autonomous agent → Task: runs task (evidence: `README.md`)
- Traditional agent → Model interface: uses model (evidence: `src/upsonic/agent/agent.py`)
- Traditional agent → Execution pipeline: executes through (evidence: `src/upsonic/agent/agent.py`)
- Execution pipeline → Run results: produces results (evidence: `src/upsonic/agent/pipeline/manager.py`)
- Traditional agent → Tool execution: executes tools (evidence: `src/upsonic/agent/agent.py`)
- Task → Tool execution: defines tools (evidence: `src/upsonic/tasks/tasks.py`)
- Model interface → OpenAI model: supports provider (evidence: `src/upsonic/models/openai.py`)
- Model interface → Model settings: uses settings (evidence: `src/upsonic/models/__init__.py`)
- Tool execution → MCP tools: extends with MCP
- Task → Knowledge base: can use knowledge (evidence: `src/upsonic/tasks/tasks.py`)
- Knowledge base → Document loaders: loads documents (evidence: `src/upsonic/knowledge_base/knowledge_base.py`)
- Traditional agent → Agent memory: uses memory (evidence: `src/upsonic/agent/agent.py`)
- Agent memory → Storage interface: persists through
- Developer → OCR interface: requests text extraction (evidence: `README.md`)
- OCR interface → Document preparation: prepares documents (evidence: `README.md`)
- OCR interface → OCR engines: runs engine (evidence: `README.md`)
- Developer → Messaging interfaces: connects interfaces
- Developer → Graph workflows: builds workflows
- Traditional agent → Agent teams: coordinates agents
- Traditional agent → Usage tracking: records usage (evidence: `src/upsonic/agent/agent.py`)
