koyeb-sdk
Koyeb python sdk
Decision gist · record as of 2026-08-14
Yes. The SDK is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and solves a real problem—safe, on-demand code execution in the cloud. It's well-suited for CI/CD, untrusted code execution, and rapid prototyping. Requires an API token and Koyeb account; verify pricing and sandbox quotas before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a Koyeb API token set via the KOYEB_API_TOKEN environment variable; Python >= 3.9.
- Low install friction with a pure-Python wheel distribution.
- Actively maintained with recent releases; last commit on 2026-08-12.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
last release 2026-07-09 (36 days) · last repo commit 2026-08-12
0 known vulnerabilities (OSV.dev, 2026-08-14) · 171,705 downloads/mo, #10,357 on PyPI
Alternatives
Verify before relying
pip install koyeb-sdk
import os
from koyeb import Sandbox
sandbox = Sandbox.create(
image="ubuntu",
name="test",
wait_ready=True,
)
result = sandbox.exec("echo hello")
print(result.stdout)
sandbox.delete()- Whether the synchronous and asynchronous API clients have feature parity or differ in supported operations.
- Rate limits or quota constraints on sandbox creation and execution imposed by the Koyeb platform.
- Whether sandboxes support GPU or specialized compute resources beyond standard CPU/memory.
- Pricing model and whether the SDK itself is free to use or if Koyeb platform usage incurs costs.
What it is and what it does
The Koyeb SDK is the official Python interface to Koyeb's cloud platform, offering both synchronous and asynchronous REST API clients for programmatic control of deployments and services. Its primary feature is the Sandbox module, which lets you spin up isolated, ephemeral environments—containerized or virtualized spaces where you can safely execute untrusted code, test libraries, or prototype applications without affecting other systems. Sandboxes are designed to be short-lived and fully disposable, with complete control over dependencies and runtime context.
The SDK exposes methods for sandbox lifecycle management (create, delete), file operations (read, write), command execution, and port exposure. It depends on httpx for async HTTP calls, urllib3 for sync requests, pydantic for data validation, websockets for real-time communication, and python-dateutil for timestamp handling. It requires Python 3.9 or later and is actively maintained with low installation friction.
Use it for
- Execute user-generated or untrusted code safely in isolated environments without risking your host system.
- Prototype and test applications quickly in clean, on-demand compute environments without local infrastructure setup.
- Run CI/CD pipeline steps in ephemeral sandboxes that spin up in seconds and leave no state behind.
- Provide safe, reproducible code execution environments for educational platforms or online coding tools.
- Evaluate AI models or run inference workloads in isolated, time-limited execution contexts.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The SDK is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and solves a real problem—safe, on-demand code execution in the cloud. It's well-suited for CI/CD, untrusted code execution, and rapid prototyping. Requires an API token and Koyeb account; verify pricing and sandbox quotas before committing to production use.
Install
koyeb-sdk on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Actively maintained with recent releases; last commit on 2026-08-12. Depends on standard HTTP and async libraries (httpx, urllib3, websockets) plus pydantic for validation.
Requires a Koyeb API token set via the KOYEB_API_TOKEN environment variable; Python >= 3.9.
License in practice
Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install koyeb-sdk
import os
from koyeb import Sandbox
sandbox = Sandbox.create(
image="ubuntu",
name="test",
wait_ready=True,
)
result = sandbox.exec("echo hello")
print(result.stdout)
sandbox.delete()
Verify before relying
- Whether the synchronous and asynchronous API clients have feature parity or differ in supported operations.
- Rate limits or quota constraints on sandbox creation and execution imposed by the Koyeb platform.
- Whether sandboxes support GPU or specialized compute resources beyond standard CPU/memory.
- Pricing model and whether the SDK itself is free to use or if Koyeb platform usage incurs costs.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesurllib3python-dateutilpydantictyping-extensionswebsocketshttpx |
| Maintenance | Actively maintained 36 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 171,705 / month, #10,357 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: koyeb_sdk-1.5.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “koyeb api client”
- koyeb-sdkOfficial Python SDK for Koyeb that provides synchronous and…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
- twentyc.rpcA client library for consuming 20c's RESTful API, built on top of the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also prime-sandboxes · e2b · e2b-desktop · blaxel · opensandbox · k8s-agent-sandbox · e2b-code-interpreter · contree-sdk · hyperbrowser · todoist_api_python