contree-sdk
SDK for ConTree container runtime with versioned filesystem state
Decision gist · record as of 2026-08-14
Yes, if you need reproducible, versioned container execution from Python and are comfortable with a pre-alpha API. The low install friction, active maintenance, and permissive license make it a reasonable choice for research and agent development. Verify that the ConTree runtime service meets your infrastructure needs before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10–3.14; ConTree token needed to authenticate with the container runtime service.
- Low install friction with a pure-Python wheel and five lightweight dependencies.
- Active maintenance with a recent release (14 days old).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.
last release 2026-07-31 (14 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 578,246 downloads/mo, #5,923 on PyPI
Alternatives
Verify before relying
pip install contree-sdk
from contree_sdk import Contree
import asyncio
async def main():
contree = Contree(token="your-token")
image = await contree.images.use("ubuntu:latest")
result = await image.run(shell='echo "Hello"')
print(result.stdout)
asyncio.run(main())- Whether ConTree runtime service is self-hosted or cloud-managed, and what infrastructure setup is required.
- Performance characteristics and latency for typical workloads (command execution, file transfer).
- Stability guarantees and breaking-change policy during pre-alpha phase.
What it is and what it does
ConTree SDK is a Python client for ConTree, a container runtime designed to support reproducible, versioned execution environments. It exposes both async and sync APIs to run commands, manage images, handle file uploads/downloads, and maintain persistent sessions within containers. The core abstraction treats container filesystem state like Git: you can branch, version, and reproduce execution contexts deterministically.
The SDK depends on httpx for HTTP communication, aiofiles for async file I/O, cattrs for serialization, strenum for enum handling, and typing-extensions for modern type hints. It's actively maintained but in pre-alpha, so the API may change. Use it when you need reproducible, versioned container execution from Python—particularly for research on software engineering agents or workflows requiring deterministic state snapshots.
Use it for
- Run reproducible commands in versioned container environments for SWE agent research and testing.
- Manage persistent sessions with automatic version tracking across multiple command executions.
- Upload local files to containers, execute workflows, and download results programmatically.
- Branch container filesystem state and explore divergent execution paths like Git branches.
- Integrate container-based sandboxing into Python applications with async/sync flexibility.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need reproducible, versioned container execution from Python and are comfortable with a pre-alpha API.
The low install friction, active maintenance, and permissive license make it a reasonable choice for research and agent development. Verify that the ConTree runtime service meets your infrastructure needs before committing to production use.
Install
contree-sdk on PyPI
Before you install
Low install friction with a pure-Python wheel and five lightweight dependencies. Active maintenance with a recent release (14 days old). Pre-alpha status means the API surface may shift.
Requires Python 3.10–3.14; ConTree token needed to authenticate with the container runtime service.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.
Quickstart
pip install contree-sdk
from contree_sdk import Contree
import asyncio
async def main():
contree = Contree(token="your-token")
image = await contree.images.use("ubuntu:latest")
result = await image.run(shell='echo "Hello"')
print(result.stdout)
asyncio.run(main())Verify before relying
- Whether ConTree runtime service is self-hosted or cloud-managed, and what infrastructure setup is required.
- Performance characteristics and latency for typical workloads (command execution, file transfer).
- Stability guarantees and breaking-change policy during pre-alpha phase.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <3.15,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesaiofilescattrshttpxstrenumtyping-extensions |
| Maintenance | Actively maintained 14 days since the last release |
| First released | |
| Downloads | 578,246 / month, #5,923 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 2 - Pre-AlphaLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: contree_sdk-0.3.6-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 › “container runtime sdk python”
- contree-sdkPython SDK for ConTree, a container runtime that provides versioned,…
- azure-mgmt-containerinstanceManages Azure Container Instances—create, configure, and monitor…
- dagger-ioDagger Python SDK is a client for defining and running CI/CD…
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 cwsandbox · bashkit · llm-sandbox · koyeb-sdk · morefs · zope.container · pytest-container · dvc-ssh · dockerpty · fs