agentscope-ai /agentscope
Build and run agents you can see, understand and trust.
★ 36,046⑂ 3,861👁 161⑃ 2,266● 1,602▤ 51
More from this author
+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, VolcenTop issues
#2707[Bug]: streamed Base64 accumulation repeatedly transcodes the full payload20 comments · 2026-09-20#1120[human in loop]how to interrupt the agent flow and give a confirm/new information to the agent to continue the flow when coding by fastapi?18 comments · 2026-01-15#926[Feature]: human in loop wanted17 comments · 2025-11-12#3194[Bug]: Provider length-limit stop reasons are lost, so incomplete tool calls may run16 comments · 2026-10-09#2566feat(realtime): support context management for the realtime agent15 comments · 2026-09-09#2151[Bug]: context-compression LLM call's token usage is never recorded anywhere12 comments · 2026-07-22#1695如何为ReActAgent提供一套友好的web ui12 comments · 2026-05-26#2481feat(rag): support RAGFlow in a new `RAGFlowKnowledgeBase` class rather than VDB11 comments · 2026-09-01
Discussions
#4054Add a coding-agent evaluation example?0 comments · 2026-11-15#4045Chopper: a small open model that cuts only the needed sentences out of retrieved text0 comments · 2026-11-15#4019Task-scoped delegation and recoverable joins for App session teams0 comments · 2026-11-14#4012A public collaboration layer for agents: JIC Map / World + live chat1 comments · 2026-11-13#3984Support verified GoalPipeline subworkflows as TeamPipeline members1 comments · 2026-11-13#3979feat(workspace): add boxd as a sandboxed workspace backend0 comments · 2026-11-12#3917Expose FastAPI 0.162 telemetry settings in create_app1 comments · 2026-11-10#3832Proposal: add a DebatePipeline (independent answers -> cross-examination -> judge synthesis)0 comments · 2026-11-08
Latest release
v2.0.11 v2.0.11 2026-10-27What'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