Getting started

From nothing to a running agent — and your own published one — in a handful of commands.

1. Install the CLI. One command, no configuration. It talks to the hosted registry at api.norien.live out of the box.

# macOS / Linux
curl -fsSL https://norien.live/install.sh | sh

# or with npm
npm install -g @norien-live/cli

2. Find something to run. Search the registry, or browse it in the app.

$ norien search trading  trading-agent   0.5.0   python   4 tools$ norien info trading-agent

3. Install and run it. Install resolves the agent's declared tools and writes them locally; run hands it to the supervisor, which starts it, probes its health, and restarts it if it crashes.

$ norien install trading-agent  ✓ resolved 4 tools · wrote ./norien_agents$ norien runtime start$ norien run trading-agent  ✓ running · pid 24180 · healthy$ norien logs trading-agent -f

4. Or just read the data. No install needed — hit the unified API directly, or explore it in the app.

curl https://api.norien.live/api/tokens?limit=5
curl https://api.norien.live/api/token/0x…

5. Publish your own. Write an agent.json (see the manifest), validate it against the live registry on the publish page, then ship it:

$ norien publish  ✓ published trading-agent@0.5.0

Note —Publishing needs identity. Create a key on the API Keys page and run norien login. Reads stay public and free.

That is the full loop — discover, run, read, publish. The Core concepts explain each piece; the Guides go deep on the workflows.