ZOYKUHot Board

nouverse/nourideDocumentation

Lightweight, zero-bloat multi-agent AI engine in a single daemon. Homelab-friendly and built for mini devices (Raspberry Pi, Orange Pi, Geekom, NUC, LXC).

npm i nouride
The Nouride cat, waving hello

Nouride

AI agents that live on your box

Nouride runs a few AI agents on a small box you own, and uses very little of it.
Chat with them on Telegram, Discord, WhatsApp or right in your browser.

Website · Docs · Getting started · Releases

License: FSL-1.1-ALv2 GitHub Sponsors Ko-fi Trakteer KaryaKarsa


Nouride's dashboard: Home, with what needs you, what is moving and a quick line to an agent

What it does

A few agents, each its own. Every agent has its own personality, model, chat apps and tools. They all run in one small daemon from a single binary, which starts in 64 MB of memory and sits under 1% of one CPU core while it waits.
Say hi from the apps you already use. Telegram, Discord, WhatsApp, or the web dashboard. Put several agents in one room and tag the one you mean.
Risky stuff waits for your yes. A command that changes the system, touches credentials or cannot be undone asks first: allow it once, always, or not at all, from the chat or the dashboard.
Give it a goal, go to bed. Missions an agent works through on its own, with a checklist you can follow; scheduled jobs; webhooks that wake an agent when something happens elsewhere.
It remembers. People, facts and your documents, kept on the box and found again in any language. A nightly pass tidies what it learned.
Skills and connectors. One pool of skills every agent can switch on, skills learned from work it did, connectors to the services you use, and web search.
Claude Code and Codex as agents. An agent can work inside a coding CLI on your own subscription, with the same chats, approvals and missions as the rest.
Your box, your data. Conversations, memory and keys stay on your machine, keys encrypted at rest. What leaves is what an agent sends to the models and services you chose.

Get it running

Linux (Debian, Ubuntu, RHEL, Alpine, Arch, Raspberry Pi OS), one line:

curl -fsSL https://get.nouride.com/install.sh | sudo sh

macOS (Apple Silicon), as yourself, no sudo:

curl -fsSL https://get.nouride.com/install.sh | sh

Docker:

mkdir -p ~/nouride && cd ~/nouride
docker run -d --name nouride --restart unless-stopped \
  -p 127.0.0.1:18254:18254 -v "$PWD/nouride:/app/.nouride" \
  ghcr.io/nouverse/nouride

Then open http://127.0.0.1:18254/ on that machine and follow the setup: connect a model, name your first agent, done. The first-run password is printed by the installer (and in docker logs nouride).

More on the Linux install

Nouride runs as a standalone binary with its own embedded runtime. To review the script before piping it to a shell:

curl -fsSL https://get.nouride.com/install.sh | less

By default the dashboard listens on loopback (127.0.0.1:18254). To expose it across your local network:

curl -fsSL https://get.nouride.com/install.sh | sudo sh -s -- --host 0.0.0.0

To update a native install later, use the dashboard's Update page or nouride update.

Once installed, open http://127.0.0.1:18254/ on that machine (or http://<your-ip>:18254/ if you installed with --host 0.0.0.0) to complete setup. The first-run password is printed by the installer and in the service log (journalctl -u nouride | grep -A6 'Nouride is ready').

More on macOS

On a Mac with Apple Silicon (M1 and later), since 0.7.20:

curl -fsSL https://get.nouride.com/install.sh | sh

It installs into ~/nouride and runs as a LaunchAgent while you are logged in. The first-run password is in ~/nouride/.nouride/data/nouride.log. Intel Macs are not a published target.

More on Docker: Compose, the network, packages and updates

The official multi-arch image (linux/amd64 and linux/arm64) is on GitHub Container Registry. With Docker Compose:

services:
  nouride:
    image: ghcr.io/nouverse/nouride
    container_name: nouride
    restart: unless-stopped
    ports:
      - "127.0.0.1:18254:18254"
    volumes:
      - ./nouride:/app/.nouride

The port is published on the host's loopback only, as a native install listens: open the dashboard on the machine itself, or tunnel to it from yours with ssh -L 18254:127.0.0.1:18254 you@your-server. To reach it from other machines, drop 127.0.0.1: ("18254:18254"): the dashboard then answers anyone who can reach the host, and a port Docker publishes goes around a firewall such as ufw. For a public address, keep it on loopback and put a reverse proxy with TLS in front of it on the same machine (Caddy, nginx, a Cloudflare Tunnel).

