ZettaBrain RAG Skill

Chat with your own documents using a local AI. Document data stays on your machine when you use local storage and a local Ollama endpoint (the default). Remote storage (S3, NFS, SMB) and a remote OLLAMA_HOST are optional and will move data off-device — see the Privacy section.

Supports PDF, DOCX, TXT, Markdown. Works on Linux, macOS (including EC2 Mac Apple Silicon), and Windows.

• Source code: https://github.com/zettabrain/zettabrain-rag (MIT)
• Installer scripts: https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh | install.ps1
• PyPI: https://pypi.org/project/zettabrain-rag/

Install

Recommended — pipx (no elevated privileges, fully inspectable)

pipx install zettabrain-rag
sudo zettabrain-setup

One-line installer (review source before running)

The installer scripts are open source and auditable at the links above before execution.

# Linux — review first: https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh
curl -fsSL https://zettabrain.app/install.sh | sudo bash

# macOS — review first: https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh
curl -fsSL https://zettabrain.app/install.sh | bash

# Windows — review first: https://github.com/zettabrain/zettabrain-rag/blob/main/install.ps1
irm https://zettabrain.app/install.ps1 | iex

The Linux installer requires sudo to install Ollama system-wide and register a systemd service. The macOS installer does not require sudo for the package install step.

Setup

Run the interactive setup wizard once after install:

sudo zettabrain-setup

This will:

1. Configure your document storage (local, NFS, SMB, or S3)
2. Install and start Ollama locally
3. Pull the recommended AI model for your hardware
4. Generate a self-signed TLS certificate (stays on-device)
5. Register ZettaBrain as a background service (see Service Management to stop or remove it)

Commands

Usage Examples

Chat via CLI:

zettabrain-chat
# > What does our Q3 report say about cloud costs?

Start the web GUI (https://localhost:7860):

zettabrain-server

Ingest a specific folder:

ZETTABRAIN_DOCS=/path/to/docs zettabrain-ingest

Vector Store — Location, Retention & Deletion

The vector index (document embeddings) is stored only on your local machine:

Embeddings are never transmitted to any remote service. They are derived from your documents and stored locally in ChromaDB.

Delete the vector index:

# Via CLI
zettabrain-server &
curl -X DELETE http://localhost:7860/api/vectorstore

# Or directly
rm -rf /opt/zettabrain/src/zettabrain_vectorstore
rm -f  /opt/zettabrain/src/ingested_files.json

Rebuild from scratch:

zettabrain-ingest --rebuild

Exclude files or folders by not including them in ZETTABRAIN_DOCS — only files under that path are indexed.

Service Management

ZettaBrain registers a background service so the web GUI auto-starts on boot. Here is how to control or fully remove it:

Linux (systemd)

# Stop the service
sudo systemctl stop zettabrain

# Disable auto-start on boot
sudo systemctl disable zettabrain

# Check status
sudo systemctl status zettabrain

# View logs
journalctl -u zettabrain -f

# Remove service completely
sudo systemctl stop zettabrain
sudo systemctl disable zettabrain
sudo rm /etc/systemd/system/zettabrain.service
sudo systemctl daemon-reload

macOS (launchd)

# Stop the service
sudo launchctl unload /Library/LaunchDaemons/io.zettabrain.server.plist

# Remove auto-start on boot
sudo rm /Library/LaunchDaemons/io.zettabrain.server.plist

# View logs
tail -f /opt/zettabrain/logs/server.log

Uninstall completely

# Remove the package
pipx uninstall zettabrain-rag

# Stop and remove service (Linux)
sudo systemctl stop zettabrain && sudo systemctl disable zettabrain
sudo rm -f /etc/systemd/system/zettabrain.service && sudo systemctl daemon-reload

# Stop and remove service (macOS)
sudo launchctl unload /Library/LaunchDaemons/io.zettabrain.server.plist
sudo rm -f /Library/LaunchDaemons/io.zettabrain.server.plist

# Remove all data, config, and vector index
sudo rm -rf /opt/zettabrain

Privacy

Privacy depends on your configuration:

Default setup is fully local. The setup wizard defaults to local storage and a localhost Ollama endpoint. Remote options are opt-in and clearly labelled during setup.

Document embeddings (vector index) are always stored locally regardless of storage configuration.

Configuration

Settings file: /opt/zettabrain/src/zettabrain.env

Supported Platforms

Links

• GitHub (source + installer scripts): https://github.com/zettabrain/zettabrain-rag
• PyPI: https://pypi.org/project/zettabrain-rag/
• Website: https://zettabrain.io
• Issues: https://github.com/zettabrain/zettabrain-rag/issues