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
Linux (Debian, Ubuntu, RHEL, Alpine, Arch, Raspberry Pi OS), one line:
curl -fsSL https://get.nouride.com/install.sh | sudo shmacOS (Apple Silicon), as yourself, no sudo:
curl -fsSL https://get.nouride.com/install.sh | shDocker:
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/nourideThen 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 | lessBy 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.0To 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 | shIt 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/.nourideThe 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 -dTo check your configuration against a new image before you switch:
docker run --rm -v ./nouride:/app/.nouride ghcr.io/nouverse/nouride nouride config checkAn 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/v1Coming 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
-muslbuild needslibstdc++(apk add libstdc++).
Every release carries its checksum file, signed: CHECKSUMS, with its .sig. The installer checks both before it
installs anything.
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.
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.
- GETTING_STARTED.md: running it from source.
- docs/ARCHITECTURE.md: how it is built, and why.
- docs/CONTRIBUTING.md: the conventions, and how a change is tested.
- 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].
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.







