🦏 BitTrader — YouTube Content Pipeline

Fábrica automatizada de contenido para YouTube enfocada en criptomonedas, trading y educación financiera en español neutro latinoamericano.

BitTrader es un sistema de agentes autónomos que investiga el mercado, genera guiones, produce videos (Shorts y long-form), crea miniaturas, ejecuta control de calidad y publica en YouTube — todo de forma automatizada y programada.

---

🎯 ¿Qué hace?

• 🔍 Investiga tendencias de cripto, noticias y competidores en tiempo real
• ✍️ Genera guiones optimizados para viralidad con LLMs (MiniMax, GLM, Claude)
• 🎬 Produce videos con voz AI (TTS), subtítulos karaoke y clips generados por IA
• 🖼️ Crea miniaturas con branding consistente y texto de alto impacto
• ✅ Control de calidad obligatorio antes de cualquier publicación
• 📤 Publica en YouTube con scheduling inteligente basado en datos
• 📊 Dashboard en tiempo real para monitorear toda la operación

---

⚙️ Arquitectura

┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│  SCOUT  │───▶│ CREATOR │───▶│ PRODUCER│───▶│THUMBNAIL│───▶│   QC    │───▶│ PUBLISHER│
│(Research│    │ (Scripts│    │ (TTS +  │    │  Agent  │    │  Gate   │    │(YouTube)│
│ + Stats)│    │ + Plan) │    │  Video) │    │         │    │         │    │         │
└─────────┘    └─────────┘    └─────────┘    └─────────┘    └────┬────┘    └─────────┘
      ▲                                                            │
      └────────────────────────────────────────────────────────────┘
                            DASHBOARD (Flask :8083)

6 stages principales:

Stage	Agente	Descripción
1. Scout	agents/scout.py	Recolecta datos de mercado (CoinGecko, YouTube, RSS) y detecta alertas urgentes
2. Creator	agents/creator.py	Genera guiones Shorts (<60s) y Longs (3-8min) con prompts optimizados
3. Producer	agents/producer.py	Ensambla video: TTS, clips IA, subtítulos karaoke, logo, ffmpeg
4. Thumbnail	agents/thumbnail_agent.py	Genera miniaturas 1280×720 / 1080×1920 con branding BitTrader
5. QC	agents/qa_agent.py	Control de calidad: brillo, thumbs, idioma, contaminación, green screens
6. Publisher	agents/publisher.py	Subida a YouTube Data API v3 con metadata y scheduling inteligente

---

🚀 Stack Tecnológico

Capa	Tecnología
Lenguaje	Python 3.13 (primary), TypeScript/React (Remotion)
Web	Flask (dashboard en puerto 8083)
LLMs	MiniMax M2.5/M2.7, GLM-4.7/5, Claude Sonnet 4.6, Qwen, Ollama
TTS	MiniMax speech-2.8-hd (Spanish_ThoughtfulMan), Edge-TTS fallback
Video	MiniMax Hailuo 2.3, ComfyUI (Mac M3 Pro / M4 Air), ffmpeg
Subtítulos	OpenAI Whisper → ASS karaoke (\kf blanco→amarillo)
Thumbnails	Pillow (PIL), FLUX.1-schnell (HF) para thumbnails con persona
Datos	CoinGecko API, YouTube Data API v3, RSS (CoinDesk, CoinTelegraph)
DB	SQLite (bittrader.db) + archivos JSON
Orquestación	Paperclip AI (self-hosted) + cron
Animación	Remotion 4.0 (React/TypeScript) para intros animadas

---

📋 Pipeline de Producción

Auto-Pipeline completo

python auto_pipeline.py --full

Ejecuta la cadena completa: Scout → Creator → Producer → Thumbnail → QC → Queue

Ejecutar stages individuales

# Solo investigar mercado
python agents/scout.py

# Generar guiones desde datos del scout
python agents/creator.py

# Producir videos desde guiones existentes
python agents/producer.py

# Ejecutar control de calidad
python agents/qa_agent.py

# Procesar cola de upload
python agents/queue_processor.py

