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.
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/CHANGELOG.md +166 -153
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/PKG-INFO +1 -1
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/pyproject.toml +90 -90
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_cli.py +29 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_remote.py +12 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/__init__.py +5 -5
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/vgpu.py +12 -2
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/remote.py +11 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/.gitignore +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/LICENSE +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/README.md +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/examples/deploy_standard_pod.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/__init__.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/conftest.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/ark-milan.pem +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/bundle.json +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/fixtures/manifest.json +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_cli.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_cli_account.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_client.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_config.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_hardening.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_live.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_models.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_package.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_ssh.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_attest.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_mcp.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/tests/test_vgpu_ttl.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/__main__.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/__init__.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_account.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_deploy.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_machines.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_misc.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/cmd_pods.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/main.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/output.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/cli/state.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/mcp/__init__.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/mcp/server.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/__init__.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/attest.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/catalog.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/client.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/config.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/errors.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/fleet.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/models.py +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/scripts/snp-proof-in-the-vm.sh +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/scripts/two-proofs-in-the-vm.sh +0 -0
- {voltagegpu_cli-2.0.0 → voltagegpu_cli-2.0.1}/volt/sdk/ssh.py +0 -0
- {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.
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
|
|
16
|
-
- `vgpu
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
- `voltagegpu
|
|
95
|
-
- `voltagegpu
|
|
96
|
-
|
|
97
|
-
- `voltagegpu
|
|
98
|
-
|
|
99
|
-
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
- `
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
- `
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
-
|
|
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
|
|
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
|