
SolidGPT
让 AI 当你的代码库向导,一句话找到关键代码和上下文
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1795
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Git,用于拉取仓库代码
- 已安装 Python 环境(能执行 python 与 pip 命令)
- 已安装 Node.js 与 npm,用于运行 solidportal 前端
- 准备一个 OpenAI API Key,用于模型调用
安装与启动步骤
-
1克隆项目仓库
从 GitHub 拉取 SolidGPT 最新代码到本地,README 要求先获取最新版本源码。
git clone https://github.com/AI-Citizen/SolidGPT.git cd SolidGPT -
2安装 Python 依赖
在 SolidGPT 根目录下安装 requirements.txt 中列出的全部 Python 依赖包。
pip install -r requirements.txt -
3启动后端服务
在项目根目录运行 run_api.py 启动 API 服务,需保持该终端窗口不要关闭。
python run_api.py -
4安装前端依赖
新开一个终端,进入 solidportal 目录并安装 Web 前端所需的 npm 依赖。
cd solidportal npm install -
5启动前端应用
运行开发模式启动 Web 前端,按终端输出的地址在浏览器中访问。
npm run dev -
6配置 OpenAI API Key
打开 Web 界面后,点击右下角 Settings 按钮,在设置中填入你的 OpenAI API Key 以完成代码库接入。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OpenAI API Key | 是 | 在 Web 界面右下角 Settings 中填写,用于调用大语言模型。 | sk-xxxxxxxx |
如何确认成功
后端终端无报错并处于运行状态,前端 npm run dev 输出本地访问地址,浏览器打开该地址可看到 SolidGPT 界面。
常见问题
Q:可以直接用官方 VSCode 插件而不自己编译吗?
A:可以。README 强烈推荐直接从 VSCode Marketplace 安装 SolidGPT 扩展(aict.solidgpt),这是最快捷的使用方式。
Q:前端启动时提示找不到 npm 命令怎么办?
A:说明尚未安装 Node.js 与 npm,需先安装 Node.js 环境后再执行 npm install 与 npm run dev。
Q:后端和前端要同时运行吗?
A:是的。需要两个终端分别运行 python run_api.py 和 solidportal 目录下的 npm run dev,两者都保持运行状态。
Q:README 里没有写访问端口?
A:README 未给出固定端口,请以后端与前端的终端实际输出为准。
注意事项
- 项目官方声明从未发行任何加密货币,任何以该项目名义发行的加密货币均为骗局,请勿轻信。
- README 未给出具体端口、Python 版本和 Node 版本要求,若启动失败请检查本机环境版本。
- Settings 中填写 API Key 的完整步骤在 README 节选中被截断,仅确认入口在界面右下角 Settings 按钮。
核心亮点
- 构建代码知识图谱,支持跨文件语义搜索,比关键字搜索更精准
- 自动生成代码摘要和解释,降低新成员理解项目门槛
- 模块化架构,支持自定义数据源和模型,易于集成到现有工具链
不足之处
- 项目仍处于早期,API 和文档稳定性有待提升
- 对大型仓库的索引构建性能可能成为瓶颈
适用场景
- 新成员快速上手大型代码库
- 开发中快速定位相关代码和依赖关系
- 自动生成项目文档和代码注释
替代项目
Sourcegraph、Bloop、Cursor
上一篇:agent-safehouse
下一篇:slack-mcp-server
同类项目推荐
agents-office
开源
让 AI 智能体在虚拟办公室组队干活,还能实时围观
Agents Office v3 (Beta) — a headless office where AI agents do real work
DeepseekHarness-Android
开源
装个 APK,让 DeepSeek 智能体直接帮你操作手机
免 ROOT 免 Termux,一个 APK 在安卓手机上跑 DeepSeek Harness。引擎内嵌 App 进程 · 读···
SKILLS_All-in-one
开源
一站式技能库,让 AI 代理秒变多面手
Search, preview, and download open-source AI agent skills for Claude Code, Codex, Ch···
free4chat
开源
开个临时房间,拉人拉AI传文件,用完即走
Temporary rooms for Humans and AI Agents — run, supervise and steer Agent Tasks wit···
umadev
开源
指挥现有编码工具,像团队一样自动搞定复杂开发任务
UmaDev: A coding agent that works like a real dev team, commanding the Claude Code /···
muselab
开源
自托管 AI 工作台,复用订阅额度,文件、终端、预览一站式搞定。
基于Claude Agent SDK构建的自托管Agent原生工作台,可以复用Claude、ChatGPT订阅额度。集···
Marinara-Engine
开源
在前端直接跑AI智能体,本地优先免后端
AI frontend
anton
开源
让 AI 同事自动干活,还能越用越聪明
self-improving agent
alfred-dev
开源
给 Claude Code 装上专业团队,自动跑完开发全流程
Tu equipo de desarrolladores en un plugin. 10 agentes, 11 skills planas, 18 comandos···