Documentação do Presentia

O Presentia é usado principalmente pelo dashboard: crie um deck a partir de um prompt, um documento, um dataset ou markdown; ajuste-o no editor (com um assistente de IA); exporte para PPTX ou PDF. Esta página cobre os recursos próprios do fork e a API; o editor do dia a dia funciona como você esperaria do seu upstream.

De markdown para deck (modo Gamma)

A página Markdown tem um editor completo — barra de ferramentas, pré-visualização ao vivo que mostra exatamente como o seu texto se divide em cartões, contador de cartões, drag & drop — mais seletores de template, idioma, fonte/estilo de imagens e exportação. Cada seção separada por --- ou por títulos #/## vira um cartão.

`text_mode`	O que acontece
`preserve`	Seu texto entra no deck ao pé da letra — a IA só escolhe layouts e gera imagens.
`condense`	A IA resume cada cartão mantendo sua estrutura.
`generate`	A IA reescreve e expande cada cartão.

O mesmo poder está disponível pela API:

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-markdown \
  -H "Content-Type: application/json" \
  -d '{
        "markdown": "# Q3 Review\nIntro...\n\n---\n\n## Results\n- Revenue up 20%",
        "text_mode": "preserve",
        "template": "general",
        "export_as": "pptx"
      }'

Gráficos a partir de dados reais

POST /api/v1/ppt/presentation/generate-from-data constrói um deck a partir de um dataset CSV, TSV ou JSON (multipart: file, mais content, n_slides, language, template, instructions, export_as). A proteção anti-alucinação verifica cada valor de gráfico contra o dataset — apenas valores exatos ou agregados exatos de coluna (soma, média, mínimo, máximo, contagem). Números errados ganham uma nova tentativa com feedback e são rejeitados se o modelo insiste.

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-data \
  -F "file=@monthly_summary.csv" \
  -F "content=Monthly reconciliation report" \
  -F "n_slides=6" -F "language=English" -F "export_as=pdf"

Os datasets devem chegar pré-agregados; o teto de linhas é DATASET_MAX_ROWS (padrão 200). O template padrão é o Report, que carrega os layouts de gráficos.

Custos e modelos

Duas páginas do dashboard que o upstream não tem:

Modelos — o catálogo de modelos de texto e imagem com pontos de qualidade curados, preço combinado por milhão de tokens, disponibilidade calculada a partir das suas chaves e selos de recomendação. Clique em um cartão para trocar; com uma chave da OpenRouter quase tudo se acende de uma vez.
Custos — cartões de resumo (chamadas, tokens de entrada/saída, custo estimado) e detalhamentos por deck por etapa, slide e modelo, mais uma tabela comparativa de provedores. A precificação vem de um catálogo versionado no repositório, então o histórico de custos é auditável.

Integração com a Suíte Escriba

O Presentia funciona standalone — sem nenhuma dessas variáveis ele se comporta exatamente como o Presenton original. Cada integração é opt-in e independente; o docker-compose.yml do repositório traz blocos de serviço comentados para todas elas.

Escriba — parsing de documentos com OCR. ESCRIBA_ENABLED=true + ESCRIBA_URL delegam a conversão de documento → markdown a um serviço Escriba (PDFs escaneados, páginas rotacionadas, imagens, mais de 20 formatos). Se o Escriba estiver fora do ar ou falhar em um arquivo, o Presentia recorre automaticamente aos seus parsers locais.
Anonimal — anonimização de PII antes do LLM. ANONIMAL_ENABLED=true + ANONIMAL_URL anonimizam os prompts do usuário e o texto extraído dos documentos antes de eles viajarem ao provedor de LLM. Fail-closed: se o serviço não responder, a geração para com um erro claro em vez de enviar PII crua. O texto original nunca sai do seu host.
Searchgirl — busca web privada. WEB_SEARCH_PROVIDER=searchgirl + SEARCHGIRL_BASE_URL ancoram as gerações através da sua própria instância de metabusca em vez de uma API de terceiros (com um token Bearer opcional).

Templates, temas e idiomas

Famílias de templates embutidas (General, Modern, Standard, Swift, Report com gráficos, Institucional em es-AR), templates personalizados gerados a partir do seu próprio PPTX, um editor de temas completo (cores, fontes, logo) e style_instructions por template que moldam o tom da escrita. Toda a interface vem em 7 idiomas — English, Español, Français, Português, Italiano, 中文, 日本語 — alternáveis pela barra lateral e lembrados por navegador.

Desenvolvimento

docker compose up -d --build development   # hot reload para os dois servidores
cd servers/fastapi && python -m pytest tests/unit   # o fork adiciona mais de 100 testes unitários

Ver no GitHub