hotcell (Python SDK)

Dependency-free Python client for the hotcell self-hostable agent sandbox daemon. Mirrors the TypeScript SDK surface (snake_cased) so the same workflows work from either language.

from hotcell import HotcellClient

client = HotcellClient(endpoint="http://127.0.0.1:4750")  # or $HOTCELL_ENDPOINT
sandbox = client.get_sandbox()                          # create a fresh sandbox

# run a command
result = sandbox.exec("python3 -c 'print(2 + 2)'")
print(result.stdout, result.exit_code)                  # "4\n" 0

# files
sandbox.write_file("/workspace/hi.txt", "hello")
print(sandbox.read_file("/workspace/hi.txt"))           # "hello"

# stateful code interpreter
ctx = sandbox.create_code_context(language="python")
ctx.run_code("x = 21")
print(ctx.run_code("x * 2").results[0].text)            # "42"

# metrics + cost
m = sandbox.metrics()
print(m.cost.total, m.usage.cpu_seconds)

sandbox.destroy()

Standard library only (urllib, json) — no third-party dependencies. Requires Python ≥ 3.9 and a running hotcell daemon.

Surface

HotcellClient: get_sandbox, list, health, info, list_backups, delete_backup.

Sandbox: exec, exec_stream, stop, start, destroy, metrics, write_file, read_file, mkdir, list_files, watch, start_process, list_processes, kill_process, stream_logs, wait_for_port, expose_port, unexpose_port, list_exposed_ports, set_env_vars, get_env_vars, create_session, list_sessions, create_backup, restore_backup, list_backups, create_code_context, list_code_contexts, run_code.

Session: exec, exec_stream, set_env_vars, destroy. CodeContext: run_code, destroy.

Metadata

Release files for hotcell 0.1.29

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hotcell 0.1.29
File	Size	Uploaded	Provenance
hotcell-0.1.29.tar.gz	13.8 kB	Oct 24, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for hotcell 0.1.29
File	Interpreter	ABI	Platform	Reset
hotcell-0.1.29-py3-none-any.whl 13.6 kB Oct 24, 2026 With provenance	Python 3	none	any	Details

Total release size: 27.4 kB

Release files / hotcell-0.1.29.tar.gz

Download URL	hotcell-0.1.29.tar.gz
Size	13.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`9ab429f0e5d05f0be1edba67084e570cc87e16ba68aed4c866ff208a63361555`
BLAKE2b-256 checksum How to use checksums	`4f0d8bfc790d90398aed8741989b817cc22a0e515fe93c791d87d857f7987478`
Upload date	Oct 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/sinameraji/hotcell
Publishing commit: github.com/sinameraji/hotcell/tree/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/40064417434/attempts/1

Artifact

Subject: hotcell-0.1.29.tar.gz
SHA-256 checksum: 9ab429f0e5d05f0be1edba67084e570cc87e16ba68aed4c866ff208a63361555 Verifying attestations

Release files / hotcell-0.1.29-py3-none-any.whl

Download URL	hotcell-0.1.29-py3-none-any.whl
Size	13.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a53acc35d768f76041e0f904777d3f28943c910d160fa5a1aa721b7618e89e9b`
BLAKE2b-256 checksum How to use checksums	`8f2eca42972479e7b355dece4627b8a052749d919b2eb04934a4377fe9c198f9`
Upload date	Oct 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/sinameraji/hotcell
Publishing commit: github.com/sinameraji/hotcell/tree/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/40064417434/attempts/1

Artifact

Subject: hotcell-0.1.29-py3-none-any.whl
SHA-256 checksum: a53acc35d768f76041e0f904777d3f28943c910d160fa5a1aa721b7618e89e9b Verifying attestations

Security for hotcell 0.1.29

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for hotcell-0.1.29.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/sinameraji/hotcell
Publishing commit: github.com/sinameraji/hotcell/tree/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/8d9bf537e7f32dacfcb1d99ec1831fa255cbcc7b/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/40064417434/attempts/1

Artifact

Subject: hotcell-0.1.29.tar.gz
SHA-256 checksum: 9ab429f0e5d05f0be1edba67084e570cc87e16ba68aed4c866ff208a63361555 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.