# sandboxes-python-sdk

Lets Python code create, start, stop and control Koyeb sandboxes through the koyeb-sdk package.

Skill by Koyeb. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add koyeb/koyeb-skills --skill sandboxes-python-sdk
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add koyeb/koyeb-skills --skill sandboxes-python-sdk -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 4. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/koyeb/koyeb-skills/sandboxes-python-sdk)

## Source

[Open the source](https://github.com/koyeb/koyeb-skills/tree/HEAD/plugins/koyeb/skills/sandboxes-python-sdk). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: sandboxes-python-sdk
description: Use the Koyeb Python SDK (koyeb-sdk) to create and manage sandboxes programmatically. Use when the user wants Python sandbox automation.
license: MIT
compatibility: Requires Python, pip, and network access.
metadata:
  author: koyeb
  version: "0.0.2"
---

# Koyeb Sandboxes (Python SDK)

## When to use

Use this skill when the user asks to manage Koyeb sandboxes from Python using the official SDK.

## Prerequisites

- Python environment
- Package installed: `koyeb-sdk`
- API token available as `KOYEB_API_TOKEN`

## Workflow

1. Install the SDK package.
2. Configure authentication using `KOYEB_API_TOKEN`.
3. Create, start, or stop sandboxes as needed.
4. Execute commands or retrieve logs/status through the SDK.
5. Clean up sandboxes when finished.

## Examples

- Install the SDK: `pip install koyeb-sdk`
- Use token auth: set `KOYEB_API_TOKEN` in your environment

## References

For detailed flags and SDK usage, see references/koyeb-sandbox-python-sdk.md.

- references/koyeb-sdk-auth.md
- references/koyeb-sandbox-python-sdk.md
````

- Previous: [sandboxes-js-sdk](https://syn4pse.dev/terminal/koyeb-sandboxes-js-sdk.md)
- Next: [secrets](https://syn4pse.dev/terminal/koyeb-secrets.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
