mutagent-sdk 0.3.0

╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║    ███╗   ███╗██╗   ██╗████████╗ █████╗  ██████╗ ███████╗███╗   ██╗████████╗ ║
║    ████╗ ████║██║   ██║╚══██╔══╝██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝ ║
║    ██╔████╔██║██║   ██║   ██║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║    ║
║    ██║╚██╔╝██║██║   ██║   ██║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║    ║
║    ██║ ╚═╝ ██║╚██████╔╝   ██║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║    ║
║    ╚═╝     ╚═╝ ╚═════╝    ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝    ║
║                                                                              ║
║              ██████╗ ██╗   ██╗████████╗██╗  ██╗ ██████╗ ███╗   ██╗           ║
║              ██╔══██╗╚██╗ ██╔╝╚══██╔══╝██║  ██║██╔═══██╗████╗  ██║           ║
║              ██████╔╝ ╚████╔╝    ██║   ███████║██║   ██║██╔██╗ ██║           ║
║              ██╔═══╝   ╚██╔╝     ██║   ██╔══██║██║   ██║██║╚██╗██║           ║
║              ██║        ██║      ██║   ██║  ██║╚██████╔╝██║ ╚████║           ║
║              ╚═╝        ╚═╝      ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝           ║
║                                                                              ║
║                    Python SDK for AI-Native Development.                     ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

Type-safe. Async-first. Production-ready.
The official Python SDK for the MutagenT AI platform.

🎯 What is MutagenT Python SDK?

The MutagenT Python SDK is a developer-friendly, fully typed client for the MutagenT AI platform. Built for modern AI applications, it provides:

• 🔒 Typed Models — a Pydantic v2 model for every request and response body in the API spec
• ⚡ Sync + Async — Mutagent (sync) and AsyncMutagent (async) dual surface
• 🐍 Python 3.10+ — three runtime dependencies: httpx, pydantic, typing-extensions
• 🔐 HTTPS by Default — plain-HTTP server URLs are refused for non-local hosts unless you opt in
• 🧩 Spec-Generated — every namespace is emitted from the platform's OpenAPI document

Core Capabilities

📦 Installation

pip install mutagent-sdk

The PyPI distribution is mutagent-sdk; the import path remains from mutagent import ....

from mutagent import Mutagent, AsyncMutagent

🚀 Quick Start

Sync client

from mutagent import Mutagent

client = Mutagent(api_key="YOUR_API_KEY", server_url="https://api.mutagent.io")

agents = client.agents.list_agents(limit=10)
print(f"Found {len(agents['data'])} agents")

server_url defaults to MUTAGENT_SERVER_URL, and to http://localhost:3003 when that is unset — point it at your host explicitly when you are not running the platform locally.

Set MUTAGENT_API_KEY in your environment and omit the argument entirely:

export MUTAGENT_API_KEY="sk_live_xxxxxxxx"

from mutagent import Mutagent

client = Mutagent()  # reads MUTAGENT_API_KEY automatically

Async client

import asyncio
from mutagent import AsyncMutagent

async def main():
    async with AsyncMutagent(
        api_key="YOUR_API_KEY",
        server_url="https://api.mutagent.io",
    ) as client:
        # Who am I?
        profile = await client.user_profile.get_profile()
        print(profile)

        # Which workspaces can I see?
        workspaces = await client.workspaces.list_workspaces()
        print(workspaces)

asyncio.run(main())

📚 Namespaces

The client exposes one namespace per API tag. Every method has a sync and an async form:

Per-method reference lives in docs/sdks/.

☁️ Cloud Sandboxes

The platform runs disposable, isolated cloud sandboxes: you spawn one, execute commands or a single agent turn inside it, watch its output as it happens, read the spans it captured, and tear it down.

Availability: these routes are live in the platform API. This release of the Python client does not yet generate a sandbox namespace for them — until it does, call them over HTTPS with your API key in the x-api-key header.

🧪 Testing

The SDK ships a dev extras group with everything needed for testing:

pip install "mutagent-sdk[dev]"
# Includes: pytest, pytest-asyncio, pytest-httpx, ruff, mypy

Run the test suite:

pytest tests/

pytest-httpx is used to mock outgoing HTTP calls without spinning up a server. Tests live in tests/ at the package root.

🏗️ Generated by mutagent-xgen

This package is generated by mutagent-xgen — MutagenT's proprietary in-house SDK generator. The generator ensures the Python client stays in sync with the API specification.

To regenerate after API changes:

# Fetch latest spec from running server
bash scripts/dump-spec.sh

# Regenerate SDK
mutagent-xgen run

Note: README.md is emitted once and is never rewritten by a regeneration, so the hand-written content here is safe.

📜 License

This SDK is released under the Apache License 2.0.

Copyright 2026 MutagenT. All rights reserved.

_{Built with care by the MutagenT Team • mutagent.io}