项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1882
使用教程
环境要求
- Node.js 24
- pnpm 10.30.3(通过 Corepack 启用)
- Git(用于克隆仓库)
- Docker(可选,用于免源码运行官方镜像)
安装与启动步骤
-
1克隆仓库
从 GitHub 克隆 neo-chat 源码并进入项目目录,后续所有命令都在该目录执行。
git clone https://github.com/u14app/neo-chat.git cd neo-chat -
2安装依赖
使用 Corepack 调起 pnpm,按锁文件安装依赖,保证版本与项目一致。
corepack pnpm install --frozen-lockfile -
3配置环境变量
可选。应用内 Settings 已能配置大部分选项,只有需要部署级默认值时才复制示例文件。
cp .env.example .env.local -
4启动开发服务
启动本地开发服务器,默认监听 3000 端口,等待终端提示就绪。
corepack pnpm dev -
5配置模型并对话
浏览器打开 localhost:3000,在 Settings 里添加模型提供商和 API Key,然后开始对话。
-
6Docker 免源码运行
不克隆源码时,直接用官方镜像启动,需自行设置访问密码;示例中的加密密钥是临时的。
docker run --rm -p 127.0.0.1:3000:3000 \ -e ACCESS_PASSWORD='replace-with-a-strong-password' \ -e BYOK_ALLOW_EPHEMERAL_KEY=true \ ghcr.io/u14app/neo-chat:latest -
7部署到 Cloudflare
先构建 Worker 产物,再执行部署脚本;脚本会用 --keep-vars 保留控制台变量。
corepack pnpm build:worker corepack pnpm deploy:worker
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ACCESS_PASSWORD | 是 | Docker 方式启动时的界面访问密码 | replace-with-a-strong-password |
BYOK_ALLOW_EPHEMERAL_KEY | 否 | 允许使用临时凭证加密密钥,仅适合本地试跑 | true |
.env.local | 否 | 部署级默认值配置文件,由 .env.example 复制而来 | .env.local |
如何确认成功
浏览器打开 http://localhost:3000 能看到界面;Docker 方式输入访问密码后即可进入并开始对话。
常见问题
Q:需要什么运行环境?
A:本地运行需要 Node.js 24 和 pnpm 10.30.3(通过 Corepack 启用),克隆后按 README 的四条命令即可跑起来。
Q:不想克隆源码可以吗?
A:可以。直接 docker run 官方镜像 ghcr.io/u14app/neo-chat:latest,设置访问密码后打开 localhost:3000 输入密码即可。
Q:不创建 .env.local 会有问题吗?
A:不会。多数选项在应用内 Settings 里就能配置,.env.local 只用于设置部署范围的默认值。
Q:Docker 示例里的临时密钥有什么风险?
A:重启或多副本之间密钥会轮换,生产使用前应配置稳定的 BYOK 密钥,避免解密失败。
Q:还能部署到哪里?
A:Vercel 用 Next.js 预设和默认输出目录导入仓库;Cloudflare Workers 执行 build:worker 后再 deploy:worker。
注意事项
- Docker 示例使用临时凭证加密密钥,生产前务必配置稳定的 BYOK 密钥。
- 生产部署前请按部署指南配置访问保护与共享运行时存储。
- 公开的多实例部署应使用稳定密钥和共享存储,单进程只有临时密钥与内存限流回退。
核心亮点
- 本地优先架构,对话与知识库数据可留在自己机器上,隐私可控
- 多模型统一接入,OpenAI、Gemini 等可切换,不绑定单一厂商
- Agent、Skills、插件、RAG、语音、记忆、artifacts 功能集成度高,省去拼装多个工具
不足之处
- 功能模块多,首次配置模型密钥、插件和 RAG 流程有一定学习成本
- 项目处于成长期,文档和社区生态相比头部项目仍待完善
适用场景
- 开发者本地搭建私有 AI 助手,接入自己的 API Key 和知识库
- 需要同时对比多个模型回答效果的研究与写作场景
- 用 Agent 和插件自动完成搜索、整理、生成代码或文档的日常任务
替代项目
LibreChat、Lobe Chat
上一篇:raganork-md
下一篇:AIKON
同类项目推荐
openchat-monorepo
开源
一套代码多端跑的 AI 聊天应用基座
一个现代化的全栈 AI Chatbot 应用,使用 React 和 Cloudflare Workers 结合 Connect RPC ···
chatgpt-wecom
开源
把 ChatGPT 接入企业微信,让员工在内部直接对话 AI
企业微信 chatgpt 对话
whatsapp-agentkit
开源
访谈式生成代码,30 分钟搭出 WhatsApp AI 客服
Construye tu agente de WhatsApp con IA en menos de 30 minutos. Claude Code te entrev···
tmuxai
开源
在 tmux 里随时唤起 AI,不打断终端工作流
AI-Powered, Non-Intrusive Terminal Assistant
maxapi
开源
用 Python 快速开发 MAX 聊天机器人,异步高效省心
Библиотека по разработке чат-ботов для мессен···
Gemini-Pro
开源
把 Google AI Studio 包装成安卓原生应用,用起来更顺手
WebView Application Google AI Studio with Additional Functionality
chatgpt-bot-telegram
开源
在 Telegram 里直接和 GPT 聊天、生成图片
Telegram AI bot with OpenAI Responses API, image generation, tested command handlers···
alfred-chathub
开源
在 Alfred 里直接聊 GPT、Gemini,无需切换应用
A chat alfred-workflow that integrates multiple popular large language model (LLM) s···
Bard
开源
用 Python 调起 Google Bard,快速集成对话能力
Python SDK/API for reverse engineered Google Bard