Orchestrator (modo manual)

python agents/orchestrator.py --full --dry-run

---

🖥️ Dashboard

Panel web Flask disponible en http://localhost:8083 (o http://100.88.47.99:8083 vía Tailscale).

Features:

• Estado de pipeline en tiempo real
• Gráfico Gantt de la cola de upload
• Stats de YouTube y tendencias
• Alertas y breakdown de QA
• Studio Upload: drag & drop con auto-editor, Whisper, subtítulos karaoke
• Integración con Paperclip (issues abiertos)
• KPI history con sparklines

---

🛠️ Instalación Rápida

Requisitos

• Python 3.13+
• ffmpeg
• Git

Setup

git clone https://github.com/enderjnets/BitTrader.git
cd BitTrader

# Crear virtualenv
python3 -m venv venv
source venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

# Configurar credenciales
cp secrets/google_credentials.json.example secrets/google_credentials.json
# Editar con tus credenciales de YouTube OAuth2

# Iniciar dashboard
python dashboard/app.py

Cron (opcional)

El sistema está diseñado para correr vía cron:

# Pipeline completo cada 2 días
0 10 * * * cd /path/to/BitTrader && python auto_pipeline.py --full

# Procesar cola de upload cada 30 min
*/30 * * * * cd /path/to/BitTrader && python agents/queue_processor.py

# Watchdog cada hora
15 * * * * cd /path/to/BitTrader && python agents/pipeline_watchdog.py

---

📁 Estructura del Proyecto

BitTrader/
├── agents/                 # Agentes del pipeline
│   ├── scout.py            # Investigación de mercado
│   ├── creator.py          # Generación de guiones
│   ├── producer.py         # Producción de videos
│   ├── thumbnail_agent.py  # Miniaturas
│   ├── qa_agent.py         # Control de calidad
│   ├── publisher.py        # Publicación YouTube
│   ├── orchestrator.py     # Coordinador principal
│   ├── competitor_research.py  # Análisis de competencia
│   ├── evolution_*.py      # Ciclos de auto-mejora
│   └── handlers/           # Handlers de Paperclip (CEO, CTO, Engineer, etc.)
├── analytics/              # Módulo de analytics
│   ├── collector.py        # Recolección de datos
│   ├── analyzer.py         # Análisis de patrones
│   └── strategist.py       # Generación de estrategia
├── dashboard/              # Panel web Flask
│   ├── app.py              # Backend
│   ├── templates/          # HTML
│   └── static/             # CSS/JS
├── animator/               # Workflows ComfyUI + assets
├── remotion/               # Proyecto React/TS para intros animadas
├── docs/                   # Documentación adicional
├── data/                   # Archivos de datos y estado
├── assets/                 # Logos e imágenes de marca
├── auto_pipeline.py        # Entry point del pipeline completo
└── README.md               # Este archivo

---

📚 Documentación Adicional

Documento	Descripción
AGENTS.md	Documentación completa para agentes AI — arquitectura, cron, data files, taxonomía QA
agents/README.md	Overview de agentes, stack, uso, costos, specs de video
ESTRATEGIA_BITTRADER.md	Estrategia de contenido: idioma, CTAs, optimización de títulos, scheduling
SHORTS_STRATEGY.md	Plan viral para Shorts — objetivo 10M views
shorts_production_bible.md	Biblia de producción estilo MrBeast: timing exacto, fuentes, cortes, música
thumbnail_standards.md	Reglas de diseño de miniaturas
docs/GUIA_CREDENCIALES_MULTI_PLATAFORMA.md	Guía paso a paso para credenciales Meta y TikTok

---

🤝 Contribuir

Este es un proyecto personal de automatización de contenido. Si querés contribuir o adaptarlo a tu propio canal:

1. Fork el repo
2. Creá una branch (git checkout -b feature/mi-mejora)
3. Commiteá tus cambios
4. Abrí un PR

---

📄 Licencia

MIT License — ver LICENSE para detalles.

---

_{Built with 💰⚡🔥 by @enderjnets · BitTrader AI 2025-2026}