> ## 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).