本地开发

环境

• Python 3.12
• 可选：PostgreSQL 16（本地开发也可用 SQLite）
• 可选：ffmpeg（压缩功能）、sing-box（非 SOCKS / HTTP 代理节点）
• Node.js 20+（仅编辑本文档站时需要）

启动

git clone https://github.com/trageeker/assemblyai-hub.git
cd assemblyai-hub
python -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt

使用 SQLite 快速启动：

export DATABASE_URL=sqlite+aiosqlite:///./dev.db
export SECRET_KEY=dev-secret
export ADMIN_PASSWORD=admin
uvicorn app.main:app --reload --port 8000

或使用 Docker 中的 PostgreSQL：

docker run -d --name hub-pg -e POSTGRES_USER=hub -e POSTGRES_PASSWORD=hub -e POSTGRES_DB=hub -p 5432:5432 postgres:16-alpine
export DATABASE_URL=postgresql://hub:hub@localhost:5432/hub

打开 http://localhost:8000/admin。表结构在启动时自动创建。

TIP

SQLite 只用于本地开发和调试。生产环境请使用 PostgreSQL。

用本地代码构建镜像

docker compose up -d --build

代码规范

ruff check app --select F,E9,B --ignore B008,B904

• 面向用户的字符串一律用中文原文包在 _() 中，英文翻译写进 app/i18n_en.py（见 国际化）。
• 新增环境变量时，同时更新 app/config.py 的 public_env()、.env.example 和本文档的 环境变量 页。