Repolode
aeroxy

aeroxy/paper-bro

Cole o link de um artigo do arXiv e receba um curso interativo, passo a passo, gerado a partir dele e hospedado no AERO.

Estrelas
13
Forks
1
Issues abertas
4
Último commit
há 4 dias

O que é?

paper-bro transforma um artigo do arXiv em um curso interativo. Você cola o ID ou a URL do artigo no arXiv, e um pipeline lê o texto, cria um roteiro, escreve aulas com labs integrados, verifica tudo em um navegador headless e publica o resultado. Cada artigo gera um único curso: a primeira solicitação inicia a criação, e os visitantes seguintes são direcionados para a mesma página.

O servidor é um único binário Rust (axum e tokio), com banco de dados Neon Postgres e front-end React. As chamadas aos modelos podem usar qualquer endpoint compatível com OpenAI, e cada etapa da criação tem um checkpoint para que um trabalho interrompido possa ser retomado. O progresso é transmitido à página do artigo via SSE. A publicação usa o endpoint MCP do AERO com um personal access token.

O texto das aulas é sanitizado, e os labs são executados em iframes sandboxed com uma origem opaca, impedindo que código escrito pelo modelo acesse cookies, storage ou a rede do site hospedeiro. O projeto foi pensado para ser hospedado por conta própria, atrás de um reverse proxy.

Recursos principais

  • 01Transforma o ID ou a URL de um artigo do arXiv em um curso interativo com várias aulas.
  • 02Gera aulas em paralelo e faz QA com um navegador headless antes da publicação.
  • 03Retoma criações interrompidas a partir de checkpoints armazenados, sem gerar tudo novamente.
  • 04Transmite o progresso da criação à página do artigo em tempo real.
  • 05Executa labs escritos pelo modelo em iframes sandboxed, isolados do site hospedeiro.
  • 06Funciona com qualquer servidor de modelos compatível com OpenAI.

Casos de uso

  • Estudar um artigo de pesquisa com aulas guiadas e quizzes, em vez de lê-lo sem preparação.
  • Hospedar um gerador de cursos próprio para uma equipe ou turma que esteja estudando um conjunto de artigos.
  • Analisar como um pipeline sandboxed de conteúdo gerado por LLM é estruturado em Rust.

Início rápido

  1. 1

    Copie o modelo de ambiente e preencha as configurações do banco de dados, do token AERO e do LLM

    cp .env.example .env
  2. 2

    Instale a versão headless do Chrome pelo Chrome for Testing e configure CHROME_PATH para apontar para ela

  3. 3

    Compile o front-end

    (cd frontend && bun install && bun run build)
  4. 4

    Inicie o servidor

    cargo run -- serve

Antes de usar

  • Precisa de um banco de dados Neon Postgres, um token AERO e uma chave de API de modelo compatível com OpenAI.
  • Cada compilação de curso custa aproximadamente US$ 1 em taxas de uso do modelo.
  • Requer o Chromium em modo headless; no Ubuntu 24.04, é necessário um perfil do AppArmor para executá-lo.

Em coleções

Tópicos

Perguntas frequentes

O que é paper-bro?
Cole o link de um artigo do arXiv e receba um curso interativo, passo a passo, gerado a partir dele e hospedado no AERO. paper-bro transforma um artigo do arXiv em um curso interativo. Você cola o ID ou a URL do artigo no arXiv, e um pipeline lê o texto, cria um roteiro, escreve aulas com labs integrados, verifica tudo em um navegador headless e publica o resultado. Cada artigo gera um único curso: a primeira solicitação inicia a criação, e os visitantes seguintes são direcionados para a mesma página.
paper-bro é gratuito? Qual é a licença?
paper-bro é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
paper-bro ainda é mantido?
Manutenção ativa. O último commit de paper-bro foi em 3 de nov. de 2026.
Para que posso usar paper-bro?
Estudar um artigo de pesquisa com aulas guiadas e quizzes, em vez de lê-lo sem preparação. Hospedar um gerador de cursos próprio para uma equipe ou turma que esteja estudando um conjunto de artigos. Analisar como um pipeline sandboxed de conteúdo gerado por LLM é estruturado em Rust.
Como instalar paper-bro?
Copie o modelo de ambiente e preencha as configurações do banco de dados, do token AERO e do LLM: cp .env.example .env Instale a versão headless do Chrome pelo Chrome for Testing e configure CHROME_PATH para apontar para ela Compile o front-end: (cd frontend && bun install && bun run build) Inicie o servidor: cargo run -- serve
Onde consigo paper-bro?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/aeroxy/paper-bro

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados