Environment:Microsoft Autogen Python Runtime Environment

Knowledge Sources	Microsoft AutoGen autogen-core pyproject.toml autogen-agentchat pyproject.toml
Domains	Infrastructure, Multi_Agent_Systems
Last Updated	2026-02-11 18:00 GMT

Overview

Python 3.10+ environment with Pydantic 2.10+, protobuf 5.29, and OpenTelemetry for running the AutoGen multi-agent framework core and agent chat packages.

Description

This environment defines the base runtime context for all AutoGen Python packages (autogen-core and autogen-agentchat). It requires Python 3.10 or higher and a set of foundational dependencies including Pydantic for data validation, protobuf for serialization, Pillow for image handling, and OpenTelemetry for distributed tracing. The autogen-agentchat package pins to the exact same version of autogen-core (0.7.5), ensuring tight compatibility between the agent layer and the runtime layer.

Usage

Use this environment for any AutoGen workflow — multi-agent conversations, swarm handoffs, graph-based orchestration, and tool-augmented agents. It is the mandatory prerequisite for every Implementation page in this wiki. Without this environment, no AutoGen Python code can execute.

System Requirements

Category	Requirement	Notes
OS	Linux, macOS, or Windows	Cross-platform; Windows may need WSL for some extensions
Python	>= 3.10	autogen-core and autogen-agentchat require 3.10+
Disk	500MB+	For package installation and cache

Dependencies

System Packages

`python` >= 3.10 (CPython recommended)
`pip` or `uv` package manager

Python Packages

Core (autogen-core 0.7.5):

`pillow` >= 11.0.0
`typing-extensions` >= 4.0.0
`pydantic` >= 2.10.0, < 3.0.0
`protobuf` ~= 5.29.3
`opentelemetry-api` >= 1.34.1
`jsonref` ~= 1.1.0

AgentChat (autogen-agentchat 0.7.5):

`autogen-core` == 0.7.5 (exact pin)

Credentials

No credentials required for the base runtime environment. LLM provider API keys are documented in Environment:Microsoft_Autogen_LLM_Provider_API_Keys.

Optional telemetry control:

`AUTOGEN_DISABLE_RUNTIME_TRACING`: Set to `"true"` to disable OpenTelemetry tracing.

Quick Install

# Install core + agentchat
pip install autogen-agentchat==0.7.5

# Or using uv (recommended for development)
uv sync --all-extras
source .venv/bin/activate

Code Evidence

Python version requirement from `autogen-core/pyproject.toml:11`:

requires-python = ">=3.10"

Core dependencies from `autogen-core/pyproject.toml:17-24`:

dependencies = [
    "pillow>=11.0.0",
    "typing-extensions>=4.0.0",
    "pydantic<3.0.0,>=2.10.0",
    "protobuf~=5.29.3",
    "opentelemetry-api>=1.34.1",
    "jsonref~=1.1.0",
]

Exact version pin from `autogen-agentchat/pyproject.toml:17-19`:

dependencies = [
    "autogen-core==0.7.5",
]

Python 3.13+ compatibility check from `_single_threaded_agent_runtime.py:26-29`:

if sys.version_info >= (3, 13):
    from asyncio import QueueShutDown
else:
    class QueueShutDown(Exception): ...

Common Errors

Error Message	Cause	Solution
`requires-python>=3.10 not satisfied`	Python version too old	Upgrade to Python 3.10 or higher
`pydantic.errors.PydanticUserError`	Pydantic v1 installed instead of v2	`pip install "pydantic>=2.10.0,<3.0.0"`
`ModuleNotFoundError: No module named 'autogen_core'`	autogen-core not installed	`pip install autogen-core==0.7.5`

Compatibility Notes

Python 3.13+: Uses native `asyncio.QueueShutDown`; earlier versions use a polyfill.
Python 3.11+: Uses `typing.Self` from standard library; earlier versions fall back to `typing_extensions.Self`.
Pydantic: Requires v2 (>= 2.10.0). Pydantic v1 is not compatible.

Related Pages

Page Connections

Double-click a node to navigate. Hold to expand connections.

Principle

Implementation

Heuristic

Environment