手动部署

系统要求

• Python 3.11+
• PostgreSQL 14+（推荐 16+，需要 pgvector 扩展）
• Node.js 18+（仅前端开发需要）

安装步骤

1. 安装后端

git clone https://github.com/openvort/openvort.git
cd openvort
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

2. 配置数据库

# 安装 PostgreSQL
# 创建数据库
createdb openvort

# 安装 pgvector 扩展（知识库需要）
psql openvort -c "CREATE EXTENSION IF NOT EXISTS vector"

3. 配置环境变量

cp .env.example .env
# 编辑 .env

4. 启动服务

openvort start --web

5. 前端开发（可选）

cd web
pnpm install
pnpm dev

使用 systemd 管理

创建 /etc/systemd/system/openvort.service：

[Unit]
Description=OpenVort AI Engine
After=network.target postgresql.service

[Service]
Type=simple
User=openvort
WorkingDirectory=/opt/openvort
ExecStart=/opt/openvort/.venv/bin/openvort start --web
Restart=always

[Install]
WantedBy=multi-user.target