Heap Chat – Self-hosted Ai Knowledge Base Over Your Own Files (ollama-based, V1.0.0)

Sharing a self-hosted project I've been working on: Heap Chat — point it at a folder, it indexes and embeds the files, and you get a chat/agent interface that actually knows what's in them. Runs on your own Ollama instance by default; no cloud dependency, no telemetry, no forced accounts on someone else's server.

Why post it here specifically: it's built the way I'd want a self-hosted tool to work —

• Multi-user from the first launch, with per-folder access grants enforced server-side (not a single-user tool with auth bolted on)
• Runs as a plain Node process (npm start) or Electron desktop app; LAN access + a PWA so it works from your phone
• Everything — indexing, embeddings, vision, chat — stays on your machine unless you deliberately connect a cloud provider (optional, admin-only, off by default)
• Every frontend dependency is vendored, fonts are self-hosted — npm install is the only step that touches the network at all

Requirements: Ollama running locally with a chat model + an embedding model pulled. That's it for the base install.

License — read before you self-host this for a business: PolyForm Noncommercial 1.0.0. Free for personal/home use, not licensed for commercial use. Flagging this upfront since I know this sub cares about that distinction.

What's not done yet: no signed macOS build (Gatekeeper needs one manual right-click-Open), no Windows build yet (buildable from source), no Docker image yet — it's a plain git clone && npm install && npm start today.

Happy to answer setup questions or hear what's missing for your use case.