Skip to main content
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 availablemeshagent[all]
Use the CLI for local setup, testing, and deploymentmeshagent[cli]
Add room and REST clients to an existing Python servicemeshagent-api
Build custom agent code on top of the Python runtimemeshagent-agents
Add a specific capability such as tools, MCP, OpenAI, Anthropic, LiveKit, or computer useInstall 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

​
Package Map

Installable packagePython importsUse it when…
meshagentmeshagentYou want the umbrella package and extras such as [all], [cli], and [agents]
meshagent-apimeshagent.apiYou need room clients, REST/admin clients, participant tokens, service specs, or webhooks
meshagent-agentsmeshagent.agentsYou are building custom agents or using the lower-level Python runtime types behind meshagent process
meshagent-climeshagent.cliYou need the meshagent CLI commands
meshagent-toolsmeshagent.toolsYou are defining tools or toolkits in Python
meshagent-mcpmeshagent.mcpYou want to expose MCP tools through MeshAgent
meshagent-openaimeshagent.openaiYou need OpenAI adapters
meshagent-anthropicmeshagent.anthropicYou need Anthropic adapters
meshagent-livekitmeshagent.livekitYou are building voice or LiveKit-based workflows
meshagent-computersmeshagent.computersYou need browser or computer-control helpers
meshagent-codexmeshagent.codexYou need Codex-specific integrations
meshagent-otelmeshagent.otelYou 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.