eval_752
  • 简体中文

      • 安装指南

      更详细的 eval_752 安装说明。

      Docker 安装（推荐）

      对大多数用户来说，Docker 是最省事的安装方式。

      前置条件

      • 已安装并启动 Docker Desktop
      • 分配给 Docker 至少 4GB 内存
      • 分配给 Docker 至少 2 个 CPU 核心

      步骤

      # Clone 仓库
git clone https://github.com/t41372/eval_752.git
cd eval_752

# 创建环境文件
cp .env.example .env

# 生成加密密钥
openssl rand -hex 32  # 把输出写到 .env 的 ENCRYPTION_KEY

# 启动全部服务
docker compose up --build -d

# 验证安装
curl http://localhost:8000/healthz
# 预期: {"status":"ok"}

# 打开 Web UI
open http://localhost:5173

      完整的首次运行路径见 Quick Start。

      本地开发安装

      适合贡献者和开发者，希望不通过 Docker 直接运行 eval_752。

      前置条件

      • Python 3.12 或更高
      • Node.js 20 或更高
      • PostgreSQL 14 或更高
      • Redis 7 或更高
      • pnpm
      • 用于 Python 依赖管理的 Astral uv

      后端设置

      cd backend

# 如果尚未安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装依赖
uv sync --extra dev

# 初始化数据库
createdb eval752

# 跑迁移
uv run alembic upgrade head

# 启动 API
uv run uvicorn eval_752.app.main:app --reload

      前端设置

      cd frontend

# 如果尚未安装 pnpm
npm install -g pnpm

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

      Workers

      另开终端：

      cd backend

# 启动 Celery worker
uv run celery -A eval_752.workers.app worker --loglevel=info

# 再开一个终端启动 Celery beat
uv run celery -A eval_752.workers.app beat

      生产部署

      生产部署策略见 Deployment Guide。

      下一步