# agentscope-ai/reme architecture

> Architecture diagram of the GitHub repository agentscope-ai/reme, 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/agentscope-ai/reme
- Repository: https://github.com/agentscope-ai/reme

## Overview

ReMe is a local-first, file-native knowledge base for AI agents: users and agents write Markdown memories, ReMe indexes them, then retrieves relevant passages and linked context. The central runtime configures components and exposes workflow jobs through HTTP/MCP or other interfaces. Separate workflows evolve conversations and resources into durable notes, and proactively consolidate knowledge. Studio provides a workspace for interacting with those files. The README documents these capabilities; sampled source confirms application wiring, component lookup, and HTTP job routing, but several domain-stage connections are documented rather than source-verified.

Main entry points: [`reme/components/service/http_service.py`](https://github.com/agentscope-ai/reme/blob/main/reme/components/service/http_service.py) (HTTP and MCP service), [`reme/components/file_store/local_file_store.py`](https://github.com/agentscope-ai/reme/blob/main/reme/components/file_store/local_file_store.py) (Markdown workspace), [`reme/application.py`](https://github.com/agentscope-ai/reme/blob/main/reme/application.py) (Application runtime), [`reme/steps/index/search.py`](https://github.com/agentscope-ai/reme/blob/main/reme/steps/index/search.py) (Hybrid memory search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and jobs"]
  node_application["Application runtime<br/>[application.py]"]
  node_registry["Component registry"]
  node_steps["Workflow steps<br/>[base_step.py]"]
  node_schemas["Requests and results<br/>[request.py]"]
end

subgraph group_memory["Memory lifecycle"]
  node_fileops["Markdown file operations<br/>[read.py]"]
  node_workspace[("Markdown workspace")]
  node_capture["Conversation capture<br/>[auto_memory.py]"]
  node_resources["Resource ingestion<br/>[auto_resource.py]"]
  node_daily["Daily notes<br/>[daily_write.py]"]
  node_dream["Knowledge consolidation<br/>[integrate.py]"]
  node_proactive["Proactive discovery<br/>[proactive.py]"]
end

subgraph group_recall["Index and recall"]
  node_index["Search indexing<br/>[reindex.py]"]
  node_search["Hybrid memory search<br/>[search.py]"]
  node_links["Wikilink expansion<br/>[link_expansion.py]"]
end

subgraph group_interfaces["User interfaces"]
  node_http["HTTP and MCP service<br/>[http_service.py]"]
  node_client["HTTP client<br/>[http_client.py]"]
  node_studio["Studio workspace<br/>[workspace.tsx]"]
end

subgraph group_ecosystem["Agent ecosystem"]
  node_integrations["Agent integrations"]
  node_plugins["Community plugins"]
end

node_user(("User or agent"))

node_user -->|"submits actions"| node_http
node_http -->|"routes jobs"| node_application
node_application -->|"resolves backends"| node_registry
node_application -.->|"initializes service"| node_http
node_http -->|"accepts requests"| node_schemas
node_client -.->|"sends actions"| node_http
node_application -.->|"runs configured jobs"| node_steps
node_user -->|"reads and writes"| node_fileops
node_fileops -->|"stores Markdown"| node_workspace
node_capture -.->|"creates notes"| node_daily
node_resources -->|"preserves sources"| node_workspace
node_daily -.->|"writes notes"| node_workspace
node_dream -->|"refines knowledge"| node_workspace
node_proactive -.->|"discovers knowledge"| node_workspace
node_workspace -->|"indexes files"| node_index
node_index -.->|"supports retrieval"| node_search
node_search -->|"expands context"| node_links
node_user -->|"queries memories"| node_search
node_user -.->|"uses workspace"| node_studio
node_integrations -.->|"shares workspace"| node_http
node_plugins -.->|"extends workflows"| node_steps

click node_application "https://github.com/agentscope-ai/reme/blob/main/reme/application.py"
click node_registry "https://github.com/agentscope-ai/reme/blob/main/reme/components/component_registry.py"
click node_steps "https://github.com/agentscope-ai/reme/blob/main/reme/steps/base_step.py"
click node_http "https://github.com/agentscope-ai/reme/blob/main/reme/components/service/http_service.py"
click node_client "https://github.com/agentscope-ai/reme/blob/main/reme/components/client/http_client.py"
click node_schemas "https://github.com/agentscope-ai/reme/blob/main/reme/schema/request.py"
click node_fileops "https://github.com/agentscope-ai/reme/blob/main/reme/steps/file_io/read.py"
click node_workspace "https://github.com/agentscope-ai/reme/blob/main/reme/components/file_store/local_file_store.py"
click node_capture "https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/auto_memory.py"
click node_resources "https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/auto_resource.py"
click node_daily "https://github.com/agentscope-ai/reme/blob/main/reme/steps/file_io/daily_write.py"
click node_dream "https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/dream/integrate.py"
click node_proactive "https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/proactive/proactive.py"
click node_index "https://github.com/agentscope-ai/reme/blob/main/reme/steps/index/reindex.py"
click node_search "https://github.com/agentscope-ai/reme/blob/main/reme/steps/index/search.py"
click node_links "https://github.com/agentscope-ai/reme/blob/main/reme/utils/link_expansion.py"
click node_studio "https://github.com/agentscope-ai/reme/blob/main/reme_studio/app/workspace.tsx"
click node_integrations "https://github.com/agentscope-ai/reme/tree/main/integrations"
click node_plugins "https://github.com/agentscope-ai/reme/tree/main/plugins"

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_application,node_registry,node_steps,node_schemas,node_user toneBlue
class node_fileops,node_workspace,node_capture,node_resources,node_daily,node_dream,node_proactive toneAmber
class node_index,node_search,node_links toneMint
class node_http,node_client,node_studio toneRose
class node_integrations,node_plugins toneIndigo
```

## Components

### Runtime and jobs

- [Application runtime](https://github.com/agentscope-ai/reme/blob/main/reme/application.py): `reme/application.py`
- [Component registry](https://github.com/agentscope-ai/reme/blob/main/reme/components/component_registry.py): `reme/components/component_registry.py`
- [Workflow steps](https://github.com/agentscope-ai/reme/blob/main/reme/steps/base_step.py): `reme/steps/base_step.py`
- [Requests and results](https://github.com/agentscope-ai/reme/blob/main/reme/schema/request.py): `reme/schema/request.py`

### Memory lifecycle

- [Markdown file operations](https://github.com/agentscope-ai/reme/blob/main/reme/steps/file_io/read.py): `reme/steps/file_io/read.py`
- [Markdown workspace](https://github.com/agentscope-ai/reme/blob/main/reme/components/file_store/local_file_store.py): `reme/components/file_store/local_file_store.py`
- [Conversation capture](https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/auto_memory.py): `reme/steps/evolve/auto_memory.py`
- [Resource ingestion](https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/auto_resource.py): `reme/steps/evolve/auto_resource.py`
- [Daily notes](https://github.com/agentscope-ai/reme/blob/main/reme/steps/file_io/daily_write.py): `reme/steps/file_io/daily_write.py`
- [Knowledge consolidation](https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/dream/integrate.py): `reme/steps/evolve/dream/integrate.py`
- [Proactive discovery](https://github.com/agentscope-ai/reme/blob/main/reme/steps/evolve/proactive/proactive.py): `reme/steps/evolve/proactive/proactive.py`

### Index and recall

- [Search indexing](https://github.com/agentscope-ai/reme/blob/main/reme/steps/index/reindex.py): `reme/steps/index/reindex.py`
- [Hybrid memory search](https://github.com/agentscope-ai/reme/blob/main/reme/steps/index/search.py): `reme/steps/index/search.py`
- [Wikilink expansion](https://github.com/agentscope-ai/reme/blob/main/reme/utils/link_expansion.py): `reme/utils/link_expansion.py`

### User interfaces

- [HTTP and MCP service](https://github.com/agentscope-ai/reme/blob/main/reme/components/service/http_service.py): `reme/components/service/http_service.py`
- [HTTP client](https://github.com/agentscope-ai/reme/blob/main/reme/components/client/http_client.py): `reme/components/client/http_client.py`
- [Studio workspace](https://github.com/agentscope-ai/reme/blob/main/reme_studio/app/workspace.tsx): `reme_studio/app/workspace.tsx`

### Agent ecosystem

- [Agent integrations](https://github.com/agentscope-ai/reme/tree/main/integrations): `integrations`
- [Community plugins](https://github.com/agentscope-ai/reme/tree/main/plugins): `plugins`

### Other components

- **User or agent**

## Connections

- User or agent → HTTP and MCP service: submits actions (evidence: `README.md`)
- HTTP and MCP service → Application runtime: routes jobs (evidence: `reme/components/service/http_service.py`)
- Application runtime → Component registry: resolves backends (evidence: `reme/application.py`)
- Application runtime → HTTP and MCP service: initializes service (evidence: `reme/components/service/http_service.py`)
- HTTP and MCP service → Requests and results: accepts requests (evidence: `reme/components/service/http_service.py`)
- HTTP client → HTTP and MCP service: sends actions
- Application runtime → Workflow steps: runs configured jobs
- User or agent → Markdown file operations: reads and writes (evidence: `README.md`)
- Markdown file operations → Markdown workspace: stores Markdown (evidence: `README.md`)
- Conversation capture → Daily notes: creates notes
- Resource ingestion → Markdown workspace: preserves sources (evidence: `README.md`)
- Daily notes → Markdown workspace: writes notes
- Knowledge consolidation → Markdown workspace: refines knowledge (evidence: `README.md`)
- Proactive discovery → Markdown workspace: discovers knowledge
- Markdown workspace → Search indexing: indexes files (evidence: `README.md`)
- Search indexing → Hybrid memory search: supports retrieval
- Hybrid memory search → Wikilink expansion: expands context (evidence: `README.md`)
- User or agent → Hybrid memory search: queries memories (evidence: `README.md`)
- User or agent → Studio workspace: uses workspace
- Agent integrations → HTTP and MCP service: shares workspace
- Community plugins → Workflow steps: extends workflows (evidence: `plugins/beam-judge/src/judge_beam/llm_judge.py`)
