raicompute 0.1.0

Republic Proxy Command Line Interface

Republic Compute CLI

The Republic Compute CLI (raicompute) is a lightweight, stateless interface for GPU providers to register and manage their hosted machines on the Republic network, using Cosmos wallet authentication.

This tool is exclusively for GPU hosts — operators who are contributing compute resources to the network. It is not a tool for renting or consuming compute.

Installation

pip install raicompute

This will install the CLI under the raicompute command.

Authentication & Session Management

The CLI uses Cosmos wallet signatures for authentication. To avoid passing credentials with every command, use the login command to save your session locally.

Login

Saves your wallet address, public key, and signature to ~/.republic_session.json.

raicompute login --auth-wallet <bech32_address> --auth-pubkey <base64_pubkey> --auth-sig <base64_signature> [--auth-wallet-hex <hex_address>]

Once logged in, all subsequent commands will automatically use these credentials.

Auth Verify

Diagnostic tool to verify your current authentication session with the proxy server.

raicompute auth-verify

---

Host Commands

These commands are for operators who are hosting GPU machines on the network.

Install Provider Machine

Registers your machine with the proxy server, linking it to your wallet for earnings tracking. This command is typically called by the automated install script.

raicompute install --machine-api-key <api_key> [--provider-slug vast]

Host Metrics

View earnings, reliability, and active rental status for machines registered to your wallet.

raicompute host-metrics

Host Update

Update settings for your hosted machine, such as rental prices.

raicompute host-update --machine-id <id> [--price-gpu <float>] [--price-disk <float>]

---

Environment Variables

Variable	Description
PROXY_SERVER_URL	URL of the Republic Proxy Server (default: https://provider-proxy-server-production.up.railway.app)