Crosstalk-Solutions/project-nomad

Project NOMAD is a browser-managed, offline-first knowledge server. It bundles offline reference content, courses, maps, notes and an optional local AI assistant, and runs them as containers so the collection stays available on a device you control after the initial install. It suits people who want a portable or self-contained study and reference box rather than a bare-minimum survival machine.

What it does and how it works

A management UI called the Command Center installs, configures and updates a set of containerized tools: Kiwix for offline Wikipedia, medical references and ebooks; Kolibri for Khan Academy courses with progress tracking; ProtoMaps for regional maps; FlatNotes; CyberChef for data tools; and a Supply Depot catalog that can also run your own Docker containers Project NOMAD README. The AI assistant uses Ollama with Qdrant for document upload and semantic search; alternatively it can point at an OpenAI-compatible server such as LM Studio or llama.cpp Project NOMAD README.

A typical first run is: install on a Debian-based host, open the browser UI at port 8080, then use the setup wizard to pick content collections. After that, downloads and updates happen from the UI when you choose them.

Paths and prerequisites

The documented supported path is a Debian-based OS, with Ubuntu 26.04 LTS recommended and 24.04 LTS or Debian 12 also supported; installation is terminal-based and root privileges are required installation and quickstart. A Docker Compose template exists for advanced users who want manual control advanced installation, and Windows is covered only by a community-supported WSL2 guide WSL2 guide.

Sizing depends heavily on what you install. The base management application needs about 5 GB of disk and under 1 GB of RAM, while adding the AI Assistant brings the install to roughly 25 GB and needs model-sized memory from VRAM or system RAM device requirements. The project says it favors GPU-backed hardware for AI work rather than minimal hardware. Internet is needed during installation and again only when you deliberately download additional tools or content Project NOMAD README.

Access and security boundary

By design there is no authentication, and the author explicitly advises against exposing an instance directly to the internet, recommending network-level port controls instead security section. That is the main condition to weigh before letting other devices on a LAN reach the server.

For privacy, the project states it has no built-in telemetry. An internet-status check contacts Cloudflare's endpoint first and falls back to GitHub and the NOMAD API; the endpoint can be overridden in Settings or via an environment variable, with the environment variable taking precedence internet usage and privacy. Automatic updates of minor and patch versions are opt-in, tied to a configurable window and cool-off, require passing pre-flight checks, and never apply major versions automatically auto-updates.

The code is Apache-2.0 licensed license. Overall, NOMAD fits people who want a managed, self-hosted offline library and are comfortable with a Docker-based host and an unauthenticated local network service.