Esegui un operatore (CLI)
Usa la CLI di halo per servire inferenza da un provider, un modello ospitato o una GPU locale e guadagnare USDC su Base: slug dei provider, prezzi, liquidazione e configurazione sempre attiva.
Il ruolo operate serve inferenza alla rete e guadagna USDC per ogni richiesta.
Questa guida usa direttamente la CLI di halo. Preferisci lasciare che sia un
agente a configurarlo conversando? Consulta opera con il tuo agente.
Halo è in alpha sulla mainnet di Base, con USDC reale. Richiede Node.js 20+.
Installa e verifica
bash <(curl -fsSL https://raw.githubusercontent.com/warden-protocol/run-halo/main/skill/scripts/install.sh)
halo doctor --json # node version, install + wallet state, provider, relay health
Imposta un provider, un prezzo e servi
halo setup --provider <slug> [--api-key <key>] --margin 20 --with-pairing
halo serve
halo serve si connette in uscita al relay tramite WebSocket — senza URL
pubblico né porta in entrata aperta —, annuncia i tuoi modelli e serve fino allo
stop. Il wallet dell’operatore non richiede finanziamento anticipato; l’USDC
arriva alla liquidazione e Halo sponsorizza il gas.
<slug> è uno tra openclaw, claude-code, hermes, ollama, lmstudio,
openrouter, openai, anthropic, venice, near, together, fireworks,
groq, o custom. Aggiungi altri upstream a uno stesso operatore con
halo setup --add-provider.
Prezzi
- Margine (
--margin <n>) — consigliato. Applica un ricarico del n% sulla tariffa per token pubblicata dall’upstream, risolta per modello alla liquidazione (dove il provider espone i prezzi, per esempio OpenRouter e NEAR). Segue il costo reale per modello. - Fisso (
--flat <usd-per-1k>). Un prezzo fisso in USD per ogni 1.000 token, per modelli locali (Ollama, LM Studio) o upstream che non pubblicano prezzi.
La commissione del protocollo parte dal 10% del tuo prezzo, trattenuta alla liquidazione e applicata on-chain (regolabile tramite governance): incassi prezzo − commissione.
Come funziona la liquidazione
L’inferenza si liquida tramite l’HaloVault su Base: il consumatore deposita USDC e ne riserva una parte per il tuo operatore; il tuo operatore legge quella riserva on-chain e serve solo se copre la richiesta; tu segnali i token realmente usati e una ricevuta cumulativa riscatta quell’importo per te. Il facilitatore invia queste transazioni e paga il gas.
Privacy
- La cifratura end-to-end è attiva per impostazione predefinita: il relay inoltra solo testo cifrato, e la tua chiave per sessione vive solo in memoria, senza mai essere persistita.
- Modalità confidenziale (TEE) — esponi un provider TEE (per esempio
--provider near) per servire modelli confidenziali che lo stesso operatore non può leggere.
Mantienilo sempre attivo
halo service install serve
halo service status serve
halo service logs serve
Cosa arriverà
Inferenza verificabile (SPEX) — una Prova Statistica di Esecuzione che fornisce garanzie probabilistiche che un operatore abbia eseguito il modello richiesto — è nella roadmap, insieme a servizi open-source e auto-ospitabili. Consulta cos’è l’inferenza IA verificabile.
Correlati
- Esegui invece un endpoint di inferenza a pagamento: crea un endpoint (CLI).
- Riferimento completo della CLI: warden-protocol/run-halo.