Installation - MUTAGENT

pip install mutagent-sdk

The package is mutagent-sdk; you import it as mutagent. It needs Python 3.10 or newer. Check your version first:

python3 --version

On Python 3.9 or older (the default python3 on macOS is 3.9), pip prints ERROR: No matching distribution found for mutagent-sdk without naming the Python version. Install into a virtual environment with a newer Python instead:

python3.12 -m venv .venv && . .venv/bin/activate && pip install mutagent-sdk

These pages describe mutagent-sdk 0.4.1. Earlier versions use different method, group and type names, so update if a call on these pages is missing:

pip install --upgrade mutagent-sdk

Make your first call

Set an API key in your environment. See API keys for where to create one.

export MUTAGENT_API_KEY=<api-key>

whoami.py

from mutagent import Mutagent

client = Mutagent()  # reads MUTAGENT_API_KEY

print([workspace.name for workspace in client.workspaces.list_workspaces().workspaces])

python whoami.py

['Default workspace']

If the key is not valid, the call raises mutagent.errors.SDKError with status_code 401 and a message that starts [listWorkspaces] HTTP 401. The response body, in the error’s body, says Invalid, expired or revoked API key. Check the key with mutagent auth status, or create a new one.

Configuration: the API address, timeouts, and the async client.
LLM providers: add the model keys your cloud runs use.
Environments and Helix Cloud: store secrets, run Helix in the cloud, deploy managed agents.

​Make your first call

​Next

Make your first call

Next