快速上手
#2. 快速上手
#2.1 环境要求
| 依赖 | 最低版本 | 用途 | 获取方式 |
|---|---|---|---|
| Python | 3.13+ | 后端运行时 | python.org |
| uv | 最新 | Python 包管理器 | `curl -LsSf https://astral.sh/uv/install.sh |
| Node.js | 22+ | 前端运行时 | nodejs.org |
| pnpm | 最新 | 前端包管理器 | npm install -g pnpm |
| PostgreSQL | 16+ (pgvector) | 数据持久化 | postgresql.org |
#2.2 启动后端服务
hljs bash
# 1. 克隆仓库
git clone https://github.com/ThreeFish-AI/negentropy.git
cd negentropy
# 2. 进入后端目录
cd apps/negentropy
# 3. 安装依赖
uv sync --dev
# 4. 生成用户级配置文件（首次）
uv run negentropy init # 写入 ~/.negentropy/config.yaml
# 5. 配置密钥/敏感项（通过 shell 环境变量或 config.local.yaml）
# export NE_DB_URL=postgresql+asyncpg://user:pass@localhost:5432/negentropy
# export OPENAI_API_KEY=your-openai-key
# export ANTHROPIC_API_KEY=your-anthropic-key
# 模型 vendor（OpenAI / Anthropic / Gemini 等）通过 Interface → Models 页动态配置
# 6. 应用数据库迁移
uv run alembic upgrade head
# 7. 启动引擎（开发模式，支持热重载，默认端口 3292）
uv run negentropy serve
后端服务启动后可访问
http://localhost:3292，API 文档自动生成于/docs。
#2.3 启动前端界面
hljs bash
# 在新终端窗口中执行
cd apps/negentropy-ui
# 1. 安装依赖
pnpm install
# 2. 启动开发服务器
pnpm run dev
前端启动后访问
http://localhost:3192即可进入 Negentropy 主界面。
#2.4 首次对话
打开浏览器访问 http://localhost:3192，你会看到三栏布局的对话界面：
- 左侧：Session 列表（当前为空）
- 中间：聊天区域 + 底部输入框（Composer）
- 右侧：调试面板（可点击右上角按钮展开）
在底部输入框中输入你的第一条消息，系统会自动创建 Session 并开始与 Agent 对话。
详细的环境搭建与故障排查，请参阅 开发指南。