Start here

Getting started

From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key.

LinuxmacOSWindows beta

Requirements

Node.js 20.19.0 or newer
npm
A supported model OAuth login or API key
A user-controlled wallet only when you want to sign a prepared action

Install Oracle

recommended

curl -fsSL https://oracle.demi.la/install.sh | bash
oracle --version

The installer writes to ~/.local/share/oracle and exposes oracle through ~/.local/bin. Re-run the installer to upgrade.

npm alternative

npm i -g @oracle-agent/oracle
oracle --version

Configure a model

Run the interactive model picker. OAuth is available for Claude, Codex, and Grok. API-key providers include OpenRouter, OpenAI, Anthropic, xAI, DeepSeek, Gemini, Kimi, Mistral, Nous Portal, Qwen, GLM, and compatible endpoints.

terminal

oracle setup model

# direct OAuth choices
oracle setup model claude
oracle setup model codex
oracle setup model grok

# safe status, never prints credentials
oracle auth status
oracle model --show

Keep credentials out of argv

Interactive API-key entry is hidden. Do not put keys in command arguments, shell history, screenshots, or Oracle chat.

First run

Open Oracle

Run oracle or oracle chat. First-run onboarding can select a chain and opens the native agent loop.

Select a chain

List supported chains, select one, and inspect the active selection.

Verify the posture

Run doctor before preparing a live action. Treat a degraded provider as unavailable, not healthy.

terminal

oracle
oracle chain list
oracle chain use hyperliquid
oracle chain show
oracle doctor

Useful in-chat commands include /sessions, /new, /resume, /chain, /model, /setup, and /help.

Update or remove

Re-run the curl installer to upgrade a user-local installation. For npm installs, update the package through npm.

update

curl -fsSL https://oracle.demi.la/install.sh | bash
# or
npm i -g @oracle-agent/oracle@latest

Before removing Oracle, export anything you need from your local config. Never copy vault files into a public backup.