gipper 0.4.0__tar.gz → 0.4.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {gipper-0.4.0 → gipper-0.4.1}/CHANGELOG.md +10 -0
- {gipper-0.4.0 → gipper-0.4.1}/PKG-INFO +11 -3
- {gipper-0.4.0 → gipper-0.4.1}/README.md +10 -2
- {gipper-0.4.0 → gipper-0.4.1}/docs/quickstart.md +15 -5
- {gipper-0.4.0 → gipper-0.4.1}/gipper/__init__.py +1 -1
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/PKG-INFO +11 -3
- {gipper-0.4.0 → gipper-0.4.1}/pyproject.toml +1 -1
- {gipper-0.4.0 → gipper-0.4.1}/scripts/check_dist.py +6 -0
- {gipper-0.4.0 → gipper-0.4.1}/site/index.html +2 -2
- {gipper-0.4.0 → gipper-0.4.1}/uv.lock +1 -1
- {gipper-0.4.0 → gipper-0.4.1}/.env.example +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/AGENTS.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/CONTRIBUTING.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/LICENSE +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/MANIFEST.in +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/RELEASING.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/ROADMAP.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/SECURITY.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/artifact.toml +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/deploy/gipper-reap.service +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/deploy/gipper-reap.timer +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/docs/clients.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/docs/custody.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/docs/lessons.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/docs/placement.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/docs/sources/vast/README.md +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/examples/smoke/hello.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/examples/smoke.toml +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/examples/udp-echo.toml +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/billing.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/bootstrap.sh +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/cli.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/config.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/costs.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/cuda_probe.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/custody.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/history.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/http.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/job.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/latency.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/ledger.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/lifecycle.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/market.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/network_probe.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/placement.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/__init__.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/runpod.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/shadeform.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/vast.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/reap.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/run.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/__init__.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/api.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/run.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper/ssh.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/SOURCES.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/dependency_links.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/entry_points.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/requires.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/top_level.txt +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/scripts/build_site.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/setup.cfg +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/site/favicon.svg +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/site/style.css +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/conftest.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_billing.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_compat.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_config.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_costs.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_cuda_probe.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_custody.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_history.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_job.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_latency.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_lifecycle.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_market.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_network_probe.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_providers.py +0 -0
- {gipper-0.4.0 → gipper-0.4.1}/tests/test_reap.py +0 -0
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.4.1 (2026-11-05)
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- Remove a stale version from the README status and refresh the PyPI package
|
|
8
|
+
description with the verified package-index install instructions.
|
|
9
|
+
- Reject stale numeric README status versions during distribution validation.
|
|
10
|
+
Pages continues to derive its version from package metadata.
|
|
11
|
+
|
|
12
|
+
|
|
3
13
|
## 0.4.0 (2026-11-05)
|
|
4
14
|
|
|
5
15
|
A forensic trail of what reached each rented machine. When a provider reports an
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: gipper
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.1
|
|
4
4
|
Summary: Run GPU jobs across cloud markets with cost estimates, verified teardown, and an append-only ledger
|
|
5
5
|
Author: Marc Lavallee
|
|
6
6
|
License-Expression: MIT
|
|
@@ -42,7 +42,7 @@ fees, and host failures. An append-only local ledger records runs and costs;
|
|
|
42
42
|
future estimates learn from **your own** workloads and provider history. A fresh
|
|
43
43
|
installation starts with stated defaults, not someone else's rental history.
|
|
44
44
|
|
|
45
|
-
**Status:
|
|
45
|
+
**Status: alpha.** Linux client, CLI and Python API, no daemon. Runpod and
|
|
46
46
|
Vast have live-run validation; Shadeform is experimental and has not had a live
|
|
47
47
|
smoke test. See the [roadmap](ROADMAP.md) for planned features and
|
|
48
48
|
[SECURITY.md](SECURITY.md) for trust and billing limits. Licensed under [MIT](LICENSE).
|
|
@@ -54,7 +54,15 @@ gzip support. `ping` is optional for interactive placement. The Python runtime
|
|
|
54
54
|
has no third-party dependencies. Remote machines need a Linux shell, `tar`,
|
|
55
55
|
`timeout`, `curl`, and NVIDIA tools; the bootstrap installs `uv` if needed.
|
|
56
56
|
|
|
57
|
-
Install
|
|
57
|
+
Install the CLI from [PyPI](https://pypi.org/project/gipper/):
|
|
58
|
+
|
|
59
|
+
```sh
|
|
60
|
+
uv tool install gipper
|
|
61
|
+
gipper --help
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Alternatively, use `python -m pip install gipper` in a virtual environment.
|
|
65
|
+
To get the example jobs or install from source:
|
|
58
66
|
|
|
59
67
|
```sh
|
|
60
68
|
git clone https://github.com/lavallee/gipper.git
|
|
@@ -15,7 +15,7 @@ fees, and host failures. An append-only local ledger records runs and costs;
|
|
|
15
15
|
future estimates learn from **your own** workloads and provider history. A fresh
|
|
16
16
|
installation starts with stated defaults, not someone else's rental history.
|
|
17
17
|
|
|
18
|
-
**Status:
|
|
18
|
+
**Status: alpha.** Linux client, CLI and Python API, no daemon. Runpod and
|
|
19
19
|
Vast have live-run validation; Shadeform is experimental and has not had a live
|
|
20
20
|
smoke test. See the [roadmap](ROADMAP.md) for planned features and
|
|
21
21
|
[SECURITY.md](SECURITY.md) for trust and billing limits. Licensed under [MIT](LICENSE).
|
|
@@ -27,7 +27,15 @@ gzip support. `ping` is optional for interactive placement. The Python runtime
|
|
|
27
27
|
has no third-party dependencies. Remote machines need a Linux shell, `tar`,
|
|
28
28
|
`timeout`, `curl`, and NVIDIA tools; the bootstrap installs `uv` if needed.
|
|
29
29
|
|
|
30
|
-
Install
|
|
30
|
+
Install the CLI from [PyPI](https://pypi.org/project/gipper/):
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
uv tool install gipper
|
|
34
|
+
gipper --help
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Alternatively, use `python -m pip install gipper` in a virtual environment.
|
|
38
|
+
To get the example jobs or install from source:
|
|
31
39
|
|
|
32
40
|
```sh
|
|
33
41
|
git clone https://github.com/lavallee/gipper.git
|
|
@@ -4,17 +4,27 @@ Gipper needs a Linux client, Python 3.12+, OpenSSH, and tar with gzip support.
|
|
|
4
4
|
Provider accounts supply the GPUs; a missing API key disables that provider for
|
|
5
5
|
rentals. Your application and dependencies remain part of your job.
|
|
6
6
|
|
|
7
|
-
## Install
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
uv tool install gipper
|
|
11
|
+
gipper --help
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Alternatively, use `python -m pip install gipper` in a virtual environment.
|
|
15
|
+
Install uv separately if using the uv commands. The Python runtime has no
|
|
16
|
+
third-party dependencies.
|
|
17
|
+
|
|
18
|
+
This walkthrough uses the example files from the repository:
|
|
8
19
|
|
|
9
20
|
```sh
|
|
10
21
|
git clone https://github.com/lavallee/gipper.git
|
|
11
22
|
cd gipper
|
|
12
|
-
uv tool install .
|
|
13
|
-
gipper --help
|
|
14
23
|
```
|
|
15
24
|
|
|
16
|
-
|
|
17
|
-
|
|
25
|
+
For an installation from this source checkout, use `uv tool install .` instead
|
|
26
|
+
of the package-index command above. See [contributing](../CONTRIBUTING.md)
|
|
27
|
+
for development setup.
|
|
18
28
|
|
|
19
29
|
## Configure a provider
|
|
20
30
|
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
"""gipper: GPU jobs across cloud markets."""
|
|
2
|
-
__version__ = "0.4.
|
|
2
|
+
__version__ = "0.4.1"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: gipper
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.1
|
|
4
4
|
Summary: Run GPU jobs across cloud markets with cost estimates, verified teardown, and an append-only ledger
|
|
5
5
|
Author: Marc Lavallee
|
|
6
6
|
License-Expression: MIT
|
|
@@ -42,7 +42,7 @@ fees, and host failures. An append-only local ledger records runs and costs;
|
|
|
42
42
|
future estimates learn from **your own** workloads and provider history. A fresh
|
|
43
43
|
installation starts with stated defaults, not someone else's rental history.
|
|
44
44
|
|
|
45
|
-
**Status:
|
|
45
|
+
**Status: alpha.** Linux client, CLI and Python API, no daemon. Runpod and
|
|
46
46
|
Vast have live-run validation; Shadeform is experimental and has not had a live
|
|
47
47
|
smoke test. See the [roadmap](ROADMAP.md) for planned features and
|
|
48
48
|
[SECURITY.md](SECURITY.md) for trust and billing limits. Licensed under [MIT](LICENSE).
|
|
@@ -54,7 +54,15 @@ gzip support. `ping` is optional for interactive placement. The Python runtime
|
|
|
54
54
|
has no third-party dependencies. Remote machines need a Linux shell, `tar`,
|
|
55
55
|
`timeout`, `curl`, and NVIDIA tools; the bootstrap installs `uv` if needed.
|
|
56
56
|
|
|
57
|
-
Install
|
|
57
|
+
Install the CLI from [PyPI](https://pypi.org/project/gipper/):
|
|
58
|
+
|
|
59
|
+
```sh
|
|
60
|
+
uv tool install gipper
|
|
61
|
+
gipper --help
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Alternatively, use `python -m pip install gipper` in a virtual environment.
|
|
65
|
+
To get the example jobs or install from source:
|
|
58
66
|
|
|
59
67
|
```sh
|
|
60
68
|
git clone https://github.com/lavallee/gipper.git
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
"""Validate the built wheel and sdist, without installing runtime dependencies."""
|
|
2
2
|
import email
|
|
3
|
+
import re
|
|
3
4
|
import tarfile
|
|
4
5
|
import tomllib
|
|
5
6
|
import zipfile
|
|
@@ -16,6 +17,11 @@ with zipfile.ZipFile(wheel) as archive:
|
|
|
16
17
|
assert all(n.startswith(("gipper/", f"gipper-{version}.dist-info/")) for n in names)
|
|
17
18
|
metadata = email.message_from_bytes(archive.read(f"gipper-{version}.dist-info/METADATA"))
|
|
18
19
|
assert metadata["Version"] == version
|
|
20
|
+
# Package indexes display the README captured at build time. A stale status
|
|
21
|
+
# must fail before upload even when package metadata versions agree.
|
|
22
|
+
description = metadata.get_payload()
|
|
23
|
+
for declared in re.findall(r"\*\*Status:\s*(\d+\.\d+\.\d+)", description):
|
|
24
|
+
assert declared == version, f"README status {declared} disagrees with package {version}"
|
|
19
25
|
assert metadata["License-Expression"] == "MIT"
|
|
20
26
|
assert metadata["Requires-Python"] == project["requires-python"]
|
|
21
27
|
assert all("extra ==" in requirement for requirement in metadata.get_all("Requires-Dist", [])), "runtime dependency added"
|
|
@@ -33,9 +33,9 @@ max_hours = 1.0</code></pre><p>Upload code and collect outputs with <code>[[inpu
|
|
|
33
33
|
</section>
|
|
34
34
|
<section class="band" id="how"><div class="wrap"><h2>A rental has an end.</h2><ol class="lifecycle"><li><strong>Estimate</strong><span>Startup, setup, transfer, compute, fees.</span></li><li><strong>Check</strong><span>Rent, connect, verify GPU and CUDA.</span></li><li><strong>Run</strong><span>Execute, checkpoint, collect results.</span></li><li><strong>Close</strong><span>Terminate, verify absence, record spend.</span></li></ol><p>Cleanup runs after success or failure. Unconfirmed closure blocks a replacement; the independent reaper retries. Provider outages and a stopped client can still leave a rental billing. <a href="guides/security.html">Understand the limits.</a></p></div></section>
|
|
35
35
|
<section class="wrap section"><div class="section-intro"><h2>The hourly rate is only part of the price.</h2><p>Cheap hardware can be expensive to start, feed, or retry. Gipper estimates the whole run and shows where each assumption came from.</p></div><dl class="capabilities"><div><dt>Choose for the work</dt><dd>Filter memory, regions, CUDA requirements, and ports. Rank by cost, time, or latency, with your GPU preferences first.</dd></div><div><dt>Learn from your runs</dt><dd>Your local ledger builds compute-time, transfer-speed, billing, and host-reliability history. New installs start from stated defaults.</dd></div><div><dt>Keep the application yours</dt><dd>Install the libraries and models your job needs. Plain shell commands and TOML files work from the CLI or existing Python scripts.</dd></div></dl><a href="guides/placement.html">Read how placement works</a></section>
|
|
36
|
-
<section class="wrap section install" id="install"><div><h2>Start with an estimate.</h2><p>Install from
|
|
36
|
+
<section class="wrap section install" id="install"><div><h2>Start with an estimate.</h2><p>Install the CLI from PyPI, add a provider key to your local config, then inspect a bounded smoke job. Estimation and dry runs do not rent a machine.</p><p>Actual runs spend money. Keep the cleanup timer available and check the provider console when closure is uncertain.</p><a href="guides/quickstart.html">Configuration and first run</a></div><pre><code>uv tool install gipper
|
|
37
|
+
git clone https://github.com/lavallee/gipper.git
|
|
37
38
|
cd gipper
|
|
38
|
-
uv tool install .
|
|
39
39
|
|
|
40
40
|
gipper pod estimate examples/smoke.toml \
|
|
41
41
|
--provider vast
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|