rag-stack

在自有 VPC 里搭一套接内部知识库的私有问答助手

开源 🏷️定价信息待确认 ⏳ 访问状态待核验搜索知识 🍴 复刻 137 🐛 待处理 27 👀 关注 40

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1581

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类搜索知识

开发团队finic-ai

官网地址https://www.chatmyfiles.com

GitHubhttps://github.com/finic-ai/rag-stack

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言TypeScript

GitHub 星标★ 1581

上线时间2023-07-12 00:00:00

代码更新2026-10-12

仓库体积128.8 MB

本站数据更新2026-10-25

维护状态较活跃

收录时间2026-10-25

浏览次数0

项目介绍

rag-stack 是一个用 TypeScript 编写的开源项目，目标是在企业自有 VPC 内部署一套私有的类 ChatGPT 问答系统，并把它连接到组织内部知识库，充当“企业知识问答入口”。它解决的是企业既想用大模型问答能力、又不愿把内部文档和对话数据交给外部服务的问题。核心能力包括：基于检索增强生成（RAG）的问答流程，先从知识库检索相关片段再交给模型作答；支持 Llama 2、Falcon、GPT4All 等开源模型，可本地或私有环境运行；提供部署脚本与基础设施配置，便于在云上 VPC 内一键拉起整套服务。项目以 TypeScript 为主，前端与编排逻辑清晰，适合作为企业内部知识助手、文档检索问答的起步模板，也方便二次开发接入自有数据源和权限体系。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-25 · 当前星标 ★ 1581

使用教程

难度：进阶约 30 分钟部署方式：本地安装 8 步

环境要求

已安装 Git，能把仓库克隆到本地
一个可用的 Supabase 项目（用于存储用户数据）
本地有足够磁盘空间存放 gpt4all 模型文件
云端部署需准备对应云平台账号（GCP/AWS/Azure）与 Terraform 运行环境

安装与启动步骤

1克隆项目代码

把仓库下载到本地并进入目录，后续所有脚本都在仓库根目录下执行。
```
git clone https://github.com/finic-ai/rag-stack.git
cd rag-stack
```
2复制环境变量模板

分别从前端和后端的示例文件复制出 .env，不要直接修改示例文件本身。
```
cp ragstack-ui/local.env ragstack-ui/.env
cp server/example.env server/.env
```
3填写 Supabase 密钥

在 Supabase 控制台 Settings > API 找到项目 URL 与密钥，分别填入两个 .env 文件。
4创建用户表

在 Supabase 建 ragstack_users 表：id/app_id/secret_key 为 uuid，email/avatar_url/full_name 为 text。
5启动本地服务

脚本会把 gpt4all 模型下载到 server/llm/local/，并启动服务端、本地 LLM 与 Qdrant 向量库。
```
scripts/local/run-dev
```
6确认启动完成

终端出现 Application startup complete 即表示服务端、LLM 与向量库都已就绪。
7云端一键部署

GCP/AWS/Azure 各有 Terraform 脚本，AWS 为 scripts/aws/deploy-aws.sh，Azure 为 ./azure/deploy-aks.sh，按提示填写参数。
```
scripts/gcp/deploy-gcp.sh
```
8配置前端地址

云端部署后在 ragstack-ui 下新建 .env，把 VITE_SERVER_URL 设为后端服务或负载均衡地址。

关键配置

配置项	必填	说明	示例
`YOUR_SUPABASE_URL`	是	Supabase 项目 URL，服务端与前端两个 .env 都要填	`https://abcdefgh.supabase.co`
`YOUR_SUPABASE_KEY`	是	server/.env 中使用的 Supabase 密钥	`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxx`
`YOUR_SUPABASE_PUBLIC_KEY`	是	ragstack-ui/.env 中使用的 Supabase 密钥	`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxx`
`VITE_SERVER_URL`	否	云端部署时前端访问的后端服务地址	`https://ragstack-server.example.com`