Agents install system packages in the container too: docker exec nouride nouride pkg install <name>, or an agent asks, and you approve each change unless the agent is trusted. What they installed is kept on the volume and installed again when the container is recreated, as every update does; nothing the image ships can be removed. NOURIDE_SYSTEM_PACKAGES=off turns it off.

To update, pull it again and recreate the container. The volume keeps everything:

docker compose pull && docker compose up -d

To check your configuration against a new image before you switch:

docker run --rm -v ./nouride:/app/.nouride ghcr.io/nouverse/nouride nouride config check

An install older than 0.7.28 updates in two steps: Updating has how.

Nougate: sign in with an AI account instead of an API key

Every install carries the Nougate LLM gateway in the same process: model calls answered from inside the daemon, with no second container and no network hop. It stays off until you choose Use Nougate in setup, or turn it on from the dashboard's LLM Gateway page; then setup signs in to a Claude, ChatGPT, Copilot, Gemini or Kiro account you already have instead of asking for an API key. Off, it costs about 1.3 MB of memory.

On, it listens on port 18256 and keeps its state (accounts, providers, nougate.db) in a folder of its own inside the same volume: ./nouride/nougate/data/. Publish 18256 only for other tools that call it with a gateway key. To point a provider at it by hand, in .nouride/config.toml:

[providers.local]
kind = "openai"
base_url = "http://127.0.0.1:18256/openai/v1"   # or /anthropic/v1

Coming from the Router edition? Router is part of Community since 0.8.28. A Router install updates onto Community by itself and keeps Nougate on. Until 0.9 the nouride-router image still receives each release; change image: to ghcr.io/nouverse/nouride whenever you like before then.

Standalone downloads: every platform's tarball

Standalone tarballs include the executable, built-in skills, example configuration and the dashboard. Download the latest directly, or browse every version on the Releases page.

Platform Architecture C Library Download
Linux x86_64 glibc nouride-linux-x64.tar.gz
Linux aarch64 glibc nouride-linux-arm64.tar.gz
Linux (Alpine) x86_64 musl nouride-linux-x64-musl.tar.gz
Linux (Alpine) aarch64 musl nouride-linux-arm64-musl.tar.gz
macOS Apple Silicon not applicable nouride-darwin-arm64.tar.gz

Alpine / musl: the -musl build needs libstdc++ (apk add libstdc++).

Every release carries its checksum file, signed: CHECKSUMS, with its .sig. The installer checks both before it installs anything.


Nouride Home, on a phone

nouverse/nouride-android-appliance is Nouride Home, the Android app that runs Nouride on a phone, with no terminal and no root. It has its own releases and updates itself; the APK is on its Releases page, and how to use it is in the Nouride Home guide.

The source

This repository holds Nouride's source: the daemon (apps/engine), the dashboard (apps/dashboard), the documentation site (apps/site) and the packages they share (packages/). Nouride Pro's components are not in it.

Contributing and issues

  • Found a bug or crash? Open an issue with your OS version, architecture (uname -m), how you run it (native or Docker), and the output you saw.
  • An idea? New chat apps, agent tools, homelab integrations: open an issue with what it is for.
  • Pull requests are welcome. Before the first one is merged, its author agrees to the Contributor Licence Agreement: you keep your copyright, and Nouverse may use your contribution in every edition, under any terms.
  • Security: for anything sensitive, write to [email protected].

Licence

Nouride is licensed under the Functional Source License 1.1, ALv2 Future License (FSL-1.1-ALv2). In short:

  • Use it for anything but a competing product. At home, in a homelab, at work, inside your company, and to set it up for a client. Change it and share your changes, with these terms beside them.
  • A competing product needs a licence from Nouverse Technologies: Nouride, or something that does what it does, made available to others commercially, such as a hosted Nouride or a device sold with it.
  • Each version becomes Apache 2.0 two years after it is released.
  • The Nouride name and logo are trademarks of Nouverse and are not licensed: a changed copy is not called Nouride.

Licensed separately: the WhatsApp bridge in packages/wa-bridge and the built-in skills and agent templates in content/ are MIT, so the agents and skills you run are yours to change. LICENSE lists every exception. The licence text governs; this summary does not replace it.


The Nouride cat, asleep
Nothing is waiting for you. Made by Nouverse.
Document mirror archived from official upstream repository · Visit upstream GitHub
Snapshot date: 2026-11-13