Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.plato.so/llms.txt

Use this file to discover all available pages before exploring further.

1

Get an API key

Open https://plato.so/settings and scroll to the bottom. Create a Personal API Key or an Organization API Key there.
Do not use the legacy API key shown at the top of the settings page — it’s deprecated and won’t work with the Core SDK. Always use a Personal or Organization key from the bottom of the page.
Your API key has full access to your environments. Don’t commit it.
2

Install the SDK

Requires Python 3.10+ and plato-sdk-v2 >= 2.61.4.
uv add 'plato-sdk-v2>=2.61.4'
Or with pip:
pip install 'plato-sdk-v2>=2.61.4'
3

Set your API key

export PLATO_API_KEY=your_api_key_here
The SDK picks this up automatically. Or pass it directly: Plato(api_key="...").
4

Point the SDK at your tenant (if needed)

The SDK defaults to the main Plato node at https://plato.so. If you’re on a dedicated tenant node, set the base URL to https://{tenant}.plato.so:
export PLATO_BASE_URL=https://your-tenant.plato.so
Or pass it directly: Plato(base_url="https://your-tenant.plato.so"). If you’re on the main node (plato.so), skip this step.

​
What’s next

Concepts

Sessions, environments, sims, mutations, scoring

Computer Use

Drive a full Linux desktop — mouse, keyboard, shell, files