Installation

Install

pip install meshai-sdk

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.

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

Requirements

Configuration

Environment Variables

Constructor vs Environment

Verify Installation

Next Steps

Client Reference

Framework Guides

​Install

​Optional Dependencies

​Requirements

​Configuration

​Environment Variables

​Constructor vs Environment

​Verify Installation

​Next Steps

Client Reference

Framework Guides

Install

Optional Dependencies

Requirements

Configuration

Environment Variables

Constructor vs Environment

Verify Installation

Next Steps