neo-chat

本地跑的多模型 AI 工作台,聊天、搜索、RAG、插件一站搞定

开源 🏷️定价信息待确认 ⚠️ 链接可跳转,访问体验不确定 对话助手 🍴 复刻 627 🐛 待处理 13 👀 关注 10
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1882
维护状态 较活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

neo-chat 项目界面预览图
图片来源:项目官网

项目数据

分类对话助手
开发团队u14app
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⚠️ 链接可跳转,访问体验不确定
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai,ai-chat,gemini,openai,skills
GitHub 星标★ 1882
上线时间2023-12-27 00:00:00
代码更新2026-11-01
仓库体积10.5 MB
本站数据更新2026-11-15
维护状态较活跃
收录时间2026-10-02
浏览次数1

项目介绍

neo-chat 是一个本地优先的 AI 对话工作台,把模型对话、智能体、技能、插件、联网搜索、RAG 知识库、语音、记忆和产物(artifacts)整合进同一个界面。它解决的是市面上多数 AI 客户端功能单一、数据必须上传云端、难以同时管理多个模型和工具的问题。核心能力包括:支持 OpenAI、Gemini 等多种模型接入,可自由切换;内置 Agent 与 Skills 机制,让模型按需调用工具完成复杂任务;支持插件扩展和联网搜索,弥补模型知识时效性不足;通过 RAG 把本地文档变成可检索的知识来源;语音输入输出和长期记忆让对话更接近真人助理;artifacts 面板可实时预览代码、文档等生成结果。整体定位是给开发者和重度 AI 用户一个可自托管、可扩展、数据留在本地的统一入口。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1882

技术标签

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • Node.js 24
  • pnpm 10.30.3(通过 Corepack 启用)
  • Git(用于克隆仓库)
  • Docker(可选,用于免源码运行官方镜像)

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 克隆 neo-chat 源码并进入项目目录,后续所有命令都在该目录执行。

    git clone https://github.com/u14app/neo-chat.git
    cd neo-chat
  2. 2安装依赖

    使用 Corepack 调起 pnpm,按锁文件安装依赖,保证版本与项目一致。

    corepack pnpm install --frozen-lockfile
  3. 3配置环境变量

    可选。应用内 Settings 已能配置大部分选项,只有需要部署级默认值时才复制示例文件。

    cp .env.example .env.local
  4. 4启动开发服务

    启动本地开发服务器,默认监听 3000 端口,等待终端提示就绪。

    corepack pnpm dev
  5. 5配置模型并对话

    浏览器打开 localhost:3000,在 Settings 里添加模型提供商和 API Key,然后开始对话。

  6. 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. 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 ···

★ 562 2026-11-04
chatgpt-wecom 开源

把 ChatGPT 接入企业微信,让员工在内部直接对话 AI

企业微信 chatgpt 对话

★ 130 2026-08-09
whatsapp-agentkit 开源

访谈式生成代码,30 分钟搭出 WhatsApp AI 客服

Construye tu agente de WhatsApp con IA en menos de 30 minutos. Claude Code te entrev···

★ 568 2026-10-31
tmuxai 开源

在 tmux 里随时唤起 AI,不打断终端工作流

AI-Powered, Non-Intrusive Terminal Assistant

★ 1974 2026-08-09
maxapi 开源

用 Python 快速开发 MAX 聊天机器人,异步高效省心

Библиотека по разработке чат-ботов для мессен···

★ 232 2026-08-09
Gemini-Pro 开源

把 Google AI Studio 包装成安卓原生应用,用起来更顺手

WebView Application Google AI Studio with Additional Functionality

★ 81 2026-08-09
chatgpt-bot-telegram 开源

在 Telegram 里直接和 GPT 聊天、生成图片

Telegram AI bot with OpenAI Responses API, image generation, tested command handlers···

★ 141 2026-10-15
alfred-chathub 开源

在 Alfred 里直接聊 GPT、Gemini,无需切换应用

A chat alfred-workflow that integrates multiple popular large language model (LLM) s···

★ 56 2026-08-09
Bard 开源

用 Python 调起 Google Bard,快速集成对话能力

Python SDK/API for reverse engineered Google Bard

★ 1387 2026-08-09