---
id: runloop-api-client
version: "1.28.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# runloop_api_client — The official Python library for the runloop API

License: permissive · Maintenance: active · Downloads: 929.8K/mo

## What it is and what it does

This is an official Python client library for the Runloop REST API, generated with Stainless. It provides both synchronous and asynchronous clients powered by httpx, with full type annotations for all request parameters and response fields. The library includes an object-oriented SDK layer for higher-level, Pythonic interaction with Runloop devboxes, as well as a lower-level REST API client for direct API access.

The package handles common API patterns automatically: pagination across list results, typed request/response models using Pydantic, file uploads, and error handling with specific exception types for connection failures and rate limits. It supports environment-based authentication via RUNLOOP_API_KEY and includes optional aiohttp integration for improved async concurrency performance.

Use it for:

- Create and manage remote development environments (devboxes) and execute commands within them programmatically
- Build automation workflows that interact with Runloop infrastructure using typed, IDE-aware Python code
- Integrate Runloop devbox operations into async Python applications with automatic pagination and error handling
- Prototype or script against the Runloop API without manually constructing HTTP requests or parsing JSON responses

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for the Runloop REST API, providing typed synchronous and asynchronous access to devbox management and command execution.

Yes. Active maintenance, no known vulnerabilities, low install friction, and permissive MIT license. The library is well-suited for developers who need programmatic access to Runloop devboxes. The dual sync/async interface and comprehensive type coverage reduce friction. Consider it if you're building tooling or automation around Runloop infrastructure.

## Install

pip install runloop-api-client
uv add runloop-api-client
poetry add runloop-api-client

## Installing runloop_api_client

Before you install: Low install friction; wheel distribution. Active maintenance with recent release (16 days ago). Supports Python 3.9 through 3.14 and runs on all major platforms.

License in practice: MIT license (permissive); no restrictions on commercial or private use.

Quickstart:

pip install runloop_api_client

import os
from runloop_api_client import Runloop

client = Runloop(
    bearer_token=os.environ.get("RUNLOOP_API_KEY")
)
devbox = client.devboxes.create()
print(devbox.id)

Requires Python 3.9 or later and a valid RUNLOOP_API_KEY environment variable or bearer token.

Verify before relying:

- Whether the object-oriented RunloopSDK layer is production-ready or still experimental
- Performance characteristics of auto-pagination for large result sets
- Whether aiohttp backend provides measurable concurrency improvement for typical workloads

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 929.8K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

runloop api client, devbox management python, async rest api client, typed http client, runloop devbox sdk, api-client, async-support, typed

[View on SkillFed](https://skillfed.io/packages/runloop-api-client) · [View on PyPI](https://pypi.org/project/runloop-api-client/)