跳到主要内容

安装指南

本指南将帮助你安装和配置 TestGPT 项目。TestGPT 是一个基于 Browser Use 的智能 Web 自动化测试工具，支持语义化测试用例编写和详细的测试结果记录。

📋 系统要求​

在开始安装之前，请确保你的系统满足以下要求：

  • Node.js: 18+
  • Python: 3.11+
  • Playwright: 浏览器自动化框架
  • FastAPI: Web 框架
  • SQLAlchemy: 数据库 ORM

🛠️ 快速开始​

1. 克隆项目​

git clone https://gitee.com/enation-inc/TestGPT.git
cd TestGPT

2. 安装前端依赖​

npm install
cd frontend
npm install

3. 安装后端依赖​

推荐使用 uv 进行依赖管理：

uv venv 
source .venv/bin/activate

uv sync --all-extras

# 安装默认浏览器
playwright install chromium --with-deps --no-shell

4. 启动服务​

开发模式（同时启动前后端）​

npm run dev

分别启动​

# 启动后端API服务
npm run dev:backend

# 启动前端开发服务器
npm run dev:frontend

🐳 Docker 部署​

使用 Docker Compose​

配置文件 docker/config.env 中的 VITE_API_BASE_URL=http://ip:8000/api 为后端服务的 API 地址

cd docker
docker-compose -f docker-aliyun.yml up -d

🌐 访问应用​

安装完成后，你可以通过以下地址访问应用：

🔧 常见问题​

1. 依赖安装失败​

问题: npm install 或 uv sync 失败

解决方案:

# 清除缓存
npm cache clean --force

# 使用镜像源
npm config set registry https://registry.npmmirror.com

2. Playwright 浏览器安装失败​

问题: playwright install 失败

解决方案:

# 设置代理（如果需要）
export https_proxy=http://127.0.0.1:7012 
export http_proxy=http://127.0.0.1:7012 
export all_proxy=socks5://127.0.0.1:7012

# 重新安装
playwright install chromium --with-deps --no-shell

3. 端口被占用​

问题: 3000 或 8000 端口被占用

解决方案:

# 查看端口占用
lsof -i :3000
lsof -i :8000

# 杀死占用进程
kill -9 <PID>

4. uv 安装失败​

问题: uv 命令不存在

解决方案:

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 或者使用 pip 安装
pip install uv

📚 下一步​

安装完成后，你可以：

注意: 请确保在使用前配置正确的 API 密钥和数据库连接信息。