Skip to main content

AgentScope: A Flexible yet Robust Multi-Agent Platform.

Project description

AgentScope Logo

中文主页 | Tutorial | Roadmap

arxiv pypi pypi discord docs license

agentscope-ai%2Fagentscope | Trendshift

What is AgentScope 2.0?

AgentScope 2.0 is a production-ready, easy-to-use agent framework with essential abstractions that work with rising model capability and built-in support for finetuning.

We design for increasingly agentic LLMs. Our approach leverages the models' reasoning and tool use abilities rather than constraining them with strict prompts and opinionated orchestrations.

Why use AgentScope?

  • Simple: start building your agents in 5 minutes with built-in ReAct agent, tools, skills, human-in-the-loop steering, memory, planning, realtime voice, evaluation and model finetuning
  • Extensible: large number of ecosystem integrations for tools, memory and observability; built-in support for MCP and A2A; message hub for flexible multi-agent orchestration and workflows
  • Production-ready: deploy and serve your agents locally, as serverless in the cloud, or on your K8s cluster with built-in OTel support
agentscope

News

  • [2026-05] RELS: AgentScope 2.0 released! Docs

More news →

Community

Welcome to join our community on

Discord DingTalk

📑 Table of Contents

Quickstart

Installation

AgentScope requires Python 3.11 or higher.

From PyPI

uv pip install agentscope
# or
# pip install agentscope

From source

# Pull the source code from GitHub
git clone -b main https://github.com/agentscope-ai/agentscope.git

# Install the package in editable mode
cd agentscope

uv pip install -e .
# or
# pip install -e .

Hello AgentScope!

Start your first agent in 5 minutes with AgentScope 2.0:

from agentscope.agent import Agent
from agentscope.tool import Toolkit, Bash, Grep, Glob, Read, Write, Edit
from agentscope.credential import DashScopeCredential
from agentscope.model import DashScopeChatModel
from agentscope.message import UserMsg
from agentscope.event import EventType

import os, asyncio


async def main() -> None:
    agent = Agent(
        name="Friday",
        system_prompt="You're a helpful assistant named Friday.",
        model=DashScopeChatModel(
            credential=DashScopeCredential(
              api_key=os.environ["DASHSCOPE_API_KEY"]
            ),
            model="qwen3.6-plus",
        ),
        toolkit=Toolkit(
            tools=[
                Bash(),
                Grep(),
                Glob(),
                Read(),
                Write(),
                Edit(),
            ]
        ),
    )

    async for evt in agent.reply_stream(UserMsg("Tony", "Hi, Friday!")):
        # Handle the event stream, e.g., print the message, update UI, etc.
        match evt.type:
            case EventType.REPLY_START:
                ...
            case EventType.MODEL_CALL_START:
                ...
            case EventType.TEXT_BLOCK_START:
                ...
            case EventType.TEXT_BLOCK_DELTA:
                ...
            case EventType.TEXT_BLOCK_END:
                ...

            # Handle other event types

asyncio.run(main())

Agent Service

An extensible FastAPI based multi-tenancy, multi-session agent service with pre-built Web UI in examples/web_ui

git clone https://github.com/agentscope-ai/agentscope

cd agentscope/examples/agent_service

# start the agent service backend
python main.py

Then open another terminal to start the web UI:

cd agentscope/examples/web_ui

# start the webui
pnpm install
pnpm dev

Experience a chat-style interface to interact with your agents.

Permission System

Contributing

We welcome contributions from the community! Please refer to our CONTRIBUTING.md for guidelines on how to contribute.

License

AgentScope is released under Apache License 2.0.

Publications

If you find our work helpful for your research or application, please cite our papers.

@article{agentscope_v1,
    author  = {Dawei Gao, Zitao Li, Yuexiang Xie, Weirui Kuang, Liuyi Yao, Bingchen Qian, Zhijian Ma, Yue Cui, Haohao Luo, Shen Li, Lu Yi, Yi Yu, Shiqi He, Zhiling Luo, Wenmeng Zhou, Zhicheng Zhang, Xuguang He, Ziqian Chen, Weikai Liao, Farruh Isakulovich Kushnazarov, Yaliang Li, Bolin Ding, Jingren Zhou}
    title   = {AgentScope 1.0: A Developer-Centric Framework for Building Agentic Applications},
    journal = {CoRR},
    volume  = {abs/2508.16279},
    year    = {2025},
}

@article{agentscope,
    author  = {Dawei Gao, Zitao Li, Xuchen Pan, Weirui Kuang, Zhijian Ma, Bingchen Qian, Fei Wei, Wenhao Zhang, Yuexiang Xie, Daoyuan Chen, Liuyi Yao, Hongyi Peng, Zeyu Zhang, Lin Zhu, Chen Cheng, Hongzhu Shi, Yaliang Li, Bolin Ding, Jingren Zhou}
    title   = {AgentScope: A Flexible yet Robust Multi-Agent Platform},
    journal = {CoRR},
    volume  = {abs/2402.14034},
    year    = {2024},
}

Contributors

All thanks to our contributors:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentscope-2.0.0.tar.gz (292.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentscope-2.0.0-py3-none-any.whl (403.0 kB view details)

Uploaded Python 3

File details

Details for the file agentscope-2.0.0.tar.gz.

File metadata

  • Download URL: agentscope-2.0.0.tar.gz
  • Upload date:
  • Size: 292.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentscope-2.0.0.tar.gz
Algorithm Hash digest
SHA256 333eae04d2384c05eab09df3575603fc7d9b09899599d0f175fef5c6b39fcf60
MD5 7c570fe37fe1d0b62b0d9709965ae9d0
BLAKE2b-256 1c2f5d2ace489b288a457163095a62bbafc822708e485517f4866d65ce3d561d

See more details on using hashes here.

File details

Details for the file agentscope-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: agentscope-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 403.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentscope-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 248cd91e61487ce45ed1fa1dc3057faa3b2e624410670cbfc202f9a6c6f279c4
MD5 d15df37aa42fe97fb40a375003d05a64
BLAKE2b-256 8b069465dac42f8401ae12244de3c92c681af08544dc1e57620b3474cc2f24ee

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page