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, 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

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