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.26

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.26
File	Size	Uploaded	Provenance
hotcell-0.1.26.tar.gz	13.5 kB	Oct 20, 2026	With provenance	Details

Built distribution (wheel)

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

Total release size: 26.7 kB

Release files / hotcell-0.1.26.tar.gz

Download URL	hotcell-0.1.26.tar.gz
Size	13.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`818b5ea6ba15be54dae9cd6352ed29c90d6b46bebb317c8e75f2ed9d4aa80a14`
BLAKE2b-256 checksum How to use checksums	`9ca734a8b22e3fc2328fcde47b899f728a288b0e0af5439b77577f0e8cc2572e`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/39473863938/attempts/1

Artifact

Subject: hotcell-0.1.26.tar.gz
SHA-256 checksum: 818b5ea6ba15be54dae9cd6352ed29c90d6b46bebb317c8e75f2ed9d4aa80a14 Verifying attestations

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

Download URL	hotcell-0.1.26-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fb538044e460b7b422eeba8c7784debac067255f7d99e20e4bc86764789178c7`
BLAKE2b-256 checksum How to use checksums	`50a0bd5b65f28000dc15ebefaad9bc1403880e7dd163ddc68b1d7bb9d9dd7657`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/sinameraji/hotcell
Publishing commit: github.com/sinameraji/hotcell/tree/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/39473863938/attempts/1

Artifact

Subject: hotcell-0.1.26-py3-none-any.whl
SHA-256 checksum: fb538044e460b7b422eeba8c7784debac067255f7d99e20e4bc86764789178c7 Verifying attestations

Security for hotcell 0.1.26

Report project as malware

Provenance

Full provenance

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

Attestation for hotcell-0.1.26.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/sinameraji/hotcell
Publishing commit: github.com/sinameraji/hotcell/tree/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc

Workflow

Publishing configuration: github.com/sinameraji/hotcell/blob/1febbf9c3b40b5e2ba6f76dda1dd0c6a49f2c1fc/.github/workflows/release.yml
Publishing logs: github.com/sinameraji/hotcell/actions/runs/39473863938/attempts/1

Artifact

Subject: hotcell-0.1.26.tar.gz
SHA-256 checksum: 818b5ea6ba15be54dae9cd6352ed29c90d6b46bebb317c8e75f2ed9d4aa80a14 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.