---
title: Release Roadmap
sidebarTitle: Release Roadmap
---

# Release Roadmap — The Path to AG2 v1.0

AG2 is, finally, moving to v1.0.

This page outlines what to expect in each upcoming release so you can plan ahead.

The current framework (`autogen.agentchat` with ConversableAgent, GroupChat, LLMConfig, etc.) will, over the next few minor versions, receive a tidy-up through deprecations, and be prepared for maintenance-mode. It will continue to be supported and patched.

The beta framework (temporarily `autogen.beta`, with Agent) will, at v1.0, become the official version of AG2. Documentation will be provided to help with migration from the original version to the new framework.

## **v0.12 — Deprecation notices** <-- We are here

- **Deprecation announcements.** The following features are marked as deprecated and will be removed in v0.14. This list will be actively updated throughout the feedback period.
- **Community feedback window opens.** We want to hear from you. If a feature marked for deprecation is critical to your workflow, let us know before v0.14.
- Beta development continues in parallel.

### Deprecated agents

| Agent | Alternative |
|-------|-------------|
| `GPTAssistantAgent` | `ConversableAgent` |
| `LLaVAAgent` | v1.0 will contain native multimodal support on Agent |
| `WebSurferAgent` (contrib) | `autogen.agents.experimental.WebSurferAgent` |
| `TextAnalyzerAgent` | `ConversableAgent` with an appropriate system message |
| `MathUserProxyAgent` | `ConversableAgent` with tool calling |
| `SocietyOfMindAgent` | GroupChat patterns |
| `AgentOptimizer` | `ConversableAgent` with tool calling |
| `RetrieveAssistantAgent` | `AssistantAgent` |
| `QdrantRetrieveUserProxyAgent` | `RetrieveUserProxyAgent` with `vector_db='qdrant'` |
| `SwarmAgent` | `ConversableAgent` (already incorporated) |
| `RealtimeAgent` | Relies on deprecated realtime API endpoints |

### Deprecated swarm functions and aliases

| Feature | Alternative |
|---------|-------------|
| `initiate_swarm_chat()` | `run_group_chat` |
| `run_swarm()` | `run_group_chat` |
| `AFTER_WORK` | `AfterWork` |
| `ON_CONDITION` | `OnCondition` |

### Deprecated capabilities and modules

| Feature | Reason |
|---------|--------|
| `ImageGeneration` capability | Depends on deprecated `TextAnalyzerAgent` |
| `agent_eval` module (`generate_criteria`, `quantify_criteria`, `CriticAgent`, `QuantifierAgent`, `SubCriticAgent`) | experimental evaluation framework |

### Deprecated interoperability

| Feature | Alternative |
|---------|-------------|
| `CrewAIInteroperability` | LangChain or PydanticAI interop |

### Deprecated experimental tools

| Tool | Alternative |
|------|-------------|
| `PythonCodeExecutionTool` | `autogen.beta.tools.CodeExecutionTool` |
| `FirecrawlTool` | `Crawl4AITool` or `BrowserUseTool` |
| `SearxngSearchTool` | `DuckDuckGoSearchTool` or `TavilySearchTool` |
| `WebSearchPreviewTool` | `autogen.beta.tools.WebSearchTool` |

### What is NOT being deprecated

The core framework and actively maintained features continue without change:

- **Core agents**: `ConversableAgent`, `AssistantAgent`, `UserProxyAgent`
- **Group chat**: `GroupChat`, `GroupChatManager`, `run_group_chat`, and all orchestration patterns including handoffs (`AfterWork`, `OnCondition`, `OnContextCondition`)
- **RAG**: `RetrieveUserProxyAgent`, vector database integrations (ChromaDB, Qdrant, MongoDB, Couchbase, PGVector), graph RAG (Neo4j, FalkorDB)
- **Capabilities**: `Teachability`, `VisionCapability`, `TransformMessages`, `ToolsCapability`
- **Experimental agents**: `WebSurferAgent` (experimental), `DeepResearchAgent`, `ReasoningAgent`, `DocAgent`, `CaptainAgent`, `A2UIAgent`, and platform agents (Discord, Slack, Telegram)

### Notebooks using outdated models

A number of notebooks that reference unavailable or outdated models (e.g. `gpt-3.5-turbo`, `gpt-4-vision-preview`, `gpt-4-turbo-preview`) have also been deprecated and will be removed in v0.14.

### Documentation to be removed in v0.14

Associated blog posts, user guide pages, and notebooks for the above deprecated features will also be removed in v0.14. Each affected page and notebook now displays a deprecation warning.

## v0.13 — Transition period

- **Community feedback incorporated.** Deprecation decisions will be revisited based on feedback.
- **Beta API refinements.** Continued development and stabilisation of the beta API. Orchestration capabilities are introduced.
- Last release where deprecated features are still available.

## v0.14 — Final current-line release

- **Deprecated features removed.** Anything marked deprecated in v0.12 (and not rescued by community feedback) will be removed.
- **Beta moves to Release Candidate (RC).** The beta API is feature-complete and enters final testing.
- This is the last release of the original AG2 codebase on `main`.

## v1.0 — The new AG2

- **Original AG2 moves to the `ag2-original` branch** and will continue to receive maintenance updates.
- **The beta becomes stable** and takes over the `main` branch.
- **Documentation** — Primary documentation will focus on the v1.0 API. Documentation for the original AG2 version will remain available.

### Community feedback

As an open-source framework, we not only welcome, but encourage, users of the current version of AG2 to provide feedback on this roadmap.

The current beta development is being built for you. So, please bring your thoughts, opinions, and requirements forward so we can make sure it does what you need.

Please provide feedback through an Issue or on our [Discord](https://discord.com/invite/pAbnFJrkgZ) server.
