Download Latest Version v1.0.1 source code.zip (2.9 MB)
Email in envelope

Get an email when there's a new version of AG2

Home / v1.0.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-07-27 13.7 kB
0
v1.0.0 source code.tar.gz 2026-07-27 2.2 MB
0
v1.0.0 source code.zip 2026-07-27 2.9 MB
0
Totals: 3 Items   5.1 MB 0

AG2 v1.0.0

AG2 v1 is here! The protocol-driven framework we started building as autogen.beta in v0.12 is now the mainline framework, and the classic framework has moved to its own repository.

This release covers everything from v0.14.0, including the work released in v1.0.0b0.

Installing, importing, and start coding

Install What you get Repository
pip install ag2 AG2 v1.0 — actively developed ag2ai/ag2
pip install autogen AG2 Classic — maintenance mode ag2ai/ag2-classic

The top-level package is now imported as ag2. The autogen import name is no longer shipped by this repository.

:::python
import ag2

Get the AG2 skills for your coding assistant at ag2ai/ag2-skills — install with npx skills add ag2ai/ag2-skills.

Migrating

If you are on AG2 Classic

If your code contains import autogen, ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, register_function, or the nested and sequential chat patterns, you are on Classic.

Classic now lives at ag2ai/ag2-classic, with its own documentation at classic.docs.ag2.ai. It remains maintained and installable, and it receives security and critical bug fixes.

v1.0 is not a drop-in upgrade. The agent model, orchestration, and imports are different. Install autogen or pin the classic distribution rather than tracking ag2>=1.0, and your existing code keeps working unchanged.

If you are on the beta

The autogen.beta namespace is gone. Everything under it is now at the top level:

:::python
# Before
from autogen.beta import Agent
from autogen.beta.config import OpenAIConfig

# Now
from ag2 import Agent
from ag2.config import OpenAIConfig

The classic CLI has also been removed, and __version__ is now exported at the top level of the package.

AG2 Assistant

We built an open-source AI Assistant, powered by the AG2 framework. Let the AG2 framework work alongside you, carrying out the tasks you do on a daily basis, in a secure, permission-first, environment. Want it to do more? It's open-source, just like the AG2 framework.

ag2ai/ag2-assistant — v1.0 engine, chat, scheduled tasks, working folders, generative UI, and voice. Includes an inspector panel showing the live AG2 event stream.

New in this release

Protocols

  • NLIP — Integration for the Natural Language Interaction Protocol.
  • ACP — Support for the Agent Client Protocol, for driving CLI coding agents, together with an MCP tool gateway that exposes AG2 tools to those agents. The authentication and billing model for CLI agents is documented.
  • MCP-UI — Support for the MCP UI extension.

Tools

  • Server-side tool search with deferred loading — Agents can discover and load tools on demand rather than holding the full surface in context up front.
  • OpenAI Responses — FileSearchTool and SkillsTool support.
  • Anthropic — New code_execution version, and support for the current web_fetch and web_search tool versions.
  • Gemini — FileSearchTool store search and GoogleMapsTool grounding.
  • Xquik — New tweet search toolkit.
  • Perplexity — Sends an X-Pplx-Integration attribution header.

Providers

  • Z.AI — Files API support.
  • OpenAI — Encrypted reasoning content is now requested when store is false, so reasoning survives without server-side retention.

Observability

  • Prometheus support — Export metrics to a Prometheus scrape endpoint.
  • Network tracing — Tracing across the multi-agent network.

Fixes

Reliability

  • Failures are no longer swallowed. Several paths silently discarded errors, which could result in silent data loss. They now surface. If you have error handling built around the previous behaviour, review it.
  • Redis listener cancellation is propagated correctly.
  • SqliteKnowledgeStore read paths are serialized with the connection lock.

Knowledge and history

  • UsageEvent telemetry is excluded from history compaction via the __conversational__ marker.
  • History is sized correctly from event content.

Network and subagents

  • Namespaced delegate targets resolve correctly, and unknown targets are enumerated rather than failing opaquely.
  • as_tool(stream=...) accepts a Stream instance and rejects invalid types loudly rather than silently.

Events

  • Enum types are preserved across a serialization round-trip.

Dependencies

  • nlip-server >= 0.1.3 required, dropping the transitive fastapi < 0.116 pin.
  • protobuf and typer pins aligned so uv resolves all extras.
  • Unused dev, test, and types dependencies removed.

Documentation and project

  • Documentation migrated to the 1.0.0 URL scheme, with broken links repaired, homepage 404s fixed, and navigation restructured.
  • The Blog tab is restored, carrying the Network and Agent Harness series.
  • README updated for AG2 focus, with AG2 Classic references throughout.
  • A triage policy, restructured repository labels, area-based CODEOWNERS, canned replies, and an AI task runbook have been added for contributors.

Thank you ❤️

v1.0 exists because of the people who contributed code, opened issues, tested the betas, and pushed back on design decisions along the way. Feedback during the beta changed what shipped, more than once. Thank you.

What's Changed

New Contributors

Full Changelog: https://github.com/ag2ai/ag2/compare/v0.14.0...v1.0.0

Source: README.md, updated 2026-07-27