agentscope-ai /agentscope

Build and run agents you can see, understand and trust.

★ 36,046⑂ 3,861👁 161⑃ 2,266● 1,602▤ 51
PythonApache-2.0Created 2024-01-12docs.agentscope.io/
Download: v2.0.11v2.0.11 ↓2.0.112026-10-27
+48
Daily
+387
Weekly
36,046
stars
3,861
forks
161
watchers
2,266
prs
1,602
issues
51
releases

README

中文主页 | Documentation | Roadmap




    
        
    
    
        
    
    
        
    
    
        
    
    
        
    
    
        
    
    
        
    






 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.



 News

- [2026-10] FEAT: Voice profile management and voice cloning supported — select saved voices in chat, with DashScope and OpenAI voice cloning clients available in the Python SDK.
- [2026-10] FEAT Experimental: Agent service supports realtime voice conversations over WebRTC, with text and voice sharing the same session history.
- [2026-09] FEAT Experimental: SOP supported — run multi-step tasks as standard operating procedures, in both the framework and agent service. Docs | Service
- [2026-09] FEAT: TeamPipeline supported — a leader agent delegates tasks to member agents. Docs
- [2026-09] INTE: MiniMax chat models supported via MiniMaxChatModel (MiniMax-M3 by default).
- [2026-09] FEAT: Model routing supported — use ModelRouterMiddleware to select an appropriate chat model for each reply.
- [2026-09] INTE: Jev classifier model supported through the TypeSafe SDK via JevClassifierModel.
- [2026-09] FEAT: agentscope-skill now supports AgentScope v2.
- [2026-09] INTE: Support DashScope, OpenAI, Gemini and xAI realtime APIs in RealtimeAgent. Example | Docs
- [2026-09] FEAT Experimental: Realtime voice agent 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

bash
uv pip install agentscope


 From source

bash
 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, Volcen

Top issues

Discussions

Latest release

v2.0.11 v2.0.11 2026-10-27
What's Changed
 fix(model): declare real WAV sizes in the final streamed audio block by @BlueX888 in https://github.com/agentscope-ai/agentscope/pull/3242
 fix(embedding): isolate Ollama embedding caches by host by @maahumada in https://github.com/agentscope-ai/agentscope/pull/3265
 fix(model): await provider stream cleanup on public aclose by @HsbcJone in https://github.com/agentscope-ai/agentscope/pull/3216
 fix(workspace): offload nested media from context archives by @wuyak in https://github.com/agentscope-ai/agentscope/pull/3201
 feat(tui): add right arrow key to switch questions in 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON