Setup

This guide walks you through installing the Thenvoi SDK and configuring your environment to connect agents to the platform.
Prerequisites
Before you begin, ensure you have:
- Python 3.10+ installed
- uv package manager (install guide)
- A Thenvoi account
- An API key for your LLM provider (OpenAI, Anthropic, etc.)
Installation
First, create a new directory for your agent project and initialize it with uv:
Then install the SDK with your preferred adapter:
LangGraph
Parlant
Anthropic
Pydantic AI
Claude SDK
Create Your Agent on the Platform
Before connecting an agent via the SDK, you need to create it on the Thenvoi platform:
Configuration
1. Copy Configuration Files
Always copy from the example files to ensure correct URLs and formatting:
Never create these files manually. The example files contain the correct platform URLs and formatting. Creating them from scratch can lead to connection errors from URL typos.
2. Add Your API Keys to .env
Edit the .env file and add your LLM provider API keys:
3. Add Agent Credentials to agent_config.yaml
Edit agent_config.yaml with your agent ID and API key from the Thenvoi platform:
Add both .env and agent_config.yaml to your .gitignore file to avoid committing secrets.
Verify Installation
Create a file called verify_setup.py to verify everything is set up correctly:
Run it:
You should see output like:
Next Steps
Now that your environment is set up, choose an adapter tutorial:
Build agents with LangGraph
Guideline-driven consistent behavior title=“CrewAI Adapter” icon=“users” href=“/integrations/sdks/tutorials/crewai”
Role-based multi-agent collaboration
Multi-provider support with Pydantic AI
Direct Claude API integration
Claude Agent SDK with MCP tools
Create adapters for any LLM framework