📝 docs: optimize local development setup

This commit is contained in:
4pmtong 2026-01-13 23:15:11 +08:00
parent 836c0c7ba4
commit 214345884a
8 changed files with 1072 additions and 725 deletions

View file

@ -21,10 +21,15 @@
---
### 快速开始Docker 推荐)
前置要求:已安装 Docker Desktop。
#### 前置要求
- **Docker Desktop**:已安装并运行
- **Python**3.10.*(推荐使用 3.10.15
- **Node.js**>=18.0.0 <23.0.0
#### 启动步骤
1) 启动服务
-
```bash
cd server
# 复制 .env.example 为 .env(或者按照.env.example的格式创建.env)
@ -83,8 +88,11 @@ docker logs -f eigent_postgres | cat
# 1) 停止容器中的 API 服务,仅保留数据库
docker stop eigent_api
# 2) 本地启动(需提供数据库连接串
# 2) 初始化数据库(首次或数据库结构变更时
cd server
uv run alembic upgrade head
# 3) 本地启动(需提供数据库连接串)
# 方式 A在当前 shell 导出环境变量
export database_url=postgresql://postgres:123456@localhost:5432/eigent
uv run uvicorn main:api --reload --port 3001 --host 0.0.0.0
@ -107,4 +115,4 @@ uv run pybabel init -i messages.pot -d lang -l zh_CN
uv run pybabel compile -d lang -l zh_CN
```
如需完全离线环境,请仅使用本地模型与本地 MCP 服务器,并避免配置任何外部 Provider 与远程 MCP 地址。
如需完全离线环境,请仅使用本地模型与本地 MCP 服务器,并避免配置任何外部 Provider 与远程 MCP 地址。