⚡ WebAssembly (Navegador) 💻 Agente Local (Linux Nativo)

Motores de Compilação no NeoLeaf

Entenda a diferença entre a compilação no navegador e o agente local nativo, e saiba como escolher a melhor opção para seu projeto.

Verificando agente local nesta máquina... Testando conexão local em 127.0.0.1:47474...

🎯 Comparativo: WebAssembly vs. Agente Local

O NeoLeaf foi projetado com a filosofia Client-First & Privacy by Design: diferentemente de plataformas tradicionais que enviam seus artigos para filas em servidores remotos, no NeoLeaf a compilação ocorre diretamente nas mãos do usuário.

⚡ WebAssembly (Navegador)

Padrão do NeoLeaf · Sem Instalação

100% no navegador: Compilação com TeX Live WebAssembly (texlive-wasm / BusyTeX) executada pelo processador do seu dispositivo.
Privacidade Absoluta (LGPD): Nenhum código, texto confidencial ou dado da pesquisa é transmitido ao servidor para compilação.
Zero Dependências: Funciona em qualquer navegador moderno (Chrome, Firefox, Safari, Edge) em qualquer sistema operacional (Linux, macOS, Windows).
Fontes e Pacotes sob demanda: Pacotes comuns e fontes matemáticas são baixados e mantidos em cache IndexedDB.

💻 Agente Local (neoleaf-agent)

Velocidade Máxima · TeX Live / Tectonic da Máquina

Compiladores Nativos: Usa o TeX Live, TinyTeX ou Tectonic instalado na sua própria máquina (pdfLaTeX, XeLaTeX, LuaLaTeX).
Ultra Rápido para Projetos Grandes: Ideal para teses volumosas, livros, dissertações e pacotes com TikZ avançado.
Fontes do Sistema: Acesso irrestrito a fontes TrueType/OpenType instaladas no seu sistema operacional com XeLaTeX ou LuaLaTeX.
Auto-instalação com tlmgr: Se faltar um pacote (.sty), o agente instala automaticamente com o TeX Live local e recompila.

Característica	⚡ WebAssembly (Navegador)	💻 Agente Local (neoleaf-agent)
Onde a compilação roda	Na aba do navegador do usuário	Nativamente na máquina do usuário
Envia código TeX para o servidor?	Nunca (100% privado)	Nunca (100% privado)
Necessita de instalação prévia	Nenhuma (abre e usa)	Sim (requer TeX Live ou Tectonic local)
Motores suportados	pdfLaTeX (wasm)	pdfLaTeX, XeLaTeX, LuaLaTeX, Tectonic
Fontes do Sistema Operacional	Apenas pacotes inclusos	Qualquer fonte instalada no sistema
Auto-instalação de pacotes	Download via cache web (.tar.gz)	Automático via `tlmgr` local
Sistemas Operacionais	Qualquer SO (Linux, Windows, Mac, Mobile)	Linux (x86_64)

📦 Baixar e Instalar o Agente Local

O neoleaf-agent é um executável leve e seguro desenvolvido em Rust. Ele escuta exclusivamente em 127.0.0.1:47474, aceita apenas requisições vindas do NeoLeaf (https://neoleaf.science) e exige um código de pareamento único para autorizar o acesso.

Baixar neoleaf-agent para Linux (x86_64) (~2.5 MB)

Passo 1: Instalar como serviço de usuário (systemd)

Após baixar o arquivo na sua pasta de Downloads, abra o terminal e execute:

chmod +x neoleaf-agent-linux-x86_64 ./neoleaf-agent-linux-x86_64 install

O comando install registra o agente no systemd --user para iniciar automaticamente com sua sessão e ativa o ícone de bandeja (StatusNotifierItem / Tray).

Passo 2: Pareamento no Editor

Abra seu projeto no NeoLeaf. O motor 💻 Local (pdfLaTeX / XeLaTeX / LuaLaTeX / Tectonic) aparecerá no seletor de compilação da barra superior. Ao clicar para compilar pela primeira vez, o agente:

Copia o código de pareamento automaticamente para a área de transferência (Ctrl+V);
Exibe uma notificação no desktop do seu sistema operacional;
Basta colar o código no diálogo de confirmação do navegador (uma única vez).

Comandos Úteis do Agente

# Exibir o código de pareamento atual ./neoleaf-agent-linux-x86_64 code # Listar os compiladores encontrados na sua máquina ./neoleaf-agent-linux-x86_64 engines # Desinstalar e remover o serviço do sistema ./neoleaf-agent-linux-x86_64 uninstall

🔒 Segurança do Agente Local

Apenas Localhost: O agente escuta exclusivamente em 127.0.0.1:47474 e não aceita conexões externas de rede.
CORS Restrito: Requisições são aceitas somente com origem validada em https://neoleaf.science.
Sandbox de Compilação: A compilação é executada sem o parâmetro inseguro --shell-escape e dentro de diretório isolado em ~/.cache/neoleaf-agent/work/.
Código com Permissões Restritas: O token de pareamento é salvo em ~/.config/neoleaf-agent/config.json com permissões 0600 (legível apenas pelo seu usuário).