Run Noora with Noora Portal

This walks from a fresh install to a working agent signed in to Noora Portal.

1. Install

git clone https://github.com/noora-guru/noora-agent.git && cd noora-agent && ./setup-noora.sh

Or, from a checkout:

./setup-noora.sh

2. Sign in

noora portal

The terminal prints a short code and a link. Open the link, sign in with your portal account, and confirm that the code matches. Approving in the browser is what releases the token — the CLI is polling and continues by itself.

On a machine with no browser (a VPS over SSH), the same command still works: copy the link to a browser anywhere and approve it there. The code is bound to the waiting terminal, not to the machine you approve from.

3. Choose a model

The portal does not sell model access, so this step uses your own provider credentials:

noora model

Pick a provider and paste its key when asked. Anthropic, OpenAI, OpenRouter, Gemini and about thirty others are supported — see Providers.

4. Talk to it

noora

Checking it worked

noora portal info     # should show your organisation and plan
noora doctor          # diagnoses configuration problems

If noora portal info reports no auth, the approval never completed — run noora portal again and watch for an error in the browser tab.

Common problems

The code expired. Codes are valid for fifteen minutes. Start over.

"Too many requests". The portal rate-limits the login endpoints per source address. Wait a minute; the CLI backs off on its own.

Signed in, but tools are unavailable. Entitlements come from your plan. Run noora portal tools to see which categories are covered.