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.
Files changed (79) hide show
  1. {gipper-0.4.0 → gipper-0.4.1}/CHANGELOG.md +10 -0
  2. {gipper-0.4.0 → gipper-0.4.1}/PKG-INFO +11 -3
  3. {gipper-0.4.0 → gipper-0.4.1}/README.md +10 -2
  4. {gipper-0.4.0 → gipper-0.4.1}/docs/quickstart.md +15 -5
  5. {gipper-0.4.0 → gipper-0.4.1}/gipper/__init__.py +1 -1
  6. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/PKG-INFO +11 -3
  7. {gipper-0.4.0 → gipper-0.4.1}/pyproject.toml +1 -1
  8. {gipper-0.4.0 → gipper-0.4.1}/scripts/check_dist.py +6 -0
  9. {gipper-0.4.0 → gipper-0.4.1}/site/index.html +2 -2
  10. {gipper-0.4.0 → gipper-0.4.1}/uv.lock +1 -1
  11. {gipper-0.4.0 → gipper-0.4.1}/.env.example +0 -0
  12. {gipper-0.4.0 → gipper-0.4.1}/AGENTS.md +0 -0
  13. {gipper-0.4.0 → gipper-0.4.1}/CONTRIBUTING.md +0 -0
  14. {gipper-0.4.0 → gipper-0.4.1}/LICENSE +0 -0
  15. {gipper-0.4.0 → gipper-0.4.1}/MANIFEST.in +0 -0
  16. {gipper-0.4.0 → gipper-0.4.1}/RELEASING.md +0 -0
  17. {gipper-0.4.0 → gipper-0.4.1}/ROADMAP.md +0 -0
  18. {gipper-0.4.0 → gipper-0.4.1}/SECURITY.md +0 -0
  19. {gipper-0.4.0 → gipper-0.4.1}/artifact.toml +0 -0
  20. {gipper-0.4.0 → gipper-0.4.1}/deploy/gipper-reap.service +0 -0
  21. {gipper-0.4.0 → gipper-0.4.1}/deploy/gipper-reap.timer +0 -0
  22. {gipper-0.4.0 → gipper-0.4.1}/docs/clients.md +0 -0
  23. {gipper-0.4.0 → gipper-0.4.1}/docs/custody.md +0 -0
  24. {gipper-0.4.0 → gipper-0.4.1}/docs/lessons.md +0 -0
  25. {gipper-0.4.0 → gipper-0.4.1}/docs/placement.md +0 -0
  26. {gipper-0.4.0 → gipper-0.4.1}/docs/sources/vast/README.md +0 -0
  27. {gipper-0.4.0 → gipper-0.4.1}/examples/smoke/hello.txt +0 -0
  28. {gipper-0.4.0 → gipper-0.4.1}/examples/smoke.toml +0 -0
  29. {gipper-0.4.0 → gipper-0.4.1}/examples/udp-echo.toml +0 -0
  30. {gipper-0.4.0 → gipper-0.4.1}/gipper/billing.py +0 -0
  31. {gipper-0.4.0 → gipper-0.4.1}/gipper/bootstrap.sh +0 -0
  32. {gipper-0.4.0 → gipper-0.4.1}/gipper/cli.py +0 -0
  33. {gipper-0.4.0 → gipper-0.4.1}/gipper/config.py +0 -0
  34. {gipper-0.4.0 → gipper-0.4.1}/gipper/costs.py +0 -0
  35. {gipper-0.4.0 → gipper-0.4.1}/gipper/cuda_probe.py +0 -0
  36. {gipper-0.4.0 → gipper-0.4.1}/gipper/custody.py +0 -0
  37. {gipper-0.4.0 → gipper-0.4.1}/gipper/history.py +0 -0
  38. {gipper-0.4.0 → gipper-0.4.1}/gipper/http.py +0 -0
  39. {gipper-0.4.0 → gipper-0.4.1}/gipper/job.py +0 -0
  40. {gipper-0.4.0 → gipper-0.4.1}/gipper/latency.py +0 -0
  41. {gipper-0.4.0 → gipper-0.4.1}/gipper/ledger.py +0 -0
  42. {gipper-0.4.0 → gipper-0.4.1}/gipper/lifecycle.py +0 -0
  43. {gipper-0.4.0 → gipper-0.4.1}/gipper/market.py +0 -0
  44. {gipper-0.4.0 → gipper-0.4.1}/gipper/network_probe.py +0 -0
  45. {gipper-0.4.0 → gipper-0.4.1}/gipper/placement.py +0 -0
  46. {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/__init__.py +0 -0
  47. {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/runpod.py +0 -0
  48. {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/shadeform.py +0 -0
  49. {gipper-0.4.0 → gipper-0.4.1}/gipper/providers/vast.py +0 -0
  50. {gipper-0.4.0 → gipper-0.4.1}/gipper/reap.py +0 -0
  51. {gipper-0.4.0 → gipper-0.4.1}/gipper/run.py +0 -0
  52. {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/__init__.py +0 -0
  53. {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/api.py +0 -0
  54. {gipper-0.4.0 → gipper-0.4.1}/gipper/runpod/run.py +0 -0
  55. {gipper-0.4.0 → gipper-0.4.1}/gipper/ssh.py +0 -0
  56. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/SOURCES.txt +0 -0
  57. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/dependency_links.txt +0 -0
  58. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/entry_points.txt +0 -0
  59. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/requires.txt +0 -0
  60. {gipper-0.4.0 → gipper-0.4.1}/gipper.egg-info/top_level.txt +0 -0
  61. {gipper-0.4.0 → gipper-0.4.1}/scripts/build_site.py +0 -0
  62. {gipper-0.4.0 → gipper-0.4.1}/setup.cfg +0 -0
  63. {gipper-0.4.0 → gipper-0.4.1}/site/favicon.svg +0 -0
  64. {gipper-0.4.0 → gipper-0.4.1}/site/style.css +0 -0
  65. {gipper-0.4.0 → gipper-0.4.1}/tests/conftest.py +0 -0
  66. {gipper-0.4.0 → gipper-0.4.1}/tests/test_billing.py +0 -0
  67. {gipper-0.4.0 → gipper-0.4.1}/tests/test_compat.py +0 -0
  68. {gipper-0.4.0 → gipper-0.4.1}/tests/test_config.py +0 -0
  69. {gipper-0.4.0 → gipper-0.4.1}/tests/test_costs.py +0 -0
  70. {gipper-0.4.0 → gipper-0.4.1}/tests/test_cuda_probe.py +0 -0
  71. {gipper-0.4.0 → gipper-0.4.1}/tests/test_custody.py +0 -0
  72. {gipper-0.4.0 → gipper-0.4.1}/tests/test_history.py +0 -0
  73. {gipper-0.4.0 → gipper-0.4.1}/tests/test_job.py +0 -0
  74. {gipper-0.4.0 → gipper-0.4.1}/tests/test_latency.py +0 -0
  75. {gipper-0.4.0 → gipper-0.4.1}/tests/test_lifecycle.py +0 -0
  76. {gipper-0.4.0 → gipper-0.4.1}/tests/test_market.py +0 -0
  77. {gipper-0.4.0 → gipper-0.4.1}/tests/test_network_probe.py +0 -0
  78. {gipper-0.4.0 → gipper-0.4.1}/tests/test_providers.py +0 -0
  79. {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.0
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: 0.3.0, alpha.** Linux client, CLI and Python API, no daemon. Runpod and
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 from source (no PyPI release is assumed):
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: 0.3.0, alpha.** Linux client, CLI and Python API, no daemon. Runpod and
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 from source (no PyPI release is assumed):
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 from source
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
- Alternatively, use `pip install .` in a virtual environment. Install uv separately
17
- if using the uv commands. The Python runtime has no third-party dependencies.
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.0"
2
+ __version__ = "0.4.1"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gipper
3
- Version: 0.4.0
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: 0.3.0, alpha.** Linux client, CLI and Python API, no daemon. Runpod and
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 from source (no PyPI release is assumed):
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,6 +1,6 @@
1
1
  [project]
2
2
  name = "gipper"
3
- version = "0.4.0"
3
+ version = "0.4.1"
4
4
  description = "Run GPU jobs across cloud markets with cost estimates, verified teardown, and an append-only ledger"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -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 source, 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>git clone https://github.com/lavallee/gipper.git
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
@@ -13,7 +13,7 @@ wheels = [
13
13
 
14
14
  [[package]]
15
15
  name = "gipper"
16
- version = "0.4.0"
16
+ version = "0.4.1"
17
17
  source = { editable = "." }
18
18
 
19
19
  [package.optional-dependencies]
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