> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meshagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Python SDK

> Choose the right MeshAgent Python packages for your workflow.

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.

<CodeGroup>
  ```bash uv theme={null}
  uv add "meshagent[all]"
  uv add "meshagent[cli]"
  uv add meshagent-api
  uv add meshagent-agents
  ```

  ```bash pip theme={null}
  pip install "meshagent[all]"
  pip install "meshagent[cli]"
  pip install meshagent-api
  pip install meshagent-agents
  ```
</CodeGroup>

## 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](./sdk_reference). If you want to build and deploy agents from the CLI, go to [Process Agents](../agents/process/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.