https://github.com/dvampire/agentscope
https://github.com/dvampire/agentscope
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dvampire/agentscope
- Owner: DVampire
- License: mit
- Created: 2025-05-19T18:07:19.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-05-22T06:48:33.000Z (10 months ago)
- Last Synced: 2025-06-16T15:44:58.762Z (9 months ago)
- Language: Fluent
- Size: 4.96 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AgentScope
AgentScope: A Hierarchical Multi-Agent Framework for General-Purpose Task Solving
## Introduction
AgentScope is a hierarchical multi-agent system designed for general-purpose task solving. The framework leverages a top-level planning agent to coordinate multiple specialized lower-level agents, enabling automated decomposition and efficient execution of complex tasks. Our goal is to integrate mainstream agent systems into our framework, enabling the construction of a general-purpose and versatile multi-agent system. [DeepResearchAgent](https://github.com/SkyworkAI/DeepResearchAgent) is developed on top of this framework.
## Architecture
The system adopts a two-layer structure:
### 1. Top-Level Planning Agent
- Responsible for understanding, decomposing, and planning the overall workflow for a given task.
- Breaks down tasks into manageable sub-tasks and assigns them to appropriate lower-level agents.
- Dynamically coordinates the collaboration among agents to ensure smooth task completion.
### 2. Specialized Lower-Level Agents
- **Deep Analyzer**
- Performs in-depth analysis of input information, extracting key insights and potential requirements.
- Supports analysis of various data types, including text and structured data.
- **Deep Researcher**
- Conducts thorough research on specified topics or questions, retrieving and synthesizing high-quality information.
- Capable of generating research reports or knowledge summaries automatically.
- **Browser Use**
- Automates browser operations, supporting web search, information extraction, and data collection tasks.
- Assists the Deep Researcher in acquiring up-to-date information from the internet.
- **...**
## Features
- Hierarchical agent collaboration for complex and dynamic task scenarios
- Extensible agent system, allowing easy integration of additional specialized agents
- Automated information analysis, research, and web interaction capabilities
## TODO List
- [x] Asynchronous feature completed
- [ ] Image Generation Agent to be developed
- [ ] MCP in progress
- [ ] AI4Research Agent to be developed
- [ ] Novel Writing Agent to be developed
## Installation
### Prepare Environment
```
conda create -n agentscope python=3.11
conda activate agentscope
make install
```
### Put `.env` in the root
`.env` should be like
```
PYTHONWARNINGS=ignore # ignore warnings
ANONYMIZED_TELEMETRY=false # disable telemetry
HUGGINEFACE_API_KEY=abcabcabc # your huggingface api key
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY=abcabcabc # your openai api key
# (Optional) Local proxy. If you are using a private proxy, please refer to the configuration guide as follows:
LOCAL_PROXY_BASE=http://localhost:6655
SKYWORK_API_BASE=abcabcabs
SKYWORK_OPENROUTER_BJ_API_BASE=abcabcabs
SKYWORK_OPENROUTER_US_API_BASE=abcabcabs
SKYWORK_AZURE_HK_API_BASE=abcabcabs
SKYWORK_WHISPER_BJ_API_BASE=abcabcabs
SKYWORK_GOOGLE_API_BASE=abcabcabs
SKYWORK_API_KEY=abcabcabs
SKYWORK_GOOGLE_SEARCH_API=abcabcabs
```
## Usage
### Deep Researcher for "AI Agent" as an example
```
python examples/run_example.py
```
### GAIA as an example
```
# Download GAIA
mkdir data | cd data
git clone https://huggingface.co/datasets/gaia-benchmark/GAIA
# Run the script in the examples
python examples/run_gaia.py
```
## Experiments
We evaluated our agent on the GAIA validation set and achieved state-of-the-art performance on May 10th.
## Acknowledgement
AgentScope is primarily inspired by the architecture of smolagents. The following improvements have been made:
- The codebase of smolagents has been modularized for better structure and organization.
- The original synchronous framework has been refactored into an asynchronous one.
- The multi-agent setup process has been optimized to make it more user-friendly and efficient.
We would like to express our gratitude to the following open source projects, which have greatly contributed to the development of this work:
- [smolagents](https://github.com/huggingface/smolagents) - A lightweight agent framework.
- [OpenManus](https://github.com/mannaandpoem/OpenManus) - An asynchronous agent framework.
- [browser-use](https://github.com/browser-use/browser-use) - An AI-powered browser automation tool.
- [crawl4ai](https://github.com/unclecode/crawl4ai) - A web crawling library for AI applications.
- [markitdown](https://github.com/microsoft/markitdown) - A tool for converting files to Markdown format.
We sincerely appreciate the efforts of all contributors and maintainers of these projects for their commitment to advancing AI technologies and making them available to the wider community.
## Contribution
Contributions and suggestions are welcome! Feel free to open issues or submit pull requests to improve the project.
## Cite
```
@misc{AgentScope,
title = {`AgentScope`: A Hierarchical Multi-Agent Framework for General-Purpose Task Solving.},
author = {Wentao Zhang, Ce Cui, Yang Liu, Bo An},
howpublished = {\url{https://github.com/DVampire/AgentScope}},
year = {2025}
}
```