---
id: plato-sdk-v2
version: "2.127.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# plato-sdk-v2 — Python SDK for the Plato API

License: permissive · Maintenance: active · Downloads: 395.6K/mo

## What it is and what it does

Plato SDK v2 is a Python client library for the Plato platform, a service that provisions and manages isolated virtual environments (simulators) for testing, evaluation, and automation tasks. It provides both async and sync interfaces to create sessions, spin up environments like Gitea or Kanboard, execute commands within them, and evaluate task completion against predefined test cases. The SDK handles session lifecycle (creation, reset, cleanup), exposes public URLs for browser access, and integrates with Plato's agent system for custom automation workflows.

The package is designed for developers building evaluation frameworks, automated testing pipelines, or custom agents that need to interact with ephemeral environments. It depends on a substantial stack including aiohttp for async HTTP, boto3 for cloud operations, litellm for LLM integration, pydantic for validation, and opentelemetry for observability. Configuration is environment-based (API key and base URL), and agents can be published to Plato's PyPI via CLI commands.

Use it for:

- Create isolated test environments for evaluating agent behavior against predefined test cases with automatic mutation logging and evaluation scoring.
- Spin up simulator instances (Gitea, Kanboard, etc.) for development or testing, then execute shell commands and retrieve state mutations programmatically.
- Build custom agents by subclassing BaseAgent and publish them to Plato's package registry for use in platform VMs.
- Run browser automation workflows by combining Plato environments with the computer-use agent for interactive task completion.
- Monitor environment state and reset individual simulators during test runs without recreating the entire session.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for the Plato platform that manages sessions, environments, and agents for browser automation and task evaluation within Plato VMs.

Yes, if you are building on the Plato platform or need a managed environment provisioning and evaluation framework. The SDK is actively maintained (released 2 days ago), has low install friction, carries no known vulnerabilities, and is MIT-licensed. The 29 runtime dependencies are substantial but expected for a platform SDK. Install only if you have a Plato API key and are committed to the platform's architecture; it is not a general-purpose automation library.

## Install

pip install plato-sdk-v2
uv add plato-sdk-v2
poetry add plato-sdk-v2

## Installing plato-sdk-v2

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release 2 days old. Brings 29 runtime dependencies including aiohttp, boto3, litellm, and opentelemetry instrumentation, which adds some weight but is typical for a platform SDK.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install plato-sdk-v2

import asyncio
from plato.v2 import AsyncPlato, Env

async def main():
    plato = AsyncPlato()
    session = await plato.sessions.create(
        envs=[Env.simulator("gitea", alias="gitea")],
        timeout=600,
    )
    await session.close()
    await plato.close()

asyncio.run(main())

Requires Python 3.11 or 3.12. Needs PLATO_API_KEY environment variable or .env file configuration to authenticate with the Plato platform.

Verify before relying:

- Whether the 29 runtime dependencies create significant version-conflict risk in existing projects.
- Performance characteristics when managing multiple concurrent environments or sessions.
- Stability guarantees for the Beta development status and how breaking changes are communicated.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 395.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

plato platform sdk, browser automation framework, environment management python, agent-based task automation, test case evaluation sdk, simulator environment control, async session management, plato-platform, environment-provisioning, agent-framework

[View on SkillFed](https://skillfed.io/packages/plato-sdk-v2) · [View on PyPI](https://pypi.org/project/plato-sdk-v2/)