Video Processing Toolkit

An open-source, self-hostable video processing system built with Node.js, Hono, Zod, and BullMQ. Upload a video, get transcription, subtitles, AI, chapter markers, and thumbnails.

• Video transcription (OpenAI Whisper, Deepgram)
• AI-powered video analysis and summarization (OpenAI, Claude)
• Automatic chapter generation
• Background job processing with BullMQ
• REST API + Nuxt 3 web interface
• Docker-based deployment with automatic HTTPS

cp .env.example .env
# Add your OPENAI_API_KEY to .env
docker compose up

• API: http://localhost:3000
• Web: http://localhost:3001

npm install
npx turbo dev

.
├── apps/
│   ├── api/        # Hono REST API (port 3000)
│   ├── worker/     # BullMQ video processor
│   └── web/        # Nuxt 3 frontend (port 3000)
├── packages/
│   ├── shared/     # Types, schemas, constants
│   └── providers/  # AI provider implementations
└── deploy/         # Deployment scripts

• API: Hono, Drizzle ORM, BullMQ
• Web: Nuxt 3, Tailwind CSS
• AI: OpenAI (Whisper + GPT), Anthropic Claude, Deepgram
• Infra: Docker, Caddy, PostgreSQL, Redis

Any Ubuntu/Debian VPS with 2 vCPU and 4 GB RAM or larger.

ssh root@your-server-ip
curl -fsSL <raw-setup-url> | bash
# Or clone the repo first, then:
bash deploy/setup.sh

This installs Docker, creates the vpt user, sets up data directories, and configures the firewall.

su - vpt
git clone <repo-url> ~/app && cd ~/app
cp .env.example .env
nano .env  # Set DOMAIN, POSTGRES_PASSWORD, REDIS_PASSWORD, OPENAI_API_KEY, SESSION_SECRET
bash deploy/update.sh

Caddy automatically provisions TLS certificates for your domain.

cd ~/app
bash deploy/update.sh

bash deploy/backup.sh

# Automate with cron (daily at 3 AM):
# 0 3 * * * /home/vpt/app/deploy/backup.sh >> /var/log/vpt-backup.log 2>&1

See .env.example for all available configuration options.

MIT