Installation

Install

pip install meshai-sdk

The current release is 0.6.0. Upgrade an existing environment with:

pip install --upgrade "meshai-sdk==0.6.0"

On Ubuntu/Debian, if you get externally-managed-environment error, create a virtual environment first:

python3 -m venv .venv && source .venv/bin/activate
pip install meshai-sdk

Optional Dependencies

Install extras for framework auto-tracking:

# OpenAI integration
pip install meshai-sdk[openai]

# Anthropic integration
pip install meshai-sdk[anthropic]

# CrewAI integration
pip install meshai-sdk[crewai]

# LangChain integration
pip install meshai-sdk[langchain]

# AutoGen integration
pip install meshai-sdk[autogen]

# Multiple integrations at once
pip install "meshai-sdk[openai,anthropic,langchain]"

Additional integration extras are also available: agno, bedrock, gemini, llamaindex, pydantic-ai, and semantic-kernel. See the Agno, Bedrock, Gemini, LlamaIndex, Pydantic AI, and Semantic Kernel guides for setup details. Install the tracer extra for OpenTelemetry sessions, spans, and the optional GenAI input-emission API introduced in 0.6.0:

pip install "meshai-sdk[tracer]==0.6.0"

Recent releases

Version	Upgrade impact
`0.6.0`	Adds default-off GenAI input emission with local redaction. Tenant payload capture must also be enabled.
`0.5.1`	Raises the `tracer` extra’s OpenTelemetry minimum to `1.44.0`; no runtime behavior change.
`0.5.0`	Sends default production OTLP traffic to `https://ingest.meshai.dev`; API, registry, cost, and heartbeat traffic continue using `base_url`.

For 0.5.0, an explicitly self-hosted or localhost base_url keeps telemetry on that deployment. Set ingest_url when you need a separate collector endpoint. This routing behavior continues in 0.6.0.

Requirements

Python 3.10+
An API key from app.meshai.dev

Configuration

The SDK can be configured via constructor arguments, environment variables, or a combination of both.

Environment Variables

Variable	Description	Required
`MESHAI_API_KEY`	Your API key (`msh_...`)	Yes (if not passed to constructor)
`MESHAI_BASE_URL`	API base URL	No (default: `https://api.meshai.dev`)
`MESHAI_AGENT_NAME`	Default agent name	No
`MESHAI_ENVIRONMENT`	Agent environment (`production`, `staging`, `dev`)	No (default: `production`)
`MESHAI_HEARTBEAT_INTERVAL`	Heartbeat interval in seconds	No (default: `30`)
`MESHAI_TIMEOUT`	HTTP request timeout in seconds	No (default: `10`)

Constructor vs Environment

Constructor arguments take precedence over environment variables:

from meshai import MeshAI

# Uses MESHAI_API_KEY from env
client = MeshAI(agent_name="my-agent")

# Explicit key overrides env
client = MeshAI(api_key="msh_...", agent_name="my-agent")

Verify Installation

from meshai import MeshAI

client = MeshAI(api_key="msh_...", agent_name="test-agent")
agent = client.register(framework="custom", model_provider="openai")
print(f"Registered: {agent['id']}")

SDK Reference

Install

Optional Dependencies

Recent releases

Requirements

Configuration

Environment Variables

Constructor vs Environment

Verify Installation

Next Steps

Client Reference

Framework Guides

​Install

​Optional Dependencies

​Recent releases

​Requirements

​Configuration

​Environment Variables

​Constructor vs Environment

​Verify Installation

​Next Steps

Client Reference

Framework Guides

Install

Optional Dependencies

Recent releases

Requirements

Configuration

Environment Variables

Constructor vs Environment

Verify Installation

Next Steps