project-nomad
ApplicationCrosstalk-Solutions/project-nomad
Offline-first knowledge and education server with AI, maps, and tools.
Overview
Project N.O.M.A.D. is a self-contained offline survival computer packed with critical tools, knowledge, and AI. It provides an information library, education platform, offline maps, AI chat, data tools, and notes. Designed to keep you informed and empowered anywhere without internet.
README Preview
\n\n\n# Project N.O.M.A.D.\n### Node for Offline Media, Archives, and Data\n\n**Knowledge That Never Goes Offline**\n\n[](https://www.projectnomad.us)\n[](https://discord.com/invite/crosstalksolutions)\n[](https://benchmark.projectnomad.us)\n\n\n\n---\n\nProject N.O.M.A.D. is a self-contained, offline-first knowledge and education server packed with critical tools, knowledge, and AI to keep you informed and empowered—anytime, anywhere.\n\n## Installation & Quickstart\nProject N.O.M.A.D. can be installed on any Debian-based operating system (we recommend Ubuntu). Installation is completely terminal-based, and all tools and resources are designed to be accessed through the browser, so there's no need for a desktop environment if you'd rather setup N.O.M.A.D. as a "server" and access it through other clients.\n\n*Note: sudo/root privileges are required to run the install script*\n\n### Quick Install (Debian-based OS Only)\n```bash\nsudo apt-get update && \\nsudo apt-get install -y curl && \\ncurl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh \\n -o install_nomad.sh && \\nsudo bash install_nomad.sh\n```\n\nProject N.O.M.A.D. is now installed on your device! Open a browser and navigate to `http://localhost:8080` (or `http://DEVICE_IP:8080`) to start exploring!\n\nFor a complete step-by-step walkthrough (including Ubuntu installation), see the [Installation Guide](https://www.projectnomad.us/install). For Windows users, see the [WSL2 install guide](https://www.projectnomad.us/install/wsl2) — community-supported path covering native Docker and Docker Desktop install routes.\n\n### Advanced Installation\nFor more control over the installation process, copy and paste the [Docker Compose template](https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/management_compose.yaml) into a `docker-compose.yml` file and customize it to your liking (be sure to replace any placeho
FAQ (5)
feature_inquiryHow can I see file sizes in the N.O.M.A.D. content manager?
Starting from version 1.31.1, the Content Manager includes a sortable Size column. By default, files are sorted by size in descending order (largest first). You can also sort by Title. This feature was added in PR #698.
TroubleshootingWhy does the AI assistant stop streaming responses after upgrading NOMAD to v1.31.0-rc.2 or later?
This is a regression introduced in v1.31.0-rc.2 where gzip compression middleware incorrectly buffers text/event-stream (SSE) responses, collapsing per-token streaming into one block. Fixed in v1.32.0-rc.1 and later – upgrade to that version to restore streaming. No workaround for earlier broken versions; downgrading to v1.31.0-rc.1 is not recommended.
TroubleshootingHow to speed up ZIM file downloads in N.O.M.A.D. by using custom mirrors?
Starting from version 1.32.0, N.O.M.A.D. supports replaceable mirrors for ZIM file downloads. You can override slow or blocked default download sources by specifying custom mirror URLs in the application settings. See the v1.32.0 release notes or PR #577 for implementation details.
TroubleshootingWhy are my marker notes not appearing in the map popup?
This was a known bug in versions before 1.32.0 where the marker popup only displayed name and coordinates, ignoring the notes field even if populated via API or database. Upgrade to version 1.32.0 or later to fix the popup and display the notes block.
TroubleshootingWhy does NOMAD fall back to CPU instead of using my AMD RX 6800 or other discrete AMD GPU?
NOMAD v1.31.0 and earlier incorrectly applied HSA_OVERRIDE_GFX_VERSION=11.0.0 to all AMD GPUs, which broke detection for RDNA 2 cards like the RX 6800 (gfx1030) and Radeon 680M iGPU, causing silent CPU fallback. The benchmark service also failed to report discrete AMD GPUs. Upgrade to NOMAD v1.32.0 or later; if stuck on an older version, unset HSA_OVERRIDE_GFX_VERSION or set it to the correct architecture (e.g., 10.3.0) to restore GPU acceleration.