spore-host

Python SDK for spore.host — ephemeral EC2 compute for researchers.

pip install spore-host

Quick start

import spore

# Find instances
results = spore.truffle.find("amd epyc genoa", region="us-east-1")
for r in results:
    print(r.instance_type, f"${r.on_demand_price:.4f}/hr")

# Check Spot prices
prices = spore.truffle.spot("c8a.2xlarge", region="us-east-1")
cheapest = min(prices, key=lambda p: p.spot_price)

# Manage running instances
instances = spore.spawn.list()
inst = spore.spawn.status("sim-run-42")
inst.extend("2h")     # push the TTL deadline forward
inst.wait("terminated", on_status=lambda i: print(i.state))

Works in Jupyter notebooks, marimo, and plain Python scripts.

Documentation

Full documentation at docs.spore.host/guides/python-sdk

Requirements

Python 3.9+
AWS credentials configured (~/.aws/credentials or environment variables)
boto3, requests

Optional notebook extras: pip install "spore-host[jupyter]"

License

Apache 2.0 — see LICENSE

Metadata

Release files for spore-host 0.1.5

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

Source distribution (sdist)

Source distribution for spore-host 0.1.5
File	Size	Uploaded
spore_host-0.1.5.tar.gz	20.4 kB	Jul 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for spore-host 0.1.5
File	Interpreter	ABI	Platform	Reset
spore_host-0.1.5-py3-none-any.whl 14.7 kB Jul 10, 2026	Python 3	none	any	Details

Total release size: 35.1 kB

Release files / spore_host-0.1.5.tar.gz

Download URL	spore_host-0.1.5.tar.gz
Size	20.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`75368f86cb64f61de4699c32871df578a8106edb3fea829ad727a0a335bf7136`
BLAKE2b-256 checksum How to use checksums	`2089bb7b2aa63daa5d963d22a898a4c4c5a479d2ab78bb5a24e6e036a17dc90b`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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/spore-host/python-sdk
Publishing commit: github.com/spore-host/python-sdk/tree/d4097c223c601ef1b8f926df1ac3adbeaebb379d

Workflow

Publishing configuration: github.com/spore-host/python-sdk/blob/d4097c223c601ef1b8f926df1ac3adbeaebb379d/.github/workflows/publish-python.yaml
Publishing logs: github.com/spore-host/python-sdk/actions/runs/29129994861/attempts/1

Artifact

Subject: spore_host-0.1.5.tar.gz
SHA-256 checksum: 75368f86cb64f61de4699c32871df578a8106edb3fea829ad727a0a335bf7136 Verifying attestations

Release files / spore_host-0.1.5-py3-none-any.whl

Download URL	spore_host-0.1.5-py3-none-any.whl
Size	14.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d42c35988b9df12a1437f1b9e37a328e2e0eb9bf8b90a7b8a48f7a96a910d5a1`
BLAKE2b-256 checksum How to use checksums	`5d022568b901cc6823870b2a7bb5512d3da78393778aac7ea338cc4bc5a56496`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/spore-host/python-sdk
Publishing commit: github.com/spore-host/python-sdk/tree/d4097c223c601ef1b8f926df1ac3adbeaebb379d

Workflow

Publishing configuration: github.com/spore-host/python-sdk/blob/d4097c223c601ef1b8f926df1ac3adbeaebb379d/.github/workflows/publish-python.yaml
Publishing logs: github.com/spore-host/python-sdk/actions/runs/29129994861/attempts/1

Artifact

Subject: spore_host-0.1.5-py3-none-any.whl
SHA-256 checksum: d42c35988b9df12a1437f1b9e37a328e2e0eb9bf8b90a7b8a48f7a96a910d5a1 Verifying attestations