Metadata-Version: 2.4
Name: specter-host
Version: 0.2.2
Summary: Transparent remote GPU execution. Run `python train.py` on cloud GPUs.
Project-URL: Homepage, https://specter.host
Project-URL: Repository, https://github.com/specter-host/specter-cli
Project-URL: Issues, https://github.com/specter-host/specter-cli/issues
Author-email: Specter <team@specter.host>
License: MIT
License-File: LICENSE
Keywords: cloud,gpu,machine-learning,remote,ssh
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.11
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0
Provides-Extra: 3090
Provides-Extra: 4090
Provides-Extra: 5090
Provides-Extra: a100
Provides-Extra: a100-40
Provides-Extra: a10g
Provides-Extra: a6000
Provides-Extra: h100
Provides-Extra: l4
Provides-Extra: l40s
Provides-Extra: rtx-pro-6000
Provides-Extra: t4
Description-Content-Type: text/markdown

# specter-host

Remote GPUs, locally. Run `python train.py` on cloud GPUs as if they were local.

## Install

```bash
# Recommended (isolated install)
pipx install specter-host

# Or with pip
pip install specter-host
```

## Quick Start

```bash
# 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

1. `specter install h100` provisions a cloud GPU pod via the Specter broker
2. Your active venv is patched — `bin/python` becomes a transparent proxy
   - The original binary is backed up as `python.specter-original`
   - pip, pytest, and other entry points continue to run locally
3. 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
4. Dependencies stay in sync automatically:
   - At install time: `pip freeze` → remote `pip install`
   - After every `pip install`: auto-synced to the remote pod
5. `specter uninstall` restores your venv to its original state

## License

MIT
