runloop_api_client

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 on this page — 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

runloop-api-client on PyPI

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

Evidence: runloop_api_client-1.28.0-py3-none-any.whl

Tags

More Python Modules packages