voltagegpu-cli 2.0.0__tar.gz → 2.0.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 (53) hide show
  1. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/CHANGELOG.md +166 -153
  2. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/PKG-INFO +1 -1
  3. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/pyproject.toml +90 -90
  4. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_cli.py +29 -0
  5. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_remote.py +12 -0
  6. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/__init__.py +5 -5
  7. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/vgpu.py +12 -2
  8. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/remote.py +11 -0
  9. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/.gitignore +0 -0
  10. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/LICENSE +0 -0
  11. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/README.md +0 -0
  12. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/examples/deploy_standard_pod.py +0 -0
  13. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/__init__.py +0 -0
  14. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/conftest.py +0 -0
  15. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/ark-milan.pem +0 -0
  16. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/bundle.json +0 -0
  17. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/manifest.json +0 -0
  18. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_cli.py +0 -0
  19. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_cli_account.py +0 -0
  20. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_client.py +0 -0
  21. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_config.py +0 -0
  22. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_hardening.py +0 -0
  23. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_live.py +0 -0
  24. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_models.py +0 -0
  25. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_package.py +0 -0
  26. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_ssh.py +0 -0
  27. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_attest.py +0 -0
  28. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_mcp.py +0 -0
  29. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_ttl.py +0 -0
  30. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/__main__.py +0 -0
  31. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/__init__.py +0 -0
  32. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_account.py +0 -0
  33. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_deploy.py +0 -0
  34. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_machines.py +0 -0
  35. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_misc.py +0 -0
  36. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_pods.py +0 -0
  37. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/main.py +0 -0
  38. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/output.py +0 -0
  39. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/state.py +0 -0
  40. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/mcp/__init__.py +0 -0
  41. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/mcp/server.py +0 -0
  42. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/__init__.py +0 -0
  43. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/attest.py +0 -0
  44. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/catalog.py +0 -0
  45. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/client.py +0 -0
  46. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/config.py +0 -0
  47. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/errors.py +0 -0
  48. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/fleet.py +0 -0
  49. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/models.py +0 -0
  50. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/scripts/snp-proof-in-the-vm.sh +0 -0
  51. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/scripts/two-proofs-in-the-vm.sh +0 -0
  52. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/ssh.py +0 -0
  53. {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/ttl.py +0 -0
@@ -1,153 +1,166 @@
1
- # Changelog
2
-
3
- All notable changes to `voltagegpu-cli` are documented here. The format follows
4
- [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
5
- [Semantic Versioning](https://semver.org/).
6
-
7
- ## [2.0.0] - 2026-10-27
8
-
9
- ### Added
10
- - `vgpu`, a second command for scripts and AI agents: `ls`, `up`, `ps`,
11
- `exec` (with `-d`), `scp`, `rm`, `attest`, `whoami`. One catalogue for
12
- Confidential VMs (Intel TDX), Confidential CPU (AMD SEV-SNP), standard GPU
13
- pods, dedicated machines and sandboxes, cheapest first.
14
- - `--ttl` on every `vgpu up`, translated to the auto-stop of each product and
15
- checked against its bounds before anything is sent.
16
- - `vgpu attest`: challenge drawn locally, embedded proof scripts pinned by
17
- SHA-256, archive extracted safely and verified locally. For Confidential
18
- CPU the SEV-SNP report is requested at `--vmpl` (0 by default), and its VMPL
19
- field must be the level requested (VMPL 1 is no longer required: it was
20
- snpguest's default request, not the guest's level).
21
- - `vgpu mcp`, a local MCP server over stdio with the same tools and guards
22
- (`up` needs `ttl` and `max_hourly_price`, `rm` needs `confirm`), plus
23
- `inference` on the OpenAI-compatible API with a `vgpu_` key.
24
- - Documented exit codes, including 6 for HTTP 402 (`API_KEY_BUDGET_EXCEEDED`)
25
- and 4 for `API_KEY_SCOPE_MISSING`.
26
- - `vgpu up --ssh-key-id` (`ssh_key_ids` in `vgpu mcp`) on a standard GPU too:
27
- one key id, needed when the account has several SSH keys. Without it, the
28
- API's 400 becomes a clear message (exit 2, `SSH_KEY_ID_REQUIRED`).
29
-
30
- ### Changed
31
- - `voltagegpu balance` no longer shows `$0.00` when the key cannot read the
32
- balance (agent key without the billing scope): it says the balance is hidden.
33
- - A `vgpu_` inference key in `VOLTAGEGPU_API_KEY` is no longer taken for the
34
- pod API key; the next source (config file) is used.
35
- - `voltagegpu` and `volt` are otherwise unchanged. The major version marks the new
36
- command and its exit-code contract.
37
-
38
- ## [1.3.1] - 2026-10-10
39
-
40
- Security hardening after an independent review of 1.3.0. Upgrade recommended.
41
-
42
- ### Security
43
- - The SSH command returned by the API is only ever displayed in its validated,
44
- rebuilt form (`ssh -p PORT user@host`). A command of any other form is
45
- neither shown nor run, so a tampered answer cannot end up copied into a
46
- shell from `pods show`, `pods wait` or `deploy --wait`.
47
- - Server text (machine names, locations, error messages, ids) can no longer
48
- inject terminal escape sequences or rich markup: control characters are
49
- stripped and the text is printed literally. Before, an odd string could also
50
- crash the CLI right after a deploy.
51
- - `voltagegpu verify` calls voltage-verify in-process instead of
52
- `python -m voltage_verify`, which put the current directory first on the
53
- module path (a `voltage_verify.py` next to a downloaded bundle would run).
54
- - `voltagegpu ssh` looks for `ssh` on PATH only, never in the current
55
- directory (Windows `shutil.which` checks it first), and never runs a
56
- `.bat`/`.cmd` script.
57
- - The one-time sudo password of a Confidential VM is printed exactly as
58
- received (no markup or emoji parsing could alter it).
59
- - The API key is only sent to `voltagegpu.com` hosts (or localhost) unless
60
- `VOLT_ALLOW_CUSTOM_BASE_URL=1` is set.
61
- - A malformed `~/.volt/config.ini` no longer prints its content (which may be
62
- the key) in an error; an existing file is set to 0600 before the key is
63
- written.
64
-
65
- ### Changed
66
- - `deploy standard --cheapest --yes` requires `--max-price`, so a script never
67
- rents an expensive machine by surprise.
68
- - If the deploy request gets no answer, the CLI says the deploy may have gone
69
- through and to check `voltagegpu pods list`, instead of suggesting a retry.
70
- - A warning is printed if the hourly price rose between the listing and the
71
- deploy.
72
-
73
- ## [1.3.0] - 2026-10-10
74
-
75
- Realigns the CLI with the product as it is today: Confidential VMs (Intel TDX)
76
- and standard pods, both deployable from the public API. Every command was run
77
- against the production API before release, including a paid deploy, SSH and
78
- release of a standard pod.
79
-
80
- ### Added
81
- - `voltagegpu` command (the `volt` command still works, same program).
82
- - `voltagegpu machines [--standard | --confidential] [--gpu] [--max-price] [--min-gpus] [--json]`:
83
- standard machines and Confidential VM tiers with the hourly price charged.
84
- - `voltagegpu deploy standard --machine ID | --cheapest`: deploy a standard pod
85
- (no enclave), with `--template`, `--ssh-key`, `--jupyter`, `--ports`,
86
- `--auto-terminate`, `--wait`. Asks for confirmation before charging; scripts
87
- pass `--yes`.
88
- - `voltagegpu deploy confidential --tier TIER`: deploy a Confidential VM, with
89
- `--hardstop`, repeatable `--port 8000[/tcp|udp]` and `--wait`. Prints the
90
- one-time sudo password and the in-VM attestation commands.
91
- - `voltagegpu templates`: images available for standard pods.
92
- - `voltagegpu pods wait POD_ID`: wait until SSH is ready.
93
- - `voltagegpu ssh POD_ID [-- COMMAND]`: run ssh directly (or `--print` it).
94
- - `voltagegpu balance`: balance and running pods (`GET /api/volt/balance`).
95
- - `voltagegpu login` / `logout`: store the API key in `~/.volt/config.ini`,
96
- created with mode 0600, after checking that the API accepts it.
97
- - `voltagegpu verify ...`: verifies a Confidential VM attestation bundle by
98
- running voltage-verify (`pip install "voltagegpu-cli[verify]"`).
99
- - `VOLTAGEGPU_API_KEY` is accepted as an alias of `VOLT_API_KEY`.
100
- - SDK: `list_machines`, `list_templates`, `deploy_standard`,
101
- `deploy_confidential`, `release_pod`, `wait_until_reachable`, `get_balance`;
102
- typed immutable models; `parse_ssh_command`.
103
- - Test suite (unit, CLI and opt-in live checks) and a CI workflow.
104
-
105
- ### Changed
106
- - `pods stop` now releases the pod (`DELETE /api/volt/pods/:id`) and prints
107
- the refunded unused prepaid time. Standard pods cannot be paused, so the old
108
- `POST .../stop` call failed for them. `pods delete` and `pods get` remain as
109
- aliases of `pods stop` and `pods show`.
110
- - Errors show the API's own message (for example "Insufficient balance. One
111
- hour costs $0.59...") instead of a raw HTTP exception, and never a traceback
112
- unless `VOLT_DEBUG=1`.
113
- - Python 3.10 or newer is required (3.9 reached end of life in October 2025).
114
-
115
- ### Removed
116
- - `volt cc inventory`, `volt cc deploy` and `volt templates get`: Confidential
117
- containers were retired on 2026-10-01. The commands now print how to deploy a
118
- Confidential VM instead.
119
- - `volt account info`, which called an endpoint that does not exist.
120
-
121
- ### Fixed
122
- - `ssh-keys add` sent `publicKey`; the API expects `public_key`, so every key
123
- upload failed with HTTP 400. It also refuses a private key file now.
124
- - `account balance` called a dashboard-only endpoint and always failed with
125
- HTTP 401.
126
- - `cc inventory` called a dashboard-only endpoint and reported "no GPUs
127
- available" instead of an error.
128
- - Pod ids are validated before they are put into a URL path.
129
-
130
- ### Security
131
- - The SSH command returned by the API is parsed into user, host and port, each
132
- checked against a strict pattern, and ssh is started from a list of
133
- arguments, never through a shell. A tampered answer such as
134
- `ssh -o ProxyCommand=...` is refused.
135
- - Plain `http://` base URLs are refused (except localhost), redirects are never
136
- followed, and TLS certificates are always verified, so the API key cannot be
137
- sent in clear or to another host.
138
- - The API key is never printed (only `volt_****` and its last four
139
- characters), including in `repr()` of the configuration.
140
-
141
- ## [1.2.1] - 2026-04-11
142
-
143
- - Confidential container templates (`volt templates`), the machines list and
144
- `volt cc deploy --template`.
145
-
146
- ## [1.2.0] - 2026-04-11
147
-
148
- - `volt cc` command group for Confidential containers; default API base URL
149
- `https://api.voltagegpu.com/api`; JSON output on list commands.
150
-
151
- ## [1.1.0] and [1.0.0]
152
-
153
- - First releases of the CLI and Python SDK.
1
+ # Changelog
2
+
3
+ All notable changes to `voltagegpu-cli` are documented here. The format follows
4
+ [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
5
+ [Semantic Versioning](https://semver.org/).
6
+
7
+ ## [2.0.1] - 2026-10-27
8
+
9
+ Found by an end-to-end test of the agent offer in production.
10
+
11
+ ### Fixed
12
+ - `vgpu attest` names the NVIDIA GPU in its verdict when the GPU checks passed:
13
+ `VERIFIED: Intel TDX + NVIDIA GPU, challenge ...` (the JSON `tee` field is unchanged).
14
+ - `vgpu whoami` shows budgets and spend to the cent (it printed `0.18999999999999995`); `--json`
15
+ keeps the exact values.
16
+ - `vgpu scp` explains a Windows remote path: Git Bash rewrites an absolute remote path such as
17
+ `/tmp/out.tgz` into `C:/.../Temp/out.tgz`. Use a path relative to the remote home, or
18
+ `MSYS_NO_PATHCONV=1`.
19
+
20
+ ## [2.0.0] - 2026-10-27
21
+
22
+ ### Added
23
+ - `vgpu`, a second command for scripts and AI agents: `ls`, `up`, `ps`,
24
+ `exec` (with `-d`), `scp`, `rm`, `attest`, `whoami`. One catalogue for
25
+ Confidential VMs (Intel TDX), Confidential CPU (AMD SEV-SNP), standard GPU
26
+ pods, dedicated machines and sandboxes, cheapest first.
27
+ - `--ttl` on every `vgpu up`, translated to the auto-stop of each product and
28
+ checked against its bounds before anything is sent.
29
+ - `vgpu attest`: challenge drawn locally, embedded proof scripts pinned by
30
+ SHA-256, archive extracted safely and verified locally. For Confidential
31
+ CPU the SEV-SNP report is requested at `--vmpl` (0 by default), and its VMPL
32
+ field must be the level requested (VMPL 1 is no longer required: it was
33
+ snpguest's default request, not the guest's level).
34
+ - `vgpu mcp`, a local MCP server over stdio with the same tools and guards
35
+ (`up` needs `ttl` and `max_hourly_price`, `rm` needs `confirm`), plus
36
+ `inference` on the OpenAI-compatible API with a `vgpu_` key.
37
+ - Documented exit codes, including 6 for HTTP 402 (`API_KEY_BUDGET_EXCEEDED`)
38
+ and 4 for `API_KEY_SCOPE_MISSING`.
39
+ - `vgpu up --ssh-key-id` (`ssh_key_ids` in `vgpu mcp`) on a standard GPU too:
40
+ one key id, needed when the account has several SSH keys. Without it, the
41
+ API's 400 becomes a clear message (exit 2, `SSH_KEY_ID_REQUIRED`).
42
+
43
+ ### Changed
44
+ - `voltagegpu balance` no longer shows `$0.00` when the key cannot read the
45
+ balance (agent key without the billing scope): it says the balance is hidden.
46
+ - A `vgpu_` inference key in `VOLTAGEGPU_API_KEY` is no longer taken for the
47
+ pod API key; the next source (config file) is used.
48
+ - `voltagegpu` and `volt` are otherwise unchanged. The major version marks the new
49
+ command and its exit-code contract.
50
+
51
+ ## [1.3.1] - 2026-10-10
52
+
53
+ Security hardening after an independent review of 1.3.0. Upgrade recommended.
54
+
55
+ ### Security
56
+ - The SSH command returned by the API is only ever displayed in its validated,
57
+ rebuilt form (`ssh -p PORT user@host`). A command of any other form is
58
+ neither shown nor run, so a tampered answer cannot end up copied into a
59
+ shell from `pods show`, `pods wait` or `deploy --wait`.
60
+ - Server text (machine names, locations, error messages, ids) can no longer
61
+ inject terminal escape sequences or rich markup: control characters are
62
+ stripped and the text is printed literally. Before, an odd string could also
63
+ crash the CLI right after a deploy.
64
+ - `voltagegpu verify` calls voltage-verify in-process instead of
65
+ `python -m voltage_verify`, which put the current directory first on the
66
+ module path (a `voltage_verify.py` next to a downloaded bundle would run).
67
+ - `voltagegpu ssh` looks for `ssh` on PATH only, never in the current
68
+ directory (Windows `shutil.which` checks it first), and never runs a
69
+ `.bat`/`.cmd` script.
70
+ - The one-time sudo password of a Confidential VM is printed exactly as
71
+ received (no markup or emoji parsing could alter it).
72
+ - The API key is only sent to `voltagegpu.com` hosts (or localhost) unless
73
+ `VOLT_ALLOW_CUSTOM_BASE_URL=1` is set.
74
+ - A malformed `~/.volt/config.ini` no longer prints its content (which may be
75
+ the key) in an error; an existing file is set to 0600 before the key is
76
+ written.
77
+
78
+ ### Changed
79
+ - `deploy standard --cheapest --yes` requires `--max-price`, so a script never
80
+ rents an expensive machine by surprise.
81
+ - If the deploy request gets no answer, the CLI says the deploy may have gone
82
+ through and to check `voltagegpu pods list`, instead of suggesting a retry.
83
+ - A warning is printed if the hourly price rose between the listing and the
84
+ deploy.
85
+
86
+ ## [1.3.0] - 2026-10-10
87
+
88
+ Realigns the CLI with the product as it is today: Confidential VMs (Intel TDX)
89
+ and standard pods, both deployable from the public API. Every command was run
90
+ against the production API before release, including a paid deploy, SSH and
91
+ release of a standard pod.
92
+
93
+ ### Added
94
+ - `voltagegpu` command (the `volt` command still works, same program).
95
+ - `voltagegpu machines [--standard | --confidential] [--gpu] [--max-price] [--min-gpus] [--json]`:
96
+ standard machines and Confidential VM tiers with the hourly price charged.
97
+ - `voltagegpu deploy standard --machine ID | --cheapest`: deploy a standard pod
98
+ (no enclave), with `--template`, `--ssh-key`, `--jupyter`, `--ports`,
99
+ `--auto-terminate`, `--wait`. Asks for confirmation before charging; scripts
100
+ pass `--yes`.
101
+ - `voltagegpu deploy confidential --tier TIER`: deploy a Confidential VM, with
102
+ `--hardstop`, repeatable `--port 8000[/tcp|udp]` and `--wait`. Prints the
103
+ one-time sudo password and the in-VM attestation commands.
104
+ - `voltagegpu templates`: images available for standard pods.
105
+ - `voltagegpu pods wait POD_ID`: wait until SSH is ready.
106
+ - `voltagegpu ssh POD_ID [-- COMMAND]`: run ssh directly (or `--print` it).
107
+ - `voltagegpu balance`: balance and running pods (`GET /api/volt/balance`).
108
+ - `voltagegpu login` / `logout`: store the API key in `~/.volt/config.ini`,
109
+ created with mode 0600, after checking that the API accepts it.
110
+ - `voltagegpu verify ...`: verifies a Confidential VM attestation bundle by
111
+ running voltage-verify (`pip install "voltagegpu-cli[verify]"`).
112
+ - `VOLTAGEGPU_API_KEY` is accepted as an alias of `VOLT_API_KEY`.
113
+ - SDK: `list_machines`, `list_templates`, `deploy_standard`,
114
+ `deploy_confidential`, `release_pod`, `wait_until_reachable`, `get_balance`;
115
+ typed immutable models; `parse_ssh_command`.
116
+ - Test suite (unit, CLI and opt-in live checks) and a CI workflow.
117
+
118
+ ### Changed
119
+ - `pods stop` now releases the pod (`DELETE /api/volt/pods/:id`) and prints
120
+ the refunded unused prepaid time. Standard pods cannot be paused, so the old
121
+ `POST .../stop` call failed for them. `pods delete` and `pods get` remain as
122
+ aliases of `pods stop` and `pods show`.
123
+ - Errors show the API's own message (for example "Insufficient balance. One
124
+ hour costs $0.59...") instead of a raw HTTP exception, and never a traceback
125
+ unless `VOLT_DEBUG=1`.
126
+ - Python 3.10 or newer is required (3.9 reached end of life in October 2025).
127
+
128
+ ### Removed
129
+ - `volt cc inventory`, `volt cc deploy` and `volt templates get`: Confidential
130
+ containers were retired on 2026-10-01. The commands now print how to deploy a
131
+ Confidential VM instead.
132
+ - `volt account info`, which called an endpoint that does not exist.
133
+
134
+ ### Fixed
135
+ - `ssh-keys add` sent `publicKey`; the API expects `public_key`, so every key
136
+ upload failed with HTTP 400. It also refuses a private key file now.
137
+ - `account balance` called a dashboard-only endpoint and always failed with
138
+ HTTP 401.
139
+ - `cc inventory` called a dashboard-only endpoint and reported "no GPUs
140
+ available" instead of an error.
141
+ - Pod ids are validated before they are put into a URL path.
142
+
143
+ ### Security
144
+ - The SSH command returned by the API is parsed into user, host and port, each
145
+ checked against a strict pattern, and ssh is started from a list of
146
+ arguments, never through a shell. A tampered answer such as
147
+ `ssh -o ProxyCommand=...` is refused.
148
+ - Plain `http://` base URLs are refused (except localhost), redirects are never
149
+ followed, and TLS certificates are always verified, so the API key cannot be
150
+ sent in clear or to another host.
151
+ - The API key is never printed (only `volt_****` and its last four
152
+ characters), including in `repr()` of the configuration.
153
+
154
+ ## [1.2.1] - 2026-04-11
155
+
156
+ - Confidential container templates (`volt templates`), the machines list and
157
+ `volt cc deploy --template`.
158
+
159
+ ## [1.2.0] - 2026-04-11
160
+
161
+ - `volt cc` command group for Confidential containers; default API base URL
162
+ `https://api.voltagegpu.com/api`; JSON output on list commands.
163
+
164
+ ## [1.1.0] and [1.0.0]
165
+
166
+ - First releases of the CLI and Python SDK.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: voltagegpu-cli
3
- Version: 2.0.0
3
+ Version: 2.0.1
4
4
  Summary: VoltageGPU CLI and Python SDK: Confidential VMs (Intel TDX), Confidential CPU (AMD SEV-SNP), standard GPU pods, dedicated machines and sandboxes, with the vgpu command for scripts and AI agents.
5
5
  Project-URL: Homepage, https://voltagegpu.com
6
6
  Project-URL: Documentation, https://docs.voltagegpu.com/cli
@@ -1,90 +1,90 @@
1
- [build-system]
2
- requires = ["hatchling>=1.25"]
3
- build-backend = "hatchling.build"
4
-
5
- [project]
6
- name = "voltagegpu-cli"
7
- version = "2.0.0"
8
- description = "VoltageGPU CLI and Python SDK: Confidential VMs (Intel TDX), Confidential CPU (AMD SEV-SNP), standard GPU pods, dedicated machines and sandboxes, with the vgpu command for scripts and AI agents."
9
- readme = "README.md"
10
- requires-python = ">=3.10"
11
- license = { file = "LICENSE" }
12
- authors = [{ name = "VoltageGPU (VOLTAGE EI)", email = "contact@voltagegpu.com" }]
13
- keywords = [
14
- "gpu",
15
- "confidential-computing",
16
- "intel-tdx",
17
- "attestation",
18
- "cli",
19
- "sdk",
20
- "ssh",
21
- "pytorch",
22
- "voltagegpu",
23
- ]
24
- classifiers = [
25
- "Development Status :: 5 - Production/Stable",
26
- "Environment :: Console",
27
- "Intended Audience :: Developers",
28
- "Intended Audience :: Science/Research",
29
- "License :: OSI Approved :: MIT License",
30
- "Operating System :: OS Independent",
31
- "Programming Language :: Python :: 3",
32
- "Programming Language :: Python :: 3 :: Only",
33
- "Programming Language :: Python :: 3.10",
34
- "Programming Language :: Python :: 3.11",
35
- "Programming Language :: Python :: 3.12",
36
- "Programming Language :: Python :: 3.13",
37
- "Programming Language :: Python :: 3.14",
38
- "Topic :: Scientific/Engineering :: Artificial Intelligence",
39
- "Topic :: Security",
40
- "Topic :: System :: Systems Administration",
41
- ]
42
- dependencies = [
43
- "click>=8.1",
44
- "httpx>=0.27,<1",
45
- "rich>=13.0",
46
- ]
47
-
48
- [project.optional-dependencies]
49
- verify = ["voltage-verify>=0.2.1"]
50
- dev = ["pytest>=8", "pytest-cov>=5", "ruff>=0.6", "build>=1.2", "twine>=5"]
51
-
52
- [project.scripts]
53
- voltagegpu = "volt.cli.main:main"
54
- volt = "volt.cli.main:main"
55
- vgpu = "volt.cli.vgpu:main"
56
-
57
- [project.urls]
58
- Homepage = "https://voltagegpu.com"
59
- Documentation = "https://docs.voltagegpu.com/cli"
60
- "API reference" = "https://docs.voltagegpu.com/api-reference"
61
- Source = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/tree/release/1.3"
62
- Changelog = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/blob/release/1.3/CHANGELOG.md"
63
- Issues = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/issues"
64
-
65
- [tool.hatch.build.targets.wheel]
66
- packages = ["volt"]
67
-
68
- [tool.hatch.build.targets.sdist]
69
- include = ["/volt", "/tests", "/examples", "/README.md", "/CHANGELOG.md", "/LICENSE", "/pyproject.toml"]
70
- exclude = ["__pycache__", "*.pyc"]
71
-
72
- [tool.pytest.ini_options]
73
- testpaths = ["tests"]
74
- addopts = "-q"
75
- markers = ["live: hits the production API with VOLT_API_KEY (skipped unless VOLT_LIVE=1)"]
76
-
77
- [tool.ruff]
78
- line-length = 145
79
- target-version = "py310"
80
-
81
- [tool.ruff.lint]
82
- select = ["E", "F", "I", "B", "S", "W"]
83
- ignore = ["S101"]
84
-
85
- [tool.ruff.lint.per-file-ignores]
86
- "tests/*" = ["S", "B"]
87
-
88
- [tool.coverage.run]
89
- source = ["volt"]
90
- branch = true
1
+ [build-system]
2
+ requires = ["hatchling>=1.25"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "voltagegpu-cli"
7
+ version = "2.0.1"
8
+ description = "VoltageGPU CLI and Python SDK: Confidential VMs (Intel TDX), Confidential CPU (AMD SEV-SNP), standard GPU pods, dedicated machines and sandboxes, with the vgpu command for scripts and AI agents."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = { file = "LICENSE" }
12
+ authors = [{ name = "VoltageGPU (VOLTAGE EI)", email = "contact@voltagegpu.com" }]
13
+ keywords = [
14
+ "gpu",
15
+ "confidential-computing",
16
+ "intel-tdx",
17
+ "attestation",
18
+ "cli",
19
+ "sdk",
20
+ "ssh",
21
+ "pytorch",
22
+ "voltagegpu",
23
+ ]
24
+ classifiers = [
25
+ "Development Status :: 5 - Production/Stable",
26
+ "Environment :: Console",
27
+ "Intended Audience :: Developers",
28
+ "Intended Audience :: Science/Research",
29
+ "License :: OSI Approved :: MIT License",
30
+ "Operating System :: OS Independent",
31
+ "Programming Language :: Python :: 3",
32
+ "Programming Language :: Python :: 3 :: Only",
33
+ "Programming Language :: Python :: 3.10",
34
+ "Programming Language :: Python :: 3.11",
35
+ "Programming Language :: Python :: 3.12",
36
+ "Programming Language :: Python :: 3.13",
37
+ "Programming Language :: Python :: 3.14",
38
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
39
+ "Topic :: Security",
40
+ "Topic :: System :: Systems Administration",
41
+ ]
42
+ dependencies = [
43
+ "click>=8.1",
44
+ "httpx>=0.27,<1",
45
+ "rich>=13.0",
46
+ ]
47
+
48
+ [project.optional-dependencies]
49
+ verify = ["voltage-verify>=0.2.1"]
50
+ dev = ["pytest>=8", "pytest-cov>=5", "ruff>=0.6", "build>=1.2", "twine>=5"]
51
+
52
+ [project.scripts]
53
+ voltagegpu = "volt.cli.main:main"
54
+ volt = "volt.cli.main:main"
55
+ vgpu = "volt.cli.vgpu:main"
56
+
57
+ [project.urls]
58
+ Homepage = "https://voltagegpu.com"
59
+ Documentation = "https://docs.voltagegpu.com/cli"
60
+ "API reference" = "https://docs.voltagegpu.com/api-reference"
61
+ Source = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/tree/release/1.3"
62
+ Changelog = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/blob/release/1.3/CHANGELOG.md"
63
+ Issues = "https://github.com/VoltageGPU/VOLTAGEGPU-CLI/issues"
64
+
65
+ [tool.hatch.build.targets.wheel]
66
+ packages = ["volt"]
67
+
68
+ [tool.hatch.build.targets.sdist]
69
+ include = ["/volt", "/tests", "/examples", "/README.md", "/CHANGELOG.md", "/LICENSE", "/pyproject.toml"]
70
+ exclude = ["__pycache__", "*.pyc"]
71
+
72
+ [tool.pytest.ini_options]
73
+ testpaths = ["tests"]
74
+ addopts = "-q"
75
+ markers = ["live: hits the production API with VOLT_API_KEY (skipped unless VOLT_LIVE=1)"]
76
+
77
+ [tool.ruff]
78
+ line-length = 145
79
+ target-version = "py310"
80
+
81
+ [tool.ruff.lint]
82
+ select = ["E", "F", "I", "B", "S", "W"]
83
+ ignore = ["S101"]
84
+
85
+ [tool.ruff.lint.per-file-ignores]
86
+ "tests/*" = ["S", "B"]
87
+
88
+ [tool.coverage.run]
89
+ source = ["volt"]
90
+ branch = true
@@ -463,3 +463,32 @@ def test_whoami_with_hidden_balance(api, capsys) -> None:
463
463
  assert code == 0 and data["balance"] is None and data["balance_hidden"].startswith("This agent key")
464
464
  code, out, _ = run(capsys, "whoami")
465
465
  assert code == 0 and "hidden" in out
466
+
467
+
468
+ # ------------------------------------------------------------------ 2.0.1 (end-to-end agent test of 27/10/2026)
469
+
470
+
471
+ def test_whoami_rounds_spend_to_cents_for_humans(api, capsys) -> None:
472
+ api.on("GET", "/api/volt/whoami", body={"success": True, "key": {"name": "agent", "scopes": ["read"], "budgets_usd": {"daily": 20},
473
+ "spent_usd": {"daily": 0.18999999999999995, "monthly": None}},
474
+ "balance": None, "balance_hidden": "hidden"})
475
+ code, out, _ = run(capsys, "whoami")
476
+ assert code == 0 and '"daily": 0.19' in out and "0.18999" not in out
477
+ code, out, _ = run(capsys, "whoami", "--json")
478
+ assert json.loads(out)["key"]["spent_usd"]["daily"] == 0.18999999999999995
479
+
480
+
481
+ def test_attest_human_output_names_the_gpu_when_its_checks_passed(api, capsys, monkeypatch) -> None:
482
+ data = {"name": "job1", "id": "wrk-1", "verified": True, "status": "VERIFIED", "tee": "Intel TDX", "challenge": "ab" * 32,
483
+ "failed": [], "checks": [{"name": "tdx.signature", "ok": True}, {"name": "nvidia.policy", "ok": True}]}
484
+ monkeypatch.setattr(vgpu_mod, "attest_machine", lambda client, ref, **kwargs: (data, 0))
485
+ code, out, _ = run(capsys, "attest", "job1")
486
+ assert code == 0 and out.startswith("VERIFIED: Intel TDX + NVIDIA GPU, challenge")
487
+
488
+
489
+ def test_attest_human_output_keeps_the_tee_alone_without_gpu_checks(api, capsys, monkeypatch) -> None:
490
+ data = {"name": "c1", "id": "wrk-2", "verified": True, "status": "VERIFIED", "tee": "AMD SEV-SNP", "challenge": "ab" * 64,
491
+ "failed": [], "checks": [{"name": "snp.report", "ok": True}]}
492
+ monkeypatch.setattr(vgpu_mod, "attest_machine", lambda client, ref, **kwargs: (data, 0))
493
+ code, out, _ = run(capsys, "attest", "c1")
494
+ assert code == 0 and out.startswith("VERIFIED: AMD SEV-SNP, challenge") and "NVIDIA" not in out
@@ -63,3 +63,15 @@ def test_remote_path_refused(path: str) -> None:
63
63
  def test_local_path_starting_with_dash_refused(tmp_path: Path) -> None:
64
64
  with pytest.raises(RemotePathError):
65
65
  scp_argv(TARGET, "p", "/tmp/a", "-oProxyCommand=x", home=tmp_path, scp_bin="scp")
66
+
67
+
68
+ def test_windows_path_rewritten_by_git_bash_gets_a_clear_hint(monkeypatch) -> None:
69
+ # 27/10/2026: Git Bash turned "/tmp/aller.txt" into "C:/Users/.../Temp/aller.txt" before vgpu saw it.
70
+ monkeypatch.setenv("MSYSTEM", "MINGW64")
71
+ with pytest.raises(RemotePathError) as exc:
72
+ validate_remote_path("C:/Users/User/AppData/Local/Temp/aller.txt")
73
+ assert "Git Bash" in str(exc.value) and "MSYS_NO_PATHCONV=1" in str(exc.value) and "relative" in str(exc.value)
74
+
75
+
76
+ def test_relative_remote_path_is_accepted() -> None:
77
+ assert validate_remote_path("out.tgz") == "out.tgz"
@@ -1,5 +1,5 @@
1
- """VoltageGPU command-line interface and Python SDK."""
2
-
3
- __version__ = "2.0.0"
4
-
5
- __all__ = ["__version__"]
1
+ """VoltageGPU command-line interface and Python SDK."""
2
+
3
+ __version__ = "2.0.1"
4
+
5
+ __all__ = ["__version__"]
@@ -97,6 +97,13 @@ def ssh_key_needed(exc: ApiError, kind: str, given: bool, how: str) -> Optional[
97
97
  "`voltagegpu ssh-keys list`). Nothing was charged.", "SSH_KEY_ID_REQUIRED", {"http_status": 400})
98
98
 
99
99
 
100
+ def _cents(values: Any) -> Any:
101
+ """Budgets and spend shown to a human, to the cent (a float sum prints 0.18999999999999995)."""
102
+ if not isinstance(values, Mapping):
103
+ return values
104
+ return {k: round(v, 2) if isinstance(v, (int, float)) and not isinstance(v, bool) else v for k, v in values.items()}
105
+
106
+
100
107
  def _emit(as_json: bool, data: Any, human: str) -> None:
101
108
  click.echo(json.dumps(data, indent=2, default=str) if as_json else human)
102
109
 
@@ -384,7 +391,10 @@ def attest_cmd(ctx: click.Context, ref: str, offline: bool, out: Optional[str],
384
391
  """Prove the machine is a genuine TEE: challenge drawn here, proofs made in the VM, checked here."""
385
392
  data, code = attest_machine(_state(ctx).client(), ref, out=out, offline=offline, identity=identity, vmpl=vmpl)
386
393
  failed = data.get("failed") or []
387
- human = f"{data['status']}: {data['tee']}, challenge {data['challenge'][:16]}..." + (f" failed: {', '.join(failed)}" if failed else "")
394
+ # 2.0.1: a VM verdict covers the NVIDIA GPU too; say so when its checks passed.
395
+ gpu_checked = any(str(c.get("name", "")).startswith("nvidia.") and c.get("ok") for c in data.get("checks") or [])
396
+ tee = f"{data['tee']} + NVIDIA GPU" if data.get("verified") and gpu_checked else data["tee"]
397
+ human = f"{data['status']}: {tee}, challenge {data['challenge'][:16]}..." + (f" failed: {', '.join(failed)}" if failed else "")
388
398
  if data.get("detail"):
389
399
  human += f" ({data['detail']})"
390
400
  if (data.get("facts") or {}).get("vmpl_fallback"):
@@ -415,7 +425,7 @@ def whoami_cmd(ctx: click.Context, as_json: bool) -> None:
415
425
  lines: List[str] = [f"key {data['key']['masked']} {key.get('name') or ''}".rstrip(),
416
426
  f"scopes {', '.join(key.get('scopes') or []) or 'full access'}",
417
427
  f"machines {key.get('pod_visibility') or 'account'}",
418
- f"budgets {json.dumps(key.get('budgets_usd') or {})} spent {json.dumps(key.get('spent_usd') or {})}",
428
+ f"budgets {json.dumps(_cents(key.get('budgets_usd') or {}))} spent {json.dumps(_cents(key.get('spent_usd') or {}))}",
419
429
  f"balance {data['balance']} {data['currency']}" if data["balance"] is not None
420
430
  else f"balance hidden ({data['balance_hidden']})"]
421
431
  _emit(as_json, data, "\n".join(lines))
@@ -13,6 +13,7 @@ are reused by other machines after a release.
13
13
 
14
14
  from __future__ import annotations
15
15
 
16
+ import os
16
17
  import re
17
18
  import shlex
18
19
  from pathlib import Path
@@ -48,7 +49,17 @@ def ssh_options(pod_id: str, home: Optional[Path] = None) -> List[str]:
48
49
  ]
49
50
 
50
51
 
52
+ _WINDOWS_PATH_RE = re.compile(r"^[A-Za-z]:[\/]")
53
+
54
+
51
55
  def validate_remote_path(path: str) -> str:
56
+ if path and _WINDOWS_PATH_RE.match(path):
57
+ # Git Bash (MSYS) rewrites an absolute remote path such as /tmp/out.tgz into C:/.../Temp/out.tgz.
58
+ hint = "Git Bash rewrote an absolute remote path into a Windows one; " if os.environ.get("MSYSTEM") else ""
59
+ raise RemotePathError(
60
+ f"Refusing remote path {path!r}: it is a Windows path. {hint}"
61
+ "Use a path relative to the remote home (out.tgz), or run with MSYS_NO_PATHCONV=1."
62
+ )
52
63
  if not path or path.startswith("-") or not _REMOTE_PATH_RE.fullmatch(path):
53
64
  raise RemotePathError(
54
65
  f"Refusing remote path {path!r}: use letters, digits and ./_~-+@=,% only (no spaces or shell characters)."
File without changes
File without changes