ZettaBrain RAG

ZettaBrain RAG 技能 使用本地 AI 与自己的文档聊天。文档数据在使用本地存储和本地 Ollama 端点（默认）时保持在您的机器上。远程存储（S3、NFS、SMB）和远程 OLLAMA_HOST 是可选的，会将数据移出设备 — 查看隐私部分。支持 PDF、DOCX、TXT、Markdown。适用于 Linux、macOS（包括 EC2 Mac Apple Silicon）和 Windows。 源代码：https://github.com/zettabrain/zettabrain-rag（MIT） 安装脚本：https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh | install.ps1 PyPI：https://pypi.org/project/zettabrain-rag/ 推荐安装 — pipx（无提升权限，完全可检查） pipx install zettabrain-rag sudo zettabrain-setup 一行安装器（在运行前查看源代码） 安装脚本是开源的，可以在上述链接中审计，然后执行。 # Linux — 查看后：https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh curl -fsSL https://zettabrain.app/install.sh | sudo bash # macOS — 查看后：https://github.com/zettabrain/zettabrain-rag/blob/main/install.sh curl -fsSL https://zettabrain.app/install.sh | bash # Windows — 查看后：https://github.com/zettabrain/zettabrain-rag/blob/main/install.ps1 irm https://zettabrain.app/install.ps1 | iex Linux 安装器需要 sudo 来安装 Ollama 系统范围内并注册一个 systemd 服务。macOS 安装器不需要 sudo 来安装包。 设置 安装后运行一次交互式设置向导： sudo zettabrain-setup 这将： 配置您的文档存储（本地、NFS、SMB 或 S3） 安装并启动 Ollama 本地 为您的硬件拉取推荐的 AI 模型 生成一个自签名的 TLS 证书（保持在设备上） 注册 ZettaBrain 为一个后台服务（查看服务管理以停止或删除它） 命令 命令 描述 zettabrain-chat 与文档交互式聊天的 CLI zettabrain-server 启动 web GUI 服务器（HTTPS 端口 7860） zettabrain-ingest 将文档索引到向量存储中 zettabrain-ingest --rebuild 删除并重新索引所有文档 zettabrain-status 显示 Ollama、向量存储和存储状态 zettabrain-storage add 添加一个额外的存储源 zettabrain-setup 重新运行设置向导 使用示例 通过 CLI 聊天：zettabrain-chat # > 我们的 Q3 报告中关于云成本的内容是什么？ 启动 web GUI（https://localhost:7860）：zettabrain-server 索引一个特定的文件夹：ZETTABRAIN_DOCS=/path/to/docs zettabrain-ingest 向量存储 — 位置、保留和删除 向量索引（文档嵌入）仅存储在您的本地机器上： 项目 位置 向量数据库 /opt/zettabrain/src/zettabrain_vectorstore/ 索引日志（MD5 哈希） /opt/zettabrain/src/ingested_files.json 配置 /opt/zettabrain/src/zettabrain.env 嵌入永远不会传输到任何远程服务。它们是从您的文档中导出的并存储在 ChromaDB 中的本地。 删除向量索引： # 通过 CLI zettabrain-server & curl -X DELETE http://localhost:7860/api/vectorstore # 或直接 rm -rf /opt/zettabrain/src/zettabrain_vectorstore rm -f /opt/zettabrain/src/ingested_files.json 从头开始重建：zettabrain-ingest --rebuild 通过不包含在 ZETTABRAIN_DOCS 中来排除文件或文件夹 — 只有该路径下的文件被索引。 服务管理 ZettaBrain 注册一个后台服务，因此 web GUI 在启动时自动启动。以下是如何控制或完全删除它： Linux（systemd） # 停止服务 sudo systemctl stop zettabrain # 禁用自动启动 sudo systemctl disable zettabrain # 查看状态 sudo systemctl status zettabrain # 查看日志 journalctl -u zettabrain -f # 完全删除服务 sudo systemctl stop zettabrain sudo systemctl disable zettabrain sudo rm /etc/systemd/system/zettabrain.service sudo systemctl daemon-reload macOS（launchd） # 停止服务 sudo launchctl unload /Library/LaunchDaemons/io.zettabrain.server.plist # 删除自动启动 sudo rm /Library/LaunchDaemons/io.zettabrain.server.plist # 查看日志 tail -f /opt/zettabrain/logs/server.log 完全卸载 # 删除包 pipx uninstall zettabrain-rag # 停止并删除服务（Linux） sudo systemctl stop zettabrain && sudo systemctl disable zettabrain sudo rm -f /etc/systemd/system/zettabrain.service && sudo systemctl daemon-reload # 停止并删除服务（macOS） sudo launchctl unload /Library/LaunchDaemons/io.zettabrain.server.plist sudo rm -f /Library/LaunchDaemons/io.zettabrain.server.plist # 删除所有数据、配置和向量索引 sudo rm -rf /opt/zettabrain 隐私 隐私取决于您的配置： 配置 数据保持本地？ 本地存储 + OLLAMA_HOST=http://localhost:11434（默认） ✅ 是 — 完全在设备上 NFS 或 SMB 网络存储 ⚠️ 文档通过您的 LAN 获取 S3 / 对象存储 ⚠️ 文档从云存储中流式传输 远程 OLLAMA_HOST ⚠️ 查询和检索的文档块发送到远程