Spaces:
Running
Running
Mirror ukiyo-cli from GitHub
Browse filesSource: https://github.com/ukiyocompute/ukiyo-cli
- LICENSE +21 -0
- README.md +92 -5
- 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:
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
|
|
|
|
|
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|