Install the Python SDK

Python is the only MeshAgent SDK published as a split package family. In code, you import modules like meshagent.api and meshagent.agents. In your environment, you install distributions like meshagent-api and meshagent-agents. The other MeshAgent SDKs do not use this split distribution model.

Choose an install path

Choose the install path that matches what you are trying to do:

If you want to…	Install
Build agents with the CLI and have the common integrations available	`meshagent[all]`
Use the CLI for local setup, testing, and deployment	`meshagent[cli]`
Add room and REST clients to an existing Python service	`meshagent-api`
Build custom agent code on top of the Python runtime	`meshagent-agents`
Add a specific capability such as tools, MCP, OpenAI, Anthropic, LiveKit, Telegram, Twilio, or computer use	Install the matching split package directly

If you are new to the Python SDK, start with meshagent[all]. If you are keeping an environment small on purpose, install only the packages you need.

uv add "meshagent[all]"
uv add "meshagent[cli]"
uv add meshagent-api
uv add meshagent-agents

pip install "meshagent[all]"
pip install "meshagent[cli]"
pip install meshagent-api
pip install meshagent-agents

Package Map

Installable package	Python imports	Use it when…
`meshagent`	`meshagent`	You want the umbrella package and extras such as `[all]`, `[cli]`, and `[agents]`
`meshagent-api`	`meshagent.api`	You need room clients, REST/admin clients, participant tokens, service specs, or webhooks
`meshagent-agents`	`meshagent.agents`	You are building custom agents or using the lower-level Python runtime types behind `meshagent process`
`meshagent-cli`	`meshagent.cli`	You need the `meshagent` CLI commands
`meshagent-tools`	`meshagent.tools`	You are defining tools or toolkits in Python
`meshagent-mcp`	`meshagent.mcp`	You want to expose MCP tools through MeshAgent
`meshagent-openai`	`meshagent.openai`	You need OpenAI adapters
`meshagent-anthropic`	`meshagent.anthropic`	You need Anthropic adapters
`meshagent-livekit`	`meshagent.livekit`	You are building voice or LiveKit-based workflows
`meshagent-commoncrawl`	`meshagent.commoncrawl`	You want to import Common Crawl captures into room datasets
`meshagent-scrapy`	`meshagent.scrapy`	You want to spider websites with Scrapy into room datasets
`meshagent-computers`	`meshagent.computers`	You need browser or computer-control helpers
`meshagent-codex`	`meshagent.codex`	You need Codex-specific integrations
`meshagent-otel`	`meshagent.otel`	You want OpenTelemetry helpers in Python

Provider channel implementations for Telegram, Slack, Twilio, and WhatsApp are generated as editable source by meshagent create; they are not separate Python packages.

Imports vs. Packages

The import names and the install names are intentionally different:

from meshagent.api import ParticipantToken comes from the meshagent-api package.
from meshagent.agents import SingleRoomAgent comes from the meshagent-agents package.
from meshagent.openai import OpenAIResponsesAdapter comes from the meshagent-openai package.

If you need the cross-language view, go back to SDK Overview. If you want to build and deploy agents from the CLI, go to Process Agents.

Introduction

Rooms

Agents & Tools

Deploy & Manage

Projects

Product Interfaces

Developer Reference

Install the Python SDK

Choose an install path

Package Map

Imports vs. Packages

​Choose an install path

​Package Map

​Imports vs. Packages

Choose an install path

Package Map

Imports vs. Packages