Valstorm Dedicated Video Worker (valstorm-video-worker)
Dedicated asynchronous microservice for multi-preset FFmpeg video transcoding, Deepgram/Whisper speech-to-text captions, and AI chapter generation.
Offload heavy media processing from your web servers. valstorm-video-worker consumes jobs from Redis/Valkey queues (valstorm:queue:video), transcodes video streams via FFmpeg, extracts audio tracks for Deepgram Nova-3 or Whisper transcription, generates SEO titles and YouTube chapters with multimodal AI, and syncs records via valstorm-client.
1. Launch the Video Queue Worker & Healthcheck Server
# 1. Clone the repository and sync dependencies via uv
git clone https://github.com/Valstorm-Corp/valstorm-video-worker.git
cd valstorm-video-worker
uv sync
# 2. Start the Redis queue consumer and port 8080 /health server
uv run python -m main
2. How valstorm-video-worker Works Under the Hood
📥 Redis Queue (valstorm:queue:video)
│
▼
🎬 Valstorm Video Worker (main.py + /health :8080)
├── 1. Multi-Preset FFmpeg Transcoder (fast_copy, balanced, compressed)
├── 2. Audio Track Extraction -> Deepgram Nova-3 / Whisper ASR Captions
├── 3. Multimodal AI Metadata (Titles, Summaries, YouTube Chapters)
└── 4. Platform Sync via valstorm-client (ServiceKeyAuth) 3. Core Capabilities & Technical Specifications
Resilient Multi-Preset FFmpeg Engine
Supports stream-copy remuxing (fast_copy), balanced H.264/AAC encoding, and high-compression presets with automatic container fallback.
Automated Transcription & Captioning
Extracts clean audio channels and generates word-level transcripts and VTT/SRT captions using Deepgram Nova-3 or local Whisper.
AI Chapter & Metadata Synthesis
Turns raw video recordings and VSL audits into structured chapters, executive summaries, and searchable CRM records.
1:1 Valstorm Platform Synchronization
Updates video status, transcript fields, and VFS file attachments automatically via the official valstorm-client Python SDK.
4. Open-Source & Commercial Licensing
PolyForm Noncommercial License 1.0.0
Free to clone, inspect, modify, and run for personal projects, educational study, and noncommercial research under the PolyForm Noncommercial License 1.0.0.
Valstorm Commercial License
Commercial use in business operations is included automatically with any active Valstorm BOS workspace ($25/mo in usage credits with $0/seat tax) or available via enterprise BYOC licensing.
5. Frequently Asked Questions
How does valstorm-video-worker authenticate with the Valstorm API?
It uses machine-to-machine ServiceKeyAuth (vst_sk_...) from the valstorm-client Python SDK to update records and upload processed media artifacts.
Explore Other Valstorm Open-Source Packages
View All 7 Tools →Enterprise-grade autonomous AI execution runtime, ReAct loop, and parallel subagent swarm engine for developer workstations, CI pipelines, and remote team automation.
Command-line interface for Valstorm developers to authenticate via OAuth2 PKCE, pull and push object schemas as code, and manage local workspaces.
Stateless Streamable HTTP, SSE, and stdio Model Context Protocol (MCP) server exposing 16 granularly scoped Valstorm VFS, SQL, and CRM tools.
High-performance web scraping, domain crawling, RSS monitoring, and visual diff microservice with Python 3.14 native Zstandard compression.
Official typed Python 3.13+ SDK with 1:1 PlatformContext parity across records, SQL/GraphQL queries, VFS Knowledge Vaults, schemas, and sandboxes.
Pure Python standard-library secret redaction engine that strips API keys, JWTs, database passwords, and environment secrets before logs or LLM prompts egress.