Thalx — System Architecture

Content-to-reels pipeline · VPS Hetzner + Vercel + AWS Lambda + Google AI
LIVE · 2026-03-27
🌐

Frontend

Vercel · SvelteKit 5 · Tailwind v4

app.thalx.io

App principal. Dashboard, process wizard, jobs, results. BFF pattern — API routes como proxy.

SvelteKit 5 · Vercel

thalx.io

Landing page. Proyecto thalx-web-page-gwuj. Root domain fixed via Cloudflare A record → 76.76.21.21

Astro · Vercel

Auth

Supabase Auth SSR. locals.supabase + locals.user desde hooks.server.ts. Nunca browser clients.

Supabase SSR
▼
⚙️

Backend

VPS Hetzner · FastAPI · arq workers

FastAPI Server

~/thalx-web-app/backend/. Dispatch endpoint encola jobs en arq. Worker timeout 1200s.

Python 3.12 · FastAPI

Pipeline Workers

11 pasos async: ingestion → transcription → analysis → scripting → TTS → footage → render → publish.

arq · async

Footage Workers

3 modos: source_video (FFmpeg crop), ai_images (NB2 + Ken Burns), ai_video (Veo 2.0).

Veo · NB2 · FFmpeg

TTS

ElevenLabs eleven_flash_v2_5. Voz SquadFemale1 (TrPg245Ccy3ZVaJq7MO7). language_code=es.

ElevenLabs API
▼
🎬

Render Layer

AWS Lambda · Remotion 4.0 · FFmpeg

Remotion Lambda

Function: remotion-render-*. 3008MB RAM, 600s timeout. framesPerLambda=20. Site: thalx-remotion.

AWS Lambda · us-east-1

Compositions

FullReel (portrait/landscape), MotionGraphic, ContentCards, ScreencastScene, ImageSlideshow.

React · Remotion

FFmpeg Pipeline

Concat audio (re-encode), ASS captions word-by-word, xfade, split-screen compose. Fallback de Remotion.

FFmpeg 6.1

S3 Storage

Bucket: remotionlambda-useast1-i9f1yk1a1a. Renders temporales. IAM user: remotion-lambda.

AWS S3
▼
🧠

AI Services

Google AI · Pikzels · ElevenLabs

Gemini / NB2

Nano Banana 2 (gemini-3.1-flash-image-preview). Imágenes consistentes con referencia facial. 43 fotos Roberto.

GOOGLE_THUMB_API_KEY

Veo 2.0

Video generation text-to-video. 5-8s clips. $0.15/s. allow_all para personas. Download requiere API key en URL.

Google AI Studio

Pikzels

Thumbnails profesionales. Personas: Roberto (847db146), Valeria (ca29b0ca). Score CTR. pkz_4 model.

PIKZELS_KEY

Claude Sonnet

Analysis, script generation, perspectivas. Via Anthropic API o Claude Agent SDK.

Claude API
▼
💾

Data & Storage

Supabase · Cloudflare · VPS

Supabase

Auth SSR + Storage (job-files bucket) + Postgres. Pooler: aws-1-us-east-1.

Postgres + Auth

VPS Hetzner

4CPU/8GB/150GB. IP 178.104.101.213. Backend, bots, playgrounds, Whisper, FFmpeg.

Ubuntu · systemd

Cloudflare

DNS + SSL Origin Certificate (*.digitalhubassist.ai, válido hasta 2041). Full (Strict) mode.

SSL + CDN

Playgrounds

Nginx sirve desde ~/playgrounds/. Reports, dashboards, audio, video assets.

playgrounds.digitalhubassist.ai
📡

Distribution

YouTube · Creatify · HeyGen

YouTube

Data API v3. Upload resumable, publish, outlier detector. API Key renovada 2026-03-26.

YOUTUBE_API_KEY

Creatify

UGC avatars (Valeria). Lip sync + backgrounds. Template mode. Upload Audio vía ElevenLabs.

Web UI only

ScrapeCreators

Trending research: Reddit, TikTok, IG, YouTube Search, Google. Dev tier activo.

SCRAPE_CREATORS

Pipeline de 11 pasos

Step 1

Ingestion

yt-dlp + proxy, file upload, PDF

Step 2

Transcription

faster-whisper small, CPU, int8

Step 3

Analysis

Claude Sonnet → hooks, quotes

Step 4a

Script (Content)

Narración, pacing, beats

Step 4b

Script (Visual)

Visual intent, footage queries

Step 5

TTS

ElevenLabs flash_v2_5

Step 6

Footage

Veo 2.0 / NB2 / source video

Step 7

Captions

Whisper word_timestamps

Step 8

Render

Remotion Lambda / FFmpeg

Step 9

Publish

YouTube Data API v3

Content Intelligence Flywheel (8 pasos)

1

Trending

Scout/Alexa

2

Outlier

Research/Miles

3

Transcript

Content/Miles

4

Thalx

Video pipeline

5

Expressions

NB2 packs

6

Pikzels

Thumbnails + CTR

7

AI4Managers

Distribution

8

Analytics

→ Loop Step 1

APIs & Service Keys

ServicioVariableUsoStatus
Google GeminiGOOGLE_THUMB_API_KEYVeo 2.0, NB2, thumbnails NB2● Activo ($300 free)
ElevenLabshardcoded en tts.pyTTS SquadFemale1, Sandra● Activo
PikzelsPIKZELS_KEYThumbnails pro + CTR score● Activo
YouTubeYOUTUBE_API_KEYData API v3, upload, outlier● Renovada 03-26
ScrapeCreatorsSCRAPE_CREATORSTrending research 10+ plataformas● Dev tier
AWS LambdaAWS_USER_KEY/SECRETRemotion render, S3● Activo
SupabaseSUPABASE_URL + keysAuth, storage, Postgres● Activo
GitHubGITHUB_ACCESS_TOKENRepos, PRs● Activo
VercelVERCEL_TOKENDeploy, domains● Activo
CloudflareCLOUDFLARE_API_*DNS (solo digitalhubassist.ai)● Parcial (no thalx.io)
IPRoyal ProxyPROXY_URLyt-transcript fallback● Inoperativo