HarutoMode commited on
Commit
d52eb98
·
verified ·
1 Parent(s): 4ae940e

Mirror ukiyo-cli from GitHub

Browse files

Source: https://github.com/ukiyocompute/ukiyo-cli

Files changed (3) hide show
  1. LICENSE +21 -0
  2. README.md +92 -5
  3. index.html +1 -19
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.
README.md CHANGED
@@ -1,10 +1,97 @@
1
  ---
2
- title: Ukiyo Cli
3
- emoji: ⚡
4
- colorFrom: pink
5
- colorTo: purple
6
  sdk: static
7
  pinned: false
 
 
8
  ---
9
 
10
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: ukiyo-cli
3
+ emoji: 💻
4
+ colorFrom: blue
5
+ colorTo: indigo
6
  sdk: static
7
  pinned: false
8
+ license: mit
9
+ short_description: "Ukiyo CLI: rent GPUs from your terminal or AI agent"
10
  ---
11
 
12
+ # Ukiyo CLI
13
+
14
+ > Source, issues and releases: **[github.com/ukiyocompute/ukiyo-cli](https://github.com/ukiyocompute/ukiyo-cli)**
15
+
16
+ Rent a dedicated GPU from your terminal, or let your AI agent do it. Pick a GPU, fund your balance once, and connect over SSH in about a minute.
17
+
18
+ **Current version: 0.2.5** · [Docs](https://docs.u-kiyo.ai/connect/cli) · [Website](https://u-kiyo.ai) · [Live GPU prices](https://u-kiyo.ai/gpu/)
19
+
20
+ ## Install
21
+
22
+ Requires [Node.js 22+](https://nodejs.org). The installers download the release, check its SHA-256 and stop if it doesn't match.
23
+
24
+ **macOS / Linux / WSL**
25
+
26
+ ```bash
27
+ curl -fsSL https://u-kiyo.ai/releases/cli/0.2.5/install.sh | sh
28
+ ```
29
+
30
+ **Windows (PowerShell)**: downloads the installer, checks its SHA-256, then runs it.
31
+
32
+ ```powershell
33
+ $release = Invoke-RestMethod https://u-kiyo.ai/releases/latest.json
34
+ $installer = $release.tools.cli.files | Where-Object { $_.path -eq 'cli/0.2.5/install.ps1' }
35
+ $path = Join-Path $env:TEMP 'ukiyo-install-0.2.5.ps1'
36
+ Invoke-WebRequest -UseBasicParsing $installer.url -OutFile $path
37
+ if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash.ToLowerInvariant() -ne $installer.sha256) { throw 'Checksum mismatch; stop here.' }
38
+ powershell.exe -NoProfile -ExecutionPolicy Bypass -File $path
39
+ ```
40
+
41
+ Add `~/.local/bin` (macOS/Linux) to your `PATH` if asked, open a new terminal and run `ukiyo --version`. Prefer to verify every step by hand? See [INSTALL.md](https://github.com/ukiyocompute/ukiyo-cli/blob/main/INSTALL.md).
42
+
43
+ ## Quick start
44
+
45
+ ```bash
46
+ ukiyo signup --accept-terms 2026-10-10 --json # new account; read https://u-kiyo.ai/terms/ first
47
+ ukiyo topup link --amount 5 --json # open the link to add credit (once, by a person)
48
+ ukiyo offers --json # live GPUs and prices
49
+ ukiyo rent --gpu RTX4090 --count 1 --wait --json
50
+ ukiyo exec <deployment-id> -- nvidia-smi # run a command over SSH
51
+ ukiyo terminate <deployment-id> --json # stop paying
52
+ ```
53
+
54
+ - `signup` creates a new account and stores a scoped agent key on your machine. No email or browser needed.
55
+ - Account-balance rentals don't need `--budget`; they stop automatically when your balance runs low.
56
+ - Run `ukiyo --help` or `ukiyo <command> --help` for every option.
57
+
58
+ ## Billing in one minute
59
+
60
+ - One shared balance pays for all your rentals: GPU and storage at the hourly price shown, plus data transfer by volume.
61
+ - Unused credit stays in your balance. Final charges settle a few minutes after a rental ends.
62
+ - A rental that fails before it becomes usable is not charged.
63
+
64
+ Full details: [Billing](https://docs.u-kiyo.ai/guides/billing) · [Terms](https://u-kiyo.ai/terms/) · [Privacy](https://u-kiyo.ai/privacy/)
65
+
66
+ ## Verify a download
67
+
68
+ Every published file is listed with its SHA-256 in [SHA256SUMS](https://u-kiyo.ai/releases/SHA256SUMS) and [latest.json](https://u-kiyo.ai/releases/latest.json). The same files are attached to this repository's [Releases](https://github.com/ukiyocompute/ukiyo-cli/releases).
69
+
70
+ | File | SHA-256 |
71
+ | --- | --- |
72
+ | `ukiyo-cli-0.2.5.mjs` | `3328a07d01808f6a48343eb2af1cf86cc040f3b05b0077dc02857ec7538bee85` |
73
+
74
+ ## Build from source
75
+
76
+ ```bash
77
+ npm install
78
+ npm test # 61 tests
79
+ npm run release # writes dist/release/ukiyo-cli-0.2.5.mjs and the installers
80
+ ```
81
+
82
+ The bundle you build matches the published file except for the module path labels esbuild writes next to each bundled file.
83
+
84
+ ## Related
85
+
86
+ - [ukiyo-mcp](https://github.com/ukiyocompute/ukiyo-mcp): the same actions as an MCP server
87
+ - [ukiyo-skill](https://github.com/ukiyocompute/ukiyo-skill): an agent skill that teaches the workflow
88
+ - [ukiyo-api](https://github.com/ukiyocompute/ukiyo-api): the HTTP API and OpenAPI spec
89
+ - [ukiyo-guides](https://github.com/ukiyocompute/ukiyo-guides): step-by-step guides
90
+
91
+ ## Support and security
92
+
93
+ Questions or a security report: **contact@u-kiyo.ai**. Please don't include API keys or private keys in issues.
94
+
95
+ ## License
96
+
97
+ [MIT](https://github.com/ukiyocompute/ukiyo-cli/blob/main/LICENSE) © 2026 Ukiyo Compute LLC. The license covers this client software, not the Ukiyo service, which is governed by the [Terms](https://u-kiyo.ai/terms/).
index.html CHANGED
@@ -1,19 +1 @@
1
- <!doctype html>
2
- <html>
3
- <head>
4
- <meta charset="utf-8" />
5
- <meta name="viewport" content="width=device-width" />
6
- <title>My static Space</title>
7
- <link rel="stylesheet" href="style.css" />
8
- </head>
9
- <body>
10
- <div class="card">
11
- <h1>Welcome to your static Space!</h1>
12
- <p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
13
- <p>
14
- Also don't forget to check the
15
- <a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
16
- </p>
17
- </div>
18
- </body>
19
- </html>
 
1
+ <!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>ukiyo-cli · Ukiyo</title><style>body{margin:0;font:16px/1.6 Inter,system-ui,sans-serif;background:#f3f5f8;color:#0f172a}main{max-width:640px;margin:0 auto;padding:64px 20px}h1{font-weight:400;letter-spacing:-.02em;font-size:2.2rem;margin:0 0 8px}p{color:#475569}a.btn{display:inline-block;margin:8px 8px 0 0;padding:10px 18px;border-radius:999px;background:linear-gradient(#3b82f6,#2563eb);border:1px solid #1d4ed8;color:#fff;text-decoration:none}a.alt{background:#fff;color:#334155;border-color:#e2e8f0}</style></head><body><main><h1>ukiyo-cli</h1><p>Ukiyo CLI: rent GPUs from your terminal or AI agent.</p><a class="btn" href="https://github.com/ukiyocompute/ukiyo-cli" target="_blank" rel="noopener">View on GitHub</a><a class="btn alt" href="https://docs.u-kiyo.ai" target="_blank" rel="noopener">Docs</a><a class="btn alt" href="https://u-kiyo.ai" target="_blank" rel="noopener">u-kiyo.ai</a></main></body></html>