LangAlpha

环境要求

• 已安装 Docker（用于运行 PostgreSQL、Redis、后端与前端等基础设施）
• 已安装 git 与 make
• 自备一个大语言模型（LLM）的 API 订阅/密钥，用于驱动智能体
• 无需任何数据源密钥也能启动，但功能会有所缩减（可选）

安装与启动步骤

1. 1克隆仓库

   从 GitHub 拉取 LangAlpha 源码到本地，README 给出的仓库地址为 ginlix-ai/langalpha。

   git clone https://github.com/ginlix-ai/langalpha.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的项目根目录，后续的 make 命令都要在此目录执行。

   cd langalpha

   复制

3. 3运行配置向导

   交互式向导会生成 .env，并配置 LLM、数据源、沙箱与搜索服务；可选密钥可暂时跳过或稍后手动补进 .env。

   make config

   复制

4. 4启动全部服务

   一条命令拉起 PostgreSQL、Redis、后端与前端，首次执行需要拉取镜像与依赖，耗时较长。

   make up

   复制

5. 5验证服务状态

   调用后端健康检查接口，返回正常即说明后端已就绪；前端页面可直接在浏览器打开。

   curl http://localhost:8000/health

   复制

关键配置

如何确认成功

执行 curl http://localhost:8000/health 返回正常，并可在浏览器打开 http://localhost:5173 看到前端界面。

常见问题

注意事项

• 仅凭 Docker 即可启动，无需数据源密钥和云沙箱，但无密钥时体验功能会缩减。
• 前端默认地址 http://localhost:5173，后端 API 为 http://localhost:8000，交互式 API 文档在 /docs。
• 可选密钥可在 make config 时填入，也可稍后手动追加到 .env 中。
• make up 会启动 PostgreSQL、Redis、后端和前端四个组件，请确认这些端口未被占用。