Qué es PaperBanana

Instalación

Paso 1: clonar el repositorio

Paso 2: instalar uv

Windows

Paso 3: entorno virtual y dependencias

Windows (PowerShell)

macOS y Linux

Paso 4: configuración de credenciales

Uso básico

Integración en proyectos reales

Cuándo usarlo y cuándo no

Alternativas

Conclusión

Referencias Cualquiera que haya escrito un paper académico conoce el mismo dolor: tenés la metodología clara en la cabeza, los resultados tabulados, la discusión redactada, pero la figura que debe explicar tu arquitectura se resiste. Abrís Inkscape, Figma, PowerPoint o matplotlib y empieza un ciclo interminable de alinear cajitas, elegir colores, reescribir etiquetas y pedir feedback a tus coautores. Las horas invertidas en diagramas rara vez se reconocen, pero son las que determinan si un revisor entiende tu contribución en treinta segundos o la descarta. En este contexto aparece PaperBanana, un proyecto open source desarrollado por investigadores de la Universidad de Pekín, Google Research y colaboradores, que propone automatizar la generación de ilustraciones académicas mediante un sistema multi-agente con modelos de lenguaje visual y generación de imágenes. La idea no es reemplazar al diseñador, sino producir borradores de alta calidad a partir del texto del método y una descripción de la figura, acelerando el ciclo de iteración. PaperBanana es un framework reference-driven que transforma contenido científico crudo en diagramas y gráficos de calidad publicable. Está descrito en un paper alojado en Hugging Face y se publicó bajo licencia Apache 2.0. La versión original nació dentro de Google Research como PaperVizAgent; este repositorio es un fork que continúa la evolución con foco en confiabilidad y diversidad de escenarios. El núcleo del sistema son cinco agentes especializados que trabajan en pipeline, cada uno con una responsabilidad clara: El resultado es un ciclo estructurado que emula el trabajo de un equipo creativo: alguien investiga referencias, alguien planifica, alguien estiliza, alguien dibuja y alguien revisa. Sobre esta base, el framework admite tareas de diagramas conceptuales y de gráficos de datos, con soporte para modelos de OpenAI, Anthropic, Google Gemini y cualquier proveedor compatible con OpenRouter. PaperBanana está escrito en Python 3.12 y se apoya en uv, el gestor de paquetes de Astral, para aislar dependencias. A continuación, los pasos comunes y las instrucciones específicas por sistema operativo. Este paso es idéntico en los tres sistemas operativos, asumiendo que tenés git instalado. uv reemplaza a pip, virtualenv y pip-tools con una sola herramienta escrita en Rust. La instalación cambia según el sistema. Una vez instalado uv, los comandos son prácticamente iguales en todos los sistemas, salvo cómo se activa el entorno virtual. El framework necesita al menos una clave de API. Duplicá configs/model_config.template.yaml como configs/model_config.yaml (este último está ignorado por git) y completá los campos. No necesitás configurar todo: alcanza con una clave de Google Gemini o una de OpenRouter. Si ponés ambas, el sistema prefiere OpenRouter por enrutamiento flexible. Opcionalmente podés descargar el dataset PaperBananaBench desde Hugging Face y colocarlo en data/PaperBananaBench/. Si no lo hacés, el framework sigue funcionando, pero pierde la capacidad de few-shot del Retriever y la calidad de los primeros borradores puede bajar. El primer ejemplo funcional es la interfaz de línea de comandos. Con el entorno activado, ejecutá: Los parámetros controlan el pipeline: Si preferís la vía visual, el demo de Streamlit es el camino más corto: La interfaz tiene dos pestañas. En Generate Candidates pegás el método en Markdown y el caption de la figura, elegís cantidad de candidatos y rondas de crítica, y en paralelo se generan hasta veinte variantes con sus líneas de evolución visible. En Refine Image subís un diagrama existente, describís los cambios y obtenés una versión refinada a 2K o 4K. Para una experiencia sin instalación alguna, el equipo publicó el demo en Hugging Face Spaces. Basta con ingresar tu clave de OpenRouter o Gemini, pegar el método y presionar generar. El escenario más común para un investigador o un equipo de R&D es integrar PaperBanana dentro de un flujo reproducible de escritura de papers. Imaginá un grupo que publica varios artículos por trimestre y que mantiene un repositorio con la metadata de cada figura en YAML o JSON; el objetivo es regenerar figuras automáticamente cuando cambia la arquitectura de un modelo o la configuración de un experimento. Un patrón razonable es envolver la llamada al pipeline en un script orquestador. Supongamos que cada figura se describe con el texto del método y un caption: Con esta estructura podés versionar las descripciones de figuras junto al código del paper, disparar regeneraciones desde CI cuando cambia el método, y mantener un historial reproducible de qué prompt produjo qué imagen. El modo dev_planner_critic es buena opción cuando querés calidad alta sin el costo del Stylist completo. Otro patrón útil es aprovechar la generación paralela. PaperBanana puede producir hasta veinte candidatos simultáneamente, lo que cambia la forma de trabajar: en vez de iterar manualmente, generás una batería grande, revisás los pipelines de evolución, descartás los peores y seleccionás uno o dos para refinar. Este enfoque aprovecha mejor el costo de las APIs de generación de imagen y se parece más a una selección editorial que a un proceso de diseño. Si trabajás con proveedores que imponen límites de concurrencia, vale la pena usar OpenRouter y rotar entre modelos, o directamente configurar una clave con cuotas altas. El README advierte explícitamente que generar muchos candidatos en paralelo requiere infraestructura preparada para concurrencia. PaperBanana es una herramienta potente, pero no resuelve todos los escenarios. Ser honesto sobre sus trade-offs ahorra frustraciones. Tiene sentido usarlo cuando: Probablemente no sea la herramienta indicada cuando: El coste económico también importa. Cada ronda de Critic implica llamadas adicionales a modelos de visión y generación, y producir veinte candidatos con refinamiento puede acumular un ticket no trivial. Medir el gasto por figura y compararlo con el tiempo humano ahorrado es una decisión que depende de tu contexto. El ecosistema de generación automática de figuras científicas está creciendo. Vale la pena conocer algunas referencias cercanas antes de adoptar PaperBanana: Cada herramienta tiene un foco distinto: algunas priorizan edición, otras generación, otras soporte multilingüe. No hay un ganador universal; la elección depende de si tu cuello de botella está en crear figuras nuevas, editar las existentes o producir versiones en distintos idiomas. PaperBanana representa un paso concreto hacia la automatización del trabajo visual en la investigación académica. Su diseño multi-agente es transparente, su licencia Apache 2.0 lo hace apto para uso profesional y su integración con múltiples proveedores de modelos lo vuelve flexible ante cambios en el ecosistema de IA. No resuelve todos los problemas de ilustración científica, pero sí recorta drásticamente el tiempo entre la idea y un primer borrador visual decente. Para equipos de LATAM que publican en conferencias internacionales, adoptar este tipo de tooling puede equilibrar la cancha frente a grupos con diseñadores dedicados. La curva de entrada es corta, el stack es familiar para cualquier equipo Python y la ganancia en iteración es inmediata. Podés explorar el código, clonar el proyecto o contribuir con issues y PRs en el Repositorio oficial en GitHub. Si querés probarlo sin instalar nada, el demo en Hugging Face Spaces es el camino más directo. 📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días. Templates let you quickly answer FAQs or store snippets for re-use. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse