FAQ

Is it free?

Yes. Everything runs locally at no cost, and the hosted registry and API are free to read. You only need an account to publish.

Do I need an account?

Not to read, install, or run — those are public. Publishing an agent or tool needs a key, which you create on the app's API Keys page.

Does the registry run my agent?

No. The registry only stores and serves manifests. Execution is the runtime's job, and the runtime runs on your machine — a shared catalogue must never execute someone else's code.

Why is the runtime “local” in the hosted app?

By design. The hosted app can show you the live registry and chain status, but it cannot run agents for you — that would mean executing arbitrary code on shared infrastructure. Start the supervisor yourself with norien runtime start.

What data does the API cover?

Tokens, trending, projects, wallets, contracts, search, and chain status — normalized across several providers, defaulting to Robinhood Chain. Every response says where it came from. See the unified API.

Can I point the tools at my own registry?

Yes. The CLI and SDKs take a registry URL, and the registry runs anywhere Node runs — with DATABASE_URL unset it uses an embedded Postgres, so a local instance needs no setup.

What happens when a data provider is down?

The request still succeeds with whatever the other providers returned, and the response is marked degraded with the failing source listed. A partial answer is never presented as a complete one.

Are published versions permanent?

A published version is immutable and stays installable. Removed artifacts are tombstoned, not deleted, so a past install is never silently broken. See versioning.