Installation

Requirements

• Python 3.9 or higher
• An active internet connection (telemetry is sent asynchronously and never blocks execution)

Install via pip

pip install maev-sdk

Install via uv

uv add maev-sdk

Install via Poetry

poetry add maev-sdk

Dependencies

maev-sdk installs its one required dependency automatically. You do not need to install anything else to get started.

Environment variable

Never hardcode your API key. Store it in an environment variable:

export MAEV_API_KEY="vl_your_key_here"

Or in a .env file with python-dotenv:

# .env
MAEV_API_KEY=vl_your_key_here

from dotenv import load_dotenv
import maev
 
load_dotenv()
maev.run(my_agent, gateway=True)  # picks up MAEV_API_KEY automatically