@ukiyocompute/cli 0.0.0-stage → 0.3.1

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ukiyo Compute LLC
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,36 @@
1
- # Temporary Holding Version
1
+ # Ukiyo CLI 0.3.1
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Requires Node.js 24+. Install with `npm install -g @ukiyocompute/cli@0.3.1`.
4
+ Packages are staged for owner-approved publication; availability is not implied.
5
+
6
+ Read `https://pay.u-kiyo.ai/api/v1/terms` and its linked document, then explicitly
7
+ accept its current version. No browser, Telegram or owner token is required.
8
+
9
+ ```
10
+ ukiyo signup --accept-terms <current-version> --json
11
+ ukiyo balance --json
12
+ ukiyo topup rails --amount 5 --idempotency-key <stable-funding-key> --plain --json
13
+ ukiyo rent --gpu "RTX 4090" --idempotency-key <stable-rental-key> --wait --json
14
+ ukiyo rental <rental-id> --wait --json
15
+ ukiyo exec <deployment-id> --json -- nvidia-smi
16
+ ukiyo terminate <deployment-id> --yes --wait --json
17
+ ```
18
+
19
+ `--plain` produces an unpaid challenge only. Without it, funding uses the private
20
+ local `UKIYO_MACHINE_CONFIG` wallet and caps, shared with `machine buy`. Never
21
+ place a wallet key in a command or transcript. Use server paymentMethods URLs;
22
+ never invent recipients. A 202 settlementPending means **do not pay again**:
23
+ `ukiyo topup status --topup-id <id> --json`. Reuse the same funding key and amount
24
+ on retries. Hosted card funding remains `topup link --amount 5 --idempotency-key <key>`.
25
+
26
+ Ukiyo chooses the machine for GPU/count rentals. `--max-hourly-price` is optional;
27
+ no price ceiling is derived from inventory. Legacy prepaid accounts require
28
+ `--budget`; account-balance rentals do not. Retain rentalId and deploymentId even
29
+ on failure; timeouts do not authorize another rental. Retry the same intent/key.
30
+
31
+ Credentials are stored privately using the existing OS-specific storage controls.
32
+ Prefer exec to raw credentials reveal; never log tokens or PEM keys. Termination
33
+ requires explicit `--yes`; it is never automatic client cleanup.
34
+
35
+ Use `/venv/main/bin/python` for PyTorch. cuDNN is in its torch wheel, not a system
36
+ package; `python3` is not the image interpreter.