Skip to main content

AgentScope Logo

中文主页 | Documentation | Roadmap

arxiv pypi pypi discord docs license Ask DeepWiki

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 keep up with rising model capability.

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.

agentscope

News

  • [2026-08] INTE: Feishu (Lark) and Discord channels supported. Feishu | Discord
  • [2026-08] FEAT: Channels supported — connect agents to IM platforms in agent service. Example | Docs
  • [2026-08] INTE: GitHub MCP Registry and ClawHub supported as built-in hubs. Example | Docs
  • [2026-08] FEAT: MCP & Skill Hub supported — browse a hub, install into your library, add to a workspace. Example | Docs
  • [2026-07] INTE: Daytona-based workspace/sandbox supported. Docs
  • [2026-07] INTE: K8s, OpenSandbox-based workspace/sandbox supported. Docs
  • [2026-07] INTE: ReMe long-term memory supported. Example | Docs
  • [2026-06] FEAT: Agentic Memory supported. Example | Docs
  • [2026-06] FEAT: Distributed & Multi-Tenancy & Multi-Session RAG service supported. Docs
  • [2026-06] FEAT: RAG supported. Example | Docs

More news →

Community

Welcome to join our community on

Discord DingTalk

Quickstart

Installation

AgentScope requires Python 3.11 or higher.

From PyPI

uv 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 .

Agent

The SDK layer — compose an agent from a rich set of building blocks:

Building block What's inside
ReAct Reasoning-acting loop with structured output, realtime interruption & resume, and batched (sequential / concurrent) tool acting
Toolkit Agentic tool management over Python tools, MCP servers, and skills; ships with built-in coding tools (shell, file edit, search) and task/plan tools
Model LLM, embedding, and TTS across major providers (OpenAI, Anthropic, Gemini, DashScope, DeepSeek, Moonshot, xAI, Ollama)
Context Automatic compaction, tool-result offload, and context injection (system prompt, RAG, memory) via built-in middleware
Event System Unified event bus streaming reasoning, tool calls, and multimodal content (text, image, audio) to the frontend
Permission & HITL Fine-grained control over tools and resources, confirmation, bypass mode
Middleware Composable hooks across the loop — reply, reasoning, acting, model calling, permission checking, context compression, system prompt
Memory Agentic memory with switchable backends (ReMe, Mem0)
Workspace / Sandbox Isolated tool & code execution — local, Docker, Apple Container, Bubblewrap, E2B, OpenSandbox, Daytona, K8s

Start your first agent 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 — All You Need to Build Your App

AgentScope ships a batteries-included agent service — a FastAPI backend with a pre-built Web UI (examples/web_ui) that turns your agents into a multi-tenant, multi-session application, with rich capabilities out of the box:

Capability What you get
Serving Multi-tenancy, multi-session isolation, FastAPI backend, pre-built Web UI
Agent Team Leader–worker orchestration, built-in team tools, task planning
Channels Connect agents to IM platforms — Feishu (Lark), Discord, custom channels, message routing
RAG Service Blob storage, index worker, multi-tenant retrieval
MCP & Skill Hub Browse hubs (GitHub MCP Registry, ClawHub), install into your library, add to a workspace
Resource Sharing Group- and org-level management for sharing models, MCP servers, skills, and workspaces
Persistence SQL & NoSQL persistence of agent state and sessions
Scheduling Scheduled tasks, agent wakeup, background task offloading

Everything above is composable, so you can assemble your own application on top of the service with minimal glue code.

Agent team
Agent team — a leader agent spawns workers and coordinates them through the built-in team tools.
Task planning
Task planning — the agent breaks complex work into a tracked plan and updates it as it goes.
Permission control in bypass mode
Permission control in bypass mode — the agent runs end-to-end without pausing for tool-call confirmations.
Background task offloading
Background task offloading — a long-running tool moves to the background; its result later wakes the agent up and the conversation resumes.

Run the following commands to start the agent service backend and the web UI:

git clone -b main https://github.com/agentscope-ai/agentscope.git
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

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:

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.6.tar.gz (794.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.6-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentscope-2.0.6.tar.gz
  • Upload date:
  • Size: 794.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentscope-2.0.6.tar.gz
Algorithm Hash digest
SHA256 5fcf2be7b56dabc2ebb616c8999f8ba299355ba4cbae9ac0d4f777ad04e7e3f6
MD5 ecafc41a8e4f6f754feb4f21371883ab
BLAKE2b-256 428190446a6fa1031b5b54e79f8abb172629897b511320723d4e6f63abb6ffa8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentscope-2.0.6-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentscope-2.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 091e7f214eff7fd6f4934d98a7d7c4bb8707a5d4b33d335def7fc31255e7ccb8
MD5 15cb9e8367c8dc6ce02cb75c02612422
BLAKE2b-256 96f9354cdf98e3f6e5835b2eb0214e6c6a5b0e402dfbade92769d280b683fd44

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