🎉 AG2 v1.0.0b0 - The First Beta of v1.0
We've reached a major milestone and are one step closer to v1.0: v1.0.0b0 is the first beta of AG2 v1.0. The new framework we've been building as an agentic platform for production use. The classic framework (autogen.x / ConversableAgent) has now been removed from this repository.
A big thanks to everyone who has been involved with building this new framework.
AG2 Classic Has Moved (autogen / ConversableAgent)
The AG2 Classic framework — everything you know as ConversableAgent, GroupChat, initiate_chat, and the surrounding tooling — now lives at its own repository: ag2ai/ag2-classic. It continues to be maintained in maintenance mode (security and critical bug fixes).
What to Install
| Install command | What you get | Repo |
|---|---|---|
pip install ag2 |
The new AG2 — actively developed (this release: v1.0.0b0) | ag2ai/ag2 |
pip install autogen |
AG2 Classic (ConversableAgent, GroupChat, …) — maintenance mode |
ag2ai/ag2-classic |
If you build with ConversableAgent and want to stay on AG2 Classic, use pip install autogen. The import path stays import autogen — nothing changes for your existing code.
If you're moving to the new AG2, the top-level package is now imported as ag2 (the autogen import name is no longer available in this repo). Install with pip install ag2 and import with import ag2.
Beta Promoted to Mainline
This is the foundational change of the v1.0 series:
autogen.betapromoted to the top level ag2.x – The framework built up underautogen.betaacross v0.12 → v0.14 is now the mainline framework in this repo.- Classic framework removed – The classic agents, orchestration surfaces, and interoperability layers that were deprecated in v0.12.0 and removed from this repo in v0.14.0 are now fully absent. Classic users should migrate to ag2ai/ag2-classic.
- Classic CLI removed – The classic command-line entry point is gone with the classic framework.
🌐 New Features
🔗 NLIP Integration
- NLIP support – First-class integration for the Natural Language Interaction Protocol.
💻 ACP — Drive CLI Coding Agents
- ACP support – First-class support for driving external CLI coding agents (Claude Code, Codex, OpenCode, Gemini CLI, and others) as Agents over Agent Client Protocol (ACP)!
🔍 Server-Side Tool Search + Deferred Loading
- Server-side tool search – New tool discovery mechanism with deferred tool loading, so agents can find and load tools on demand rather than upfront.
📁 Z.AI Files API
- Z.AI Files API – File API support added to the Z.AI (GLM) provider.
🔧 Fixes & Improvements
- 🧪 UsageEvent excluded from history compaction –
UsageEventtelemetry is now excluded from history compaction via the__conversational__marker. - 📏 History sizing – History is now sized correctly for effective compaction with the agent harness.
- 🔴 Redis listener cancellation – Redis listener cancellation is now propagated correctly.
- 🔢
__version__at top level –__version__is now exported at the top level of the package. - 📦 NLIP dependency – Require
nlip-server >= 0.1.3to drop the transitivefastapi < 0.116pin. - 📦 Extras resolution – Align
protobufandtyperpins souvresolves all extras.
🏗️ CI & Maintenance
- Documentation builds only on manual dispatch or published release.
- One combined coverage report per run instead of per matrix job.
- Dependency bumps:
uvgroup (23 updates),github-actionsgroup (2 + Anthropic Claude Code Action).
What's Changed
- fix(nlip): require nlip-server>=0.1.3 to drop the fastapi<0.116 transitive pin by @genisis0x in #2980
- fix(deps): align protobuf and typer pins so uv resolves all extras by @vvlrff in #3020
- feat(beta): add ZAI Files API support by @vvlrff in #3019
- feat!: promote autogen.beta to autogen, remove classic framework by @Lancetnik in #3023
- fix(beta): exclude UsageEvent telemetry from history compaction via conversational marker by @marklysze in #3033
- fix(beta): correctly size history from event content by @marklysze in #3035
- chore(deps): bump the uv group across 1 directory with 23 updates by @dependabot[bot] in #3034
- chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in #3027
- ci: build docs only on manual dispatch or published release by @Lancetnik in #3036
- ci: upload one combined coverage report per run instead of per matrix job by @Lancetnik in #3037
- feat: add NLIP integration for beta by @ash-jyc in #3024
- fix: propagate redis listener cancellation (+ de-flake test, retry cleanup) by @vvlrff in #3018
- chore: remove classic CLI by @marklysze in #3041
- feat: add ACP support for driving CLI coding agents by @vvlrff in #3026
- fix: export version at ag2 top level by @marklysze in #3040
- fix(test): de-flake test_cancelling_result_cancels_turn_inline by @marklysze in #3042
- feat(tools): add server-side tool search with deferred tool loading by @vvlrff in #3032
- Version bump to 1.0.0b0 by @marklysze in #3043
New Contributors
Full Changelog: v0.14.0...v1.0.0b0