specter-host
Remote GPUs, locally. Run python train.py on cloud GPUs as if they were local.
Install
# Recommended (isolated install)
pipx install specter-host
# Or with pip
pip install specter-host
Quick Start
# Create and activate a virtual environment
python -m venv .venv && source .venv/bin/activate
# Authenticate via browser
specter login
# Provision a GPU — patches your active venv
specter install h100
# Run Python as usual — it transparently executes on the remote GPU
python train.py
# pip install works locally AND syncs to the remote automatically
pip install transformers
# When done, tear down the pod and restore your venv
specter uninstall
How It Works
specter install h100provisions a cloud GPU pod via the Specter broker- Your active venv is patched —
bin/pythonbecomes a transparent proxy- The original binary is backed up as
python.specter-original - pip, pytest, and other entry points continue to run locally
- The original binary is backed up as
- When you run
python train.py, Specter:- Rsyncs your workspace to the remote machine
- Executes the command via SSH
- Streams stdout/stderr back in real-time
- Returns the remote exit code
- Dependencies stay in sync automatically:
- At install time:
pip freeze→ remotepip install - After every
pip install: auto-synced to the remote pod
- At install time:
specter uninstallrestores your venv to its original state
License
MIT
1 maintainer
Release files for specter-host 0.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| specter_host-0.2.6.tar.gz | 87.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| specter_host-0.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 128.6 kB
Release files / specter_host-0.2.6.tar.gz
| Download URL | specter_host-0.2.6.tar.gz |
|---|---|
| Size | 87.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
522d0e776d6cb8135fd8182242f099851fb790c9683d810afc07267802843117
|
|
BLAKE2b-256 checksum How to use checksums |
4cd6d4c7770bcd6b6cae5ffa3cdcd043a5ea35aba7f44276600789c44cd43d28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 10, 2026.
Transparency logRelease files / specter_host-0.2.6-py3-none-any.whl
| Download URL | specter_host-0.2.6-py3-none-any.whl |
|---|---|
| Size | 40.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a3c6e6948c42ecf93ffbb4bb1faa49388035ffcf175fba016074354535089532
|
|
BLAKE2b-256 checksum How to use checksums |
b366219666a8d3ec01fcf9195de2babb7bb3d7e95c13ec50b169b42f7156725c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 10, 2026.
Transparency log
