Run an AI agent on a machine you control

What this website is#

This site is the product page and documentation for Noira. It also runs a demo launch feed, Ask Noira and a scripted replay of the site builder, which are labelled as such. The agent you install is a different thing: it runs on your own machine, never on this site.

Overview and architecture#

Everything is one Node process called the gateway, plus a thin CLI that talks to it over HTTP. There is no database and no cloud account. State is JSON files in one folder.

The parts

Gateway

An HTTP server on 127.0.0.1:18790. Serves the control panel, exposes the API, streams events, and owns everything below.

Agent

The loop that sends your task to the model, runs the tools it asks for, and pauses for your approval when a tool needs it.

CLI

noira. Starts and stops the gateway, chats, and manages approvals, jobs and memory by calling the API.

Control panel

The web app the gateway serves. The same panel runs inside the desktop app and the Android app, and installs as a web app.

Scheduler

Cron jobs that start a run on their own while the gateway is up. Results land in Activity.

Tools

Files, shell, web fetch, memory, schedules, the launch feed and the site builder, each with its own permission.

How a task flows

1. You hand it a taskFrom noira, the control panel, the desktop or phone app, or a scheduled job. It lands on POST /api/runs.
2. The agent calls the modelClaude by default, or any OpenAI-compatible endpoint such as Ollama. Text streams out as events while it is written.
3. The model asks for toolsEach call is checked against its schema, then against your policy: allow runs now, ask waits for you, block is refused.
4. You approve or denyIn the terminal, in the panel, or in the app. An unanswered request is denied when it expires (12 hours by default).
5. Results go back to the modelUp to 30 steps per run. When the model stops asking for tools, its last text is the answer, and the run is saved to disk.

The data folder

Everything lives in ~/.noira, or wherever NOIRA_HOME points. Keys are stored in plain text. Never commit or share this folder.

~/.noira/
├── config.json      provider, model, key, token, port, policy, feed URL
├── memory.json      saved memories, put in front of the model on every run
├── jobs.json        scheduled jobs with their last run
├── runs/            one JSON file per run (the newest 300 are kept)
├── gateway.pid      pid of the running gateway
├── gateway.log      its log, read with noira logs
└── workspace/       where the agent works; file tools stay inside it

Install#

Noira needs Node 22 or newer and a model: a Claude API key, any OpenAI-compatible endpoint, or a local model with Ollama. Install it once from npm, then run the guided setup.

Linux and macOS

npm install -g @noirarh/noira
noira onboard

Windows

PowerShell blocks the .ps1 shims that npm installs, so call the .cmd versions:

npm.cmd install -g @noirarh/noira
noira.cmd onboard

To use the short names instead, allow local scripts once for your account and open a new terminal:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

What onboard does

1. Picks a modelClaude (asks for your Anthropic key and the model, default claude-opus-5-5), an OpenAI-compatible endpoint (base URL, model, key), or Ollama (local URL and model, no key).
2. Checks itSends one tiny request so a wrong key shows up now, not at 3 a.m. The key input is hidden.
3. Saves the configTo ~/.noira/config.json. Then start the gateway with noira start and talk to it with noira.

Desktop and mobile apps

You do not have to live in the terminal. The Download section has installers for each platform, built from the same source as the npm package.

Models#

Change the model any time with noira onboard or in Settings → Model of the panel.

Command line#

Every command calls the gateway's API with the token from ~/.noira/config.json. If the gateway is not running, commands that need it tell you so. On Windows PowerShell write noira.cmd instead of noira, unless you allowed local scripts.

Setup and gateway

Talking to the agent

Jobs, memory and Noira tools

Control panel and apps#

Open it with noira panel, or go to http://127.0.0.1:18790/panel.html on the machine that runs the gateway.

Install it as an app

In Chrome or Edge, open the panel and choose Install app in the sidebar or the address bar. It opens in its own window like a native app, on any device that can reach your gateway.

Connect your phone

1. Put both devices on a private networkTailscale is the simplest: install it on the computer and the phone and sign in to the same account.
2. Start the gateway for remote usenoira stop, then noira start --remote.
3. Get the detailsnoira pair prints the gateway address (Tailscale addresses start with 100.) and the token.
4. ConnectOpen the Noira app on Android, enter the address and token, and tap Connect.

Tools and permissions#

The model gets thirteen tools. Each has a permission: allow runs without asking, ask waits for your answer, block refuses and tells the model the tool is off. Change them in Settings → Permissions, or answer Always allow to an approval.

