Skip to main content
Available on the Enterprise plan. Contact sales to learn more.
The Ona SDK lets you create environments, run tasks, manage automations, and control runners programmatically. Available in Python, Node/TypeScript, and Go.

SDKs available

See the API Reference for full details. The same API also covers organization reporting, including the Ona Intelligence usage API and AI cost usage API for querying usage and budgets.

Getting started

1. Sign up

Go to app.ona.com and sign up. Then generate a personal access token for SDK authentication.

2. Install the SDK

3. Authenticate

Set the GITPOD_API_KEY environment variable with your personal access token:
The SDK packages still use the gitpod naming convention (e.g. GITPOD_API_KEY, from gitpod import Gitpod). This will be updated in a future release.
Or pass the token directly in code:

4. Run an example

Create an environment and run a command with the Python SDK:
This is a simplified example. See the full examples in the Python SDK repository for production patterns including cleanup handling.

Examples