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