🎬 CÓSMICA DREAD - Agente Orquestrador de Conteúdo Horror

Sistema de orquestração que transforma histórias de "Two Sentence Horror" em especificações técnicas completas para produção audiovisual automatizada do canal YouTube "CÓSMICA DREAD".

🌟 O Que Este Sistema Faz

INPUT:

"I heard scratching in the walls for weeks, getting louder each night.
This morning I found out my house was built on an old cemetery,
and the scratching stopped."

OUTPUT (JSON Master com 3 seções):

• Audio Specs → Narração em PT-BR, timing, SFX, ambient
• Video Specs → Prompts visuais, segmentação, visual descent
• Content Specs → Títulos YouTube, hashtags TikTok, estratégia viral

⏱️ Tempo: 15-30 segundos para gerar tudo

---

🚀 Instalação Rápida (3 Comandos)

# 1. Clone o repositório
git clone https://github.com/lldonha/cosmicdread_v1
cd cosmicdread_v1

# 2. Execute o setup
python3 setup.py

# 3. Siga as instruções na tela!

Pré-requisitos:

• Docker + Docker Compose
• Python 3.10+
• Chave API do Google Gemini (obter aqui)

---

📋 Pré-requisitos Detalhados

Sistema Operacional

• Linux (Ubuntu 20.04+, Debian 11+)
• macOS 11+
• Windows 10/11 (com WSL2)

Software

• Docker 20.10+
• Docker Compose 2.0+
• Python 3.10+
• pip 21.0+

Chave API

• Google Gemini 1.5 Flash (criar conta grátis)

---

🏗️ Arquitetura

Two Sentence Horror
        ↓
    [Webhook] → n8n recebe
        ↓
    [Gemini API] → 3 fases de geração
        ├─ Fase 1: Análise + Audio
        ├─ Fase 2: Visual Specs
        └─ Fase 3: Content Strategy
        ↓
    [Validação] → JSON parsing + checks
        ↓
    [Postgres] → Salva roteiro master
        ↓
    [Resposta] → story_id + preview
        ↓
    [Aprovação Manual] → Usuário valida
        ↓
    [FUTURO] ComfyUI → Produz vídeo

---

📖 Uso Básico

1. Inicie os Serviços

docker-compose up -d

2. Acesse o n8n

• URL: http://localhost:5678
• Login: admin
• Senha: cosmica_admin_2025

3. Configure Credencial Gemini

1. Settings → Credentials → Add
2. Tipo: HTTP Request → Generic Credential Type
3. Nome: Gemini API
4. Authentication: Header Auth
5. Header Name: x-goog-api-key
6. Header Value: [sua chave do .env]

4. Importe o Workflow

1. Workflows → Import from file
2. Selecione: n8n/workflows/main_orchestrator.json
3. Ative o workflow (toggle verde)

5. Teste o Sistema

# Copie a URL do webhook do n8n
WEBHOOK_URL="http://localhost:5678/webhook/horror-story"

# Envie uma história de teste
curl -X POST $WEBHOOK_URL \
  -H "Content-Type: application/json" \
  -d '{
    "story_text": "I heard scratching in the walls for weeks. This morning I found my house was built on a cemetery, and the scratching stopped.",
    "source": "test"
  }'

Resposta esperada:

{
  "success": true,
  "story_id": "tsh_1705334567890",
  "status": "draft",
  "duration": "48s",
  "segments": 4,
  "horror_type": "supernatural",
  "approve_url": "http://localhost:5678/webhook/approve/tsh_..."
}

---

📊 Estrutura do JSON Master

O sistema gera um JSON com 3 seções principais:

1. Audio Specs

Especificações para produção de áudio:

• Narração em português BR
• Timing preciso por segmento
• Efeitos sonoros (SFX)
• Música ambiente
• CTA sonoro

2. Video Specs

Especificações para produção de vídeo:

• Prompts Flux/Stable Diffusion (inglês)
• Segmentação temporal
• Visual descent (warm→cold)
• Movimentos de câmera
• Transições entre segmentos

3. Content Specs

Estratégia de distribuição:

• Títulos YouTube (3 variações)
• Hashtags TikTok/Instagram
• Thread Twitter
• SEO keywords
• Melhor horário de postagem

Ver exemplo completo

---

🗂️ Estrutura do Banco de Dados

Tabelas principais:

• roteiros_master - Armazena todos os roteiros gerados
• validation_history - Histórico de aprovações/rejeições
• execution_logs - Logs detalhados de cada execução
• system_config - Configurações globais

Ver schema completo

---

🔧 Comandos Úteis

# Ver logs em tempo real
docker-compose logs -f

# Ver logs de um serviço específico
docker-compose logs -f n8n

# Parar serviços
docker-compose down

# Parar e remover volumes (CUIDADO: apaga dados)
docker-compose down -v

# Reiniciar serviços
docker-compose restart

# Acessar banco de dados
docker-compose exec postgres psql -U cosmica -d cosmica_dread

# Executar migrations
docker-compose exec postgres psql -U cosmica -d cosmica_dread -f /docker-entrypoint-initdb.d/migrations/001_initial.sql

---

📚 Documentação

• Arquitetura Detalhada
• Guia do Workflow N8N
• API Reference
• Troubleshooting

---

🐛 Problemas Comuns

"Gemini API não responde"

• Verifique se a chave está correta no .env
• Confirme que configurou a credencial no n8n
• Veja TROUBLESHOOTING.md

"Postgres não conecta"

• Aguarde 30s após docker-compose up
• Verifique: docker-compose ps
• Veja logs: docker-compose logs postgres

"Workflow não aparece no n8n"

• Importe manualmente via UI
• Verifique permissões do arquivo JSON
• Reinicie n8n: docker-compose restart n8n

Ver mais soluções

---

🗺️ Roadmap

• Fase 1: Orquestração (n8n + Gemini)
• Fase 2: Integração ComfyUI (produção automatizada)
• Fase 3: Publicação automática (YouTube, TikTok, Instagram)
• Fase 4: Analytics e otimização
• Fase 5: UI web para gerenciar roteiros

---

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o projeto
2. Crie uma branch (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Add: nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

---

📄 Licença

MIT License - veja LICENSE

---

🙏 Agradecimentos

• n8n.io - Automação workflow
• Google Gemini - LLM API
• r/TwoSentenceHorror - Inspiração

---

Desenvolvido para o canal CÓSMICA DREAD 🎬👻