# agentscope-ai/agentscope-samples architecture

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

- Interactive diagram: https://gitdiagram.com/agentscope-ai/agentscope-samples
- Repository: https://github.com/agentscope-ai/agentscope-samples

## Overview

This repository is a catalog of independent AgentScope examples, not one integrated application. Its principal user workflow is to choose a sample, run its entry point, and obtain a domain-specific result—such as a research response, browser action, data-processing pipeline, conversation, or trading decision. Some samples are command-line agents; others are full-stack applications with a UI and backend. The README identifies these capabilities, while the sampled source offers only limited evidence about internal wiring, so the graph keeps the examples separate rather than implying shared runtime flows.

Main entry points: [`data_juicer_agent/main.py`](https://github.com/agentscope-ai/agentscope-samples/blob/main/data_juicer_agent/main.py) (Data Juicer Agent), [`alias/src/alias/agent/run.py`](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/agent/run.py) (Alias Agent), [`alias/frontend/src/App.tsx`](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/frontend/src/App.tsx) (Alias Web UI), [`browser_use/agent_browser/main.py`](https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/agent_browser/main.py) (Browser Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_general["General Agent"]
  node_alias["Alias Agent<br/>[run.py]"]
  node_alias_ui["Alias Web UI<br/>[App.tsx]"]
  node_alias_server["Alias API Server<br/>[main.py]"]
  node_alias_sandbox["Alias Sandbox<br/>[alias_sandbox.py]"]
  node_alias_memory["Alias Memory Service<br/>[main.py]"]
end

subgraph group_research["Research And Browser"]
  node_browser_cli["Browser Agent<br/>[main.py]"]
  node_browser_pro["Advanced Browser Agent<br/>[main.py]"]
  node_browser_app["Browser Runtime App"]
  node_research_agent["Research Agent<br/>[main.py]"]
  node_research_app["Research Runtime App<br/>[main.py]"]
end

subgraph group_conversation["Conversational Apps"]
  node_chatbot["Chatbot Sample<br/>[main.py]"]
  node_chatbot_app["Chatbot Runtime App<br/>[web_server.py]"]
  node_multiagent_chat["Multi-Agent Dialogue<br/>[main.py]"]
  node_debate["Multi-Agent Debate<br/>[main.py]"]
end

subgraph group_data["Data And Evaluation"]
  node_data_agent["Data Juicer Agent<br/>[main.py]"]
  node_data_tools["Operator Retrieval Tools<br/>[op_retrieval.py]"]
  node_evaluation["ACE Bench<br/>[main.py]"]
end

subgraph group_other["Other Examples"]
  node_werewolves["Werewolves Game<br/>[main.py]"]
  node_trading["EvoTraders<br/>[main.py]"]
  node_trading_pipeline["Trading Pipeline<br/>[pipeline.py]"]
  node_trading_dashboard["Trading UI<br/>[App.jsx]"]
  node_tuning_data["Tuning Data Prep"]
end

node_user(("Sample User"))

node_user -->|"runs agent"| node_alias
node_user -->|"uses UI"| node_alias_ui
node_user -->|"runs browser"| node_browser_cli
node_user -->|"runs browser"| node_browser_pro
node_user -->|"uses app"| node_browser_app
node_user -->|"runs research"| node_research_agent
node_user -->|"uses app"| node_research_app
node_user -->|"runs chatbot"| node_chatbot
node_user -->|"uses app"| node_chatbot_app
node_user -->|"runs dialogue"| node_multiagent_chat
node_user -->|"runs debate"| node_debate
node_user -->|"runs processing"| node_data_agent
node_user -->|"runs benchmark"| node_evaluation
node_user -->|"plays game"| node_werewolves
node_user -->|"runs trading"| node_trading
node_user -->|"prepares data"| node_tuning_data
node_data_agent -->|"retrieves operators"| node_data_tools

click node_alias "https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/agent/run.py"
click node_alias_ui "https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/frontend/src/App.tsx"
click node_alias_server "https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/server/main.py"
click node_alias_sandbox "https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/runtime/alias_sandbox/alias_sandbox.py"
click node_alias_memory "https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/memory_service/main.py"
click node_browser_cli "https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/agent_browser/main.py"
click node_browser_pro "https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/browser_use_agent_pro/main.py"
click node_browser_app "https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/browser_use_fullstack_runtime/backend/async_quart_service.py"
click node_research_agent "https://github.com/agentscope-ai/agentscope-samples/blob/main/deep_research/agent_deep_research/main.py"
click node_research_app "https://github.com/agentscope-ai/agentscope-samples/blob/main/deep_research/qwen_langgraph_search_fullstack_runtime/src/main.py"
click node_chatbot "https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/chatbot/main.py"
click node_chatbot_app "https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/chatbot_fullstack_runtime/backend/web_server.py"
click node_multiagent_chat "https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/multiagent_conversation/main.py"
click node_debate "https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/multiagent_debate/main.py"
click node_data_agent "https://github.com/agentscope-ai/agentscope-samples/blob/main/data_juicer_agent/main.py"
click node_data_tools "https://github.com/agentscope-ai/agentscope-samples/blob/main/data_juicer_agent/tools/op_manager/op_retrieval.py"
click node_evaluation "https://github.com/agentscope-ai/agentscope-samples/blob/main/evaluation/ace_bench/main.py"
click node_werewolves "https://github.com/agentscope-ai/agentscope-samples/blob/main/games/game_werewolves/main.py"
click node_trading "https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/backend/main.py"
click node_trading_pipeline "https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/backend/core/pipeline.py"
click node_trading_dashboard "https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/frontend/src/App.jsx"
click node_tuning_data "https://github.com/agentscope-ai/agentscope-samples/blob/main/tuner/learn_to_ask/data_prepare/1_info_extract_pipeline.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_alias,node_alias_ui,node_alias_server,node_alias_sandbox,node_alias_memory,node_user toneBlue
class node_browser_cli,node_browser_pro,node_browser_app,node_research_agent,node_research_app toneAmber
class node_chatbot,node_chatbot_app,node_multiagent_chat,node_debate toneMint
class node_data_agent,node_data_tools,node_evaluation toneRose
class node_werewolves,node_trading,node_trading_pipeline,node_trading_dashboard,node_tuning_data toneIndigo
```

## Components

### General Agent

- [Alias Agent](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/agent/run.py): `alias/src/alias/agent/run.py`
- [Alias Web UI](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/frontend/src/App.tsx): `alias/frontend/src/App.tsx`
- [Alias API Server](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/server/main.py): `alias/src/alias/server/main.py`
- [Alias Sandbox](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/runtime/alias_sandbox/alias_sandbox.py): `alias/src/alias/runtime/alias_sandbox/alias_sandbox.py`
- [Alias Memory Service](https://github.com/agentscope-ai/agentscope-samples/blob/main/alias/src/alias/memory_service/main.py): `alias/src/alias/memory_service/main.py`

### Research And Browser

- [Browser Agent](https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/agent_browser/main.py): `browser_use/agent_browser/main.py`
- [Advanced Browser Agent](https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/browser_use_agent_pro/main.py): `browser_use/browser_use_agent_pro/main.py`
- [Browser Runtime App](https://github.com/agentscope-ai/agentscope-samples/blob/main/browser_use/browser_use_fullstack_runtime/backend/async_quart_service.py): `browser_use/browser_use_fullstack_runtime/backend/async_quart_service.py`
- [Research Agent](https://github.com/agentscope-ai/agentscope-samples/blob/main/deep_research/agent_deep_research/main.py): `deep_research/agent_deep_research/main.py`
- [Research Runtime App](https://github.com/agentscope-ai/agentscope-samples/blob/main/deep_research/qwen_langgraph_search_fullstack_runtime/src/main.py): `deep_research/qwen_langgraph_search_fullstack_runtime/src/main.py`

### Conversational Apps

- [Chatbot Sample](https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/chatbot/main.py): `conversational_agents/chatbot/main.py`
- [Chatbot Runtime App](https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/chatbot_fullstack_runtime/backend/web_server.py): `conversational_agents/chatbot_fullstack_runtime/backend/web_server.py`
- [Multi-Agent Dialogue](https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/multiagent_conversation/main.py): `conversational_agents/multiagent_conversation/main.py`
- [Multi-Agent Debate](https://github.com/agentscope-ai/agentscope-samples/blob/main/conversational_agents/multiagent_debate/main.py): `conversational_agents/multiagent_debate/main.py`

### Data And Evaluation

- [Data Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/blob/main/data_juicer_agent/main.py): `data_juicer_agent/main.py`
- [Operator Retrieval Tools](https://github.com/agentscope-ai/agentscope-samples/blob/main/data_juicer_agent/tools/op_manager/op_retrieval.py): `data_juicer_agent/tools/op_manager/op_retrieval.py`
- [ACE Bench](https://github.com/agentscope-ai/agentscope-samples/blob/main/evaluation/ace_bench/main.py): `evaluation/ace_bench/main.py`

### Other Examples

- [Werewolves Game](https://github.com/agentscope-ai/agentscope-samples/blob/main/games/game_werewolves/main.py): `games/game_werewolves/main.py`
- [EvoTraders](https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/backend/main.py): `evotraders/backend/main.py`
- [Trading Pipeline](https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/backend/core/pipeline.py): `evotraders/backend/core/pipeline.py`
- [Trading UI](https://github.com/agentscope-ai/agentscope-samples/blob/main/evotraders/frontend/src/App.jsx): `evotraders/frontend/src/App.jsx`
- [Tuning Data Prep](https://github.com/agentscope-ai/agentscope-samples/blob/main/tuner/learn_to_ask/data_prepare/1_info_extract_pipeline.py): `tuner/learn_to_ask/data_prepare/1_info_extract_pipeline.py`

### Other components

- **Sample User**

## Connections

- Sample User → Alias Agent: runs agent
- Sample User → Alias Web UI: uses UI
- Sample User → Browser Agent: runs browser
- Sample User → Advanced Browser Agent: runs browser
- Sample User → Browser Runtime App: uses app
- Sample User → Research Agent: runs research
- Sample User → Research Runtime App: uses app
- Sample User → Chatbot Sample: runs chatbot
- Sample User → Chatbot Runtime App: uses app
- Sample User → Multi-Agent Dialogue: runs dialogue
- Sample User → Multi-Agent Debate: runs debate
- Sample User → Data Juicer Agent: runs processing
- Sample User → ACE Bench: runs benchmark
- Sample User → Werewolves Game: plays game
- Sample User → EvoTraders: runs trading
- Sample User → Tuning Data Prep: prepares data
- Data Juicer Agent → Operator Retrieval Tools: retrieves operators