The workspace boundary

File tools resolve paths inside ~/.noira/workspace and refuse anything outside it, such as ../config.json. To give Noira another folder, add it to allowedRoots in the config. Shell commands start in the workspace but, once you approve them, run with your user's rights, so read what you approve.

Approvals#

When a tool set to ask is called, the run pauses and an approval appears everywhere at once: inline in noira chat and noira run, in noira approvals, on the panel's Approvals page and in the chat that started it. Answer it in any of those places; the first answer wins.

• Allow runs this one call.
• Always allow runs it and sets the tool to allow from now on.
• Deny refuses it. The model is told and continues without it.

Requests made by scheduled jobs at night wait for you in the morning. If nobody answers before approvalTimeoutMin (720 minutes by default), the request counts as denied. Stopping a run denies whatever it was waiting for.

Scheduled jobs#

A job is a task plus a five-field cron expression in the machine's local time: minute hour day-of-month month day-of-week. Jobs run while the gateway is up; if the computer is off, that run is skipped.

noira jobs add "0 8 * * 1-5" "Scan the latest launches and write the signals to brief.md" --name "Morning brief"

You can also just ask: "Every Friday at 4 pm, summarize my notes into weekly.md." Noira will propose the job with schedule_job and wait for your approval.

Memory#

Memories are short facts that carry across conversations: your name, how you like answers, where a project lives. On every run Noira puts the memories most relevant to the task, then the newest, in front of the model (up to 14). It saves new ones with remember when you tell it something worth keeping, and you can add or forget them yourself in the panel or with noira memory.

Launch tools#

scan_launches reads the launch feed of a Noira site (GET /api/launches), where each launch is scored on seven checks: dev wallet share, liquidity lock, holder concentration, sniper and bundle activity, contract risk, early volume quality, and socials. A launch is signal only when all seven pass. Point the agent at a feed with feedUrl in Settings. The public feed is a demo until the chain indexer is connected.

build_site writes a complete single-file website (inline CSS and JavaScript, responsive, accessible) from one sentence into the workspace. noira build does the same from the terminal, into the current folder.

Configuration#

~/.noira/config.json is created on first run. Most fields can be changed in the panel; restart the gateway after editing the file by hand.

Environment variables: NOIRA_HOME (data folder), ANTHROPIC_API_KEY, OPENAI_API_KEY.

HTTP API#

The CLI, the panel and the apps all use this API, and so can your own scripts. Send the token in an x-noira-token header (or ?token= for the event stream). Bodies are JSON.

curl -H "x-noira-token: $TOKEN" http://127.0.0.1:18790/api/status

curl -X POST -H "x-noira-token: $TOKEN" -H "content-type: application/json" \
  -d '{"task":"List the files in my workspace"}' http://127.0.0.1:18790/api/runs

Security#

• Local only by default. The gateway listens on 127.0.0.1, and requests that name any other host are refused, so a web page cannot reach it through a DNS trick.
• A token on every call, even from this machine. The panel receives it inside its own page, which other sites cannot read.
• Remote mode is for private networks. --remote listens on every interface for the phone; use Tailscale or your home network, never a port forward.
• It asks before it acts. Files, shell, web requests, jobs and site builds wait for your yes unless you allow them.
• Your data stays yours. Keys, memory, runs and files live in ~/.noira. Model calls go to the provider you chose; with Ollama they never leave the machine.

Troubleshooting#

noira is not recognized, or "running scripts is disabled" on Windows

Use noira.cmd and npm.cmd, or run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once and open a new terminal.

"Port 18790 is busy"

Another gateway is already running, maybe from the desktop app. noira status shows it; noira stop stops it.

"The model rejected the API key"

Run noira onboard again or fix it in Settings. Check that no old ANTHROPIC_API_KEY / OPENAI_API_KEY in your environment is overriding the saved key.

The panel says "Wrong token"

Open it from noira panel so the page carries the current token, or reconnect the phone app with the token from noira pair.

A job did not run

Jobs only run while the gateway is up and a model is set up. Check the job's next run in noira jobs and the gateway log with noira logs.

The phone cannot connect

Start the gateway with --remote, make sure both devices are on the same Tailscale network, and use the 100. address from noira pair.

$NOIRA#

$NOIRA is the Noira token. Holding it opens the full agent on this site; fees buy it back and burn it. The contract address is published only on the home page; until then it reads "Coming soon". Nothing in these docs is an offer or investment advice.