AUTONOMOUS PIPELINE · MINIMAX M3 UNIFICATION

autonovel-minimax

Pipeline autônomo que transforma uma premissa básica em um livro digital completo diagramado em PDF, com ilustrações de capítulos e consistência narrativa.

Provedor Unificado
MiniMax M3 (Texto + Imagem)
Refatoração
18 scripts -> 2 módulos core
Estágios
4 Fases Iterativas
Saída Final
PDF Diagramado Profissional

TL;DR Executivo — Resumo da Engenharia

O autonovel-minimax é uma refatoração de engenharia e aprimoramento criado por Alex Santos sobre o projeto open-source autonovel da NousResearch. O projeto original sofria com complexidade excessiva: espalhava chamadas duplicadas em 18 scripts diferentes e exigia 3 provedores pagos distintos (Anthropic Claude para escrita, fal.ai para capas e Stability AI para ilustrações). Alex unificou todo o pipeline na API da MiniMax M3 (um único token para geração de texto de longo contexto e criação de imagens fotorrealistas), refatorou a base de código em 2 módulos compartilhados e adicionou um compilador de livros em PDF com diagramação tipográfica profissional.

DIAGRAMA & WORKFLOW

Arquitetura de Fluxo do Sistema

Visão macro de como o projeto processa requisições, gerencia dados e entrega valor técnico com máxima eficiência.

Fluxo Lógico & Pipeline de Execução
+-----------------------+      +---------------------------+      +-----------------------+
| Ideia / Premissa      | ===> | Fase 1: World & Bible     | ===> | Fase 2: Estruturação  |
| (Prompt de Conceito)  |      | (Personagens e Regras)    |      | (Outline de Capítulos)|
+-----------------------+      +---------------------------+      +-----------------------+
                                                                              |
+-----------------------+      +---------------------------+                  v
| Livro Digital em PDF  | <=== | Fase 4: Exportação &      | <=== +-----------------------+
| (Diagramado com Capas)|      | Geração de Imagens        |      | Fase 3: Escrita & Rev.|
+-----------------------+      +---------------------------+      | (Redação dos Capítulos|
                                                                  +-----------------------+
ENGENHARIA DETALHADA

Os Pilares Técnicos Fundamentais

Decisões de design, algoritmos e técnicas aplicadas para garantir confiabilidade, segurança e excelência operacional.

01

Unificação em Provedor Único com MiniMax M3

Redução drástica de complexidade de credenciais e custos de infraestrutura

A arquitetura original exigia gerenciar chaves de três fornecedores com formatos de payload completamente heterogêneos. O autonovel-minimax consolidou tudo na API da MiniMax, usando o modelo M3 para literatura de alta densidade e o image-01 para ilustrações de abertura de capítulo.

02

Refatoração DRY: de 18 Scripts Duplicados para 2 Módulos

Código limpo, manutenível e extensível para novos experimentos

Identificou duplicações massivas de chamadas HTTP e manipulação de strings. Consolidou todo o ecossistema em `minimax_client.py` (para geração e streaming de texto) e `minimax_image.py` (para requisições e persistência de imagens).

03

Workflow de Produção Iterativo em 4 Fases

Controle de qualidade etapa por etapa para evitar deriva narrativa

Fase 1 (Conceito e Worldbible), Fase 2 (Outline detalhado com pontos de virada dramática), Fase 3 (Geração e refinamento de capítulos individuais ancorados na bíblia) e Fase 4 (Revisão ortográfica e unificação do manuscrito).

04

Compilador Automatizado de Livros em PDF

Diagramação profissional com fontes clássicas e quebra de páginas

Utilizando a biblioteca ReportLab, o pipeline compila os capítulos gerados em um PDF com sumário automático, folha de rosto, numeração de páginas alternada e inserção das artes de abertura em alta resolução.

IMPLEMENTAÇÃO EM CÓDIGO

Código em Prática

Exemplo concreto de uso, configuração e integração técnica.

minimax_client.py — Módulo Compartilhado Unificado PYTHON
import os, httpx

class MiniMaxClient:
    def __init__(self, api_key: str = None):
        self.api_key = api_key or os.environ["MINIMAX_API_KEY"]
        self.base_url = "https://api.minimax.chat/v1"

    async def generate_chapter(self, context_bible: str, outline: str, chapter_num: int):
        prompt = f"Bíblia da História:\n{context_bible}\n\nDiretrizes do Capítulo {chapter_num}:\n{outline}"
        async with httpx.AsyncClient(timeout=180.0) as client:
            resp = await client.post(
                f"{self.base_url}/text/chatcompletion_v2",
                headers={"Authorization": f"Bearer {self.api_key}"},
                json={"model": "MiniMax-Text-01", "messages": [{"role": "user", "content": prompt}]}
            )
            return resp.json()["choices"][0]["message"]["content"]
DÚVIDAS & DECISÕES

Perguntas Frequentes & Respostas Técnicas

Esclarecimentos detalhados sobre funcionamento, licenças, compatibilidade e privacidade.

O que o autonovel-minimax tem de diferente do repositório da NousResearch?

A versão original dependia de Claude + fal.ai com código altamente duplicado. Esta versão unificou a arquitetura em MiniMax M3, reduziu 18 scripts para 2 módulos limpos e adicionou documentação em português com exportação para PDF.

Quanto tempo leva para gerar um livro completo de 5 capítulos?

Em média de 8 a 15 minutos, incluindo a criação da bíblia, planejamento de enredo, escrita de capítulos e geração das artes visuais de abertura.

O usuário pode intervir e editar capítulos durante o processo?

Sim, o pipeline salva arquivos Markdown intermediários após cada fase, permitindo ao autor ajustar a bíblia ou o outline antes de avançar para a escrita dos capítulos.

Quais parâmetros de tamanho de livro são configuráveis?

Você pode definir a quantidade de capítulos (ex: 3 a 20 capítulos) e o número alvo de palavras por capítulo através do arquivo de configuração config.yaml.