Skip to content

maxishida/nebulapdf

Repository files navigation

NebulaCourse.AI 🌌

Gerador de Cursos Premium via Pipeline Multi-Agente com IA Generativa.

1. Visão Geral

O NebulaCourse.AI é uma aplicação web "Dark Futurist" que orquestra múltiplos agentes de IA (baseados no Google Gemini 2.5 Flash) para pesquisar, estruturar, escrever e ilustrar cursos completos em formato PDF. Diferente de geradores de texto comuns, o sistema foca na entrega de um artefato final vendável (PDF Premium), com layout editorial, tratamento de orfãs/viúvas, preenchimento inteligente de espaços vazios e design gráfico gerado por IA.

2. Tech Stack & Decisões Arquiteturais

Tecnologia Função Justificativa
React 19 Frontend Framework Gerenciamento de estado complexo e renderização reativa do pipeline.
@google/genai SDK de IA Acesso aos modelos Gemini 2.5 Flash (texto) e Flash-Image (visual). Baixa latência e custo.
jsPDF Engine de PDF Geração de documentos client-side, garantindo privacidade e sem custo de servidor para renderização.
TailwindCSS Estilização Design system rápido para o tema "Cyberpunk/Dark" e responsividade.
Lucide React Ícones Leveza e consistência visual.
LocalStorage Persistência Armazenamento local do histórico de cursos para evitar re-geração desnecessária (economia de tokens).

3. Arquitetura de Agentes (Pipeline)

O sistema opera em um padrão de Cadeia Sequencial com Refinamento Paralelo:

  1. Orchestrator (App.tsx): Gerencia o estado global e a transição entre agentes.
  2. Agente 1: Research & Outline: Recebe o prompt, pesquisa a base de conhecimento do LLM e gera a estrutura JSON (capítulos, glossário).
  3. Agente 2: Content Writer: Itera sobre os capítulos definidos, gerando conteúdo denso em Markdown (Loop Assíncrono).
  4. Agente 3: Visual Artist (Nano): Analisa prompts de imagem gerados no Outline e renderiza assets visuais futuristas via Gemini Image.
  5. Agente 4: PDF Compiler: Engine personalizada que ingere o JSON enriquecido e renderiza o binário PDF com lógica de layout editorial.
  6. Agente 5: QA: (Simulado) Validação de integridade do arquivo final.

4. Como Rodar Localmente

Pré-requisitos

  • Node.js v18+
  • Chave de API do Google Gemini (AI Studio)

Passos

  1. Instale as dependências (assumindo estrutura padrão Vite/React):
    npm install
  2. Configure a variável de ambiente:
    • Crie um arquivo .env na raiz ou exporte no terminal.
    • IMPORTANTE: Como é uma SPA (Single Page App) puramente client-side neste estágio, a chave pode precisar ser prefixada dependendo do bundler (ex: VITE_API_KEY no Vite ou process.env.API_KEY se usar polyfills).
    API_KEY=sua_chave_gemini_aqui
  3. Inicie o servidor de desenvolvimento:
    npm start
    # ou
    npm run dev

5. Variáveis de Ambiente

Variável Descrição Obrigatório
API_KEY Chave de API do Google AI Studio (Gemini). Sim

Gerado por Tech Lead Agent.

About

nebulapdf

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors