Google의 코드 우선 Python 프레임워크로, Gemini에 최적화되어 있지만 특정 모델에 종속되지 않으며 AI 에이전트를 구축·평가·배포할 수 있습니다.
dwzhu-pku/PaperBanana
LLM과 이미지 생성으로 방법 설명과 그림 캡션을 논문에 어울리는 학술 다이어그램과 플롯으로 만드는 멀티 에이전트 프레임워크입니다.
- 스타
- 7,332
- 포크
- 553
- 열린 이슈
- 1
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
PaperBanana는 레퍼런스를 활용해 학술용 일러스트를 생성하는 멀티 에이전트 시스템입니다. 방법 섹션과 그림 캡션을 입력하면 Retriever, Planner, Stylist, Visualizer, Critic 에이전트로 구성된 파이프라인을 실행합니다. Retriever는 PaperBananaBench 데이터셋에서 관련 예시를 가져오고, Planner는 상세한 그림 설명을 작성합니다. Stylist는 이를 학술적인 미적 관습에 맞게 다듬고, Visualizer는 이미지를 생성하며, Critic은 결과를 검토해 Visualizer가 반복 개선할 수 있도록 합니다.
프로젝트는 여러 실행 방식을 제공합니다. Gradio 웹 앱, 여러 후보를 병렬로 생성하고 이미지를 2K 또는 4K로 보정할 수 있는 Streamlit 데모, 그리고 단일 호출 방식부터 전체 파이프라인까지 실험 모드를 선택할 수 있는 CLI를 제공합니다. Google Gemini를 직접 사용하거나 여러 제공업체의 모델을 이용할 수 있는 OpenRouter를 통해 실행할 수 있습니다.
이 저장소는 Google Research의 PaperVizAgent를 포크한 프로젝트이며 Apache-2.0 라이선스로 배포됩니다. 현재는 컴퓨터 과학 다이어그램과 matplotlib 스타일 플롯 생성에 중점을 두고 있으며, 통계 플롯 생성은 아직 TODO로 남아 있습니다.
핵심 기능
- 01검색, 계획, 스타일 지정, 이미지 생성, 비평을 담당하는 5개 에이전트 파이프라인입니다.
- 02PaperBananaBench 데이터셋에서 few-shot 참조 예시를 가져옵니다.
- 03Critic과 Visualizer가 여러 차례 주고받으며 결과를 반복해서 개선합니다.
- 04Streamlit UI에서 후보를 최대 20개까지 병렬 생성하고 이미지를 2K 또는 4K로 업스케일합니다.
- 05모델 제공업체로 Google Gemini와 OpenRouter를 지원합니다.
- 06실험 모드를 선택할 수 있는 CLI를 제공합니다.
활용 사례
- 논문 본문과 캡션을 바탕으로 아키텍처 다이어그램이나 방법론 다이어그램 초안을 작성합니다.
- 여러 그림 후보를 생성한 뒤 논문 제출에 사용할 최적의 결과를 고릅니다.
- 이미 생성한 다이어그램을 고해상도로 업스케일하거나 편집합니다.
- PaperBananaBench 데이터셋을 기준으로 다이어그램 생성 파이프라인을 벤치마킹합니다.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/dwzhu-pku/PaperBanana.git - 2
uv로 가상 환경을 만듭니다
uv venv - 3
필요한 패키지를 설치합니다
uv pip install -r requirements.txt - 4
configs/model_config.yaml에 API 키를 설정한 다음 Gradio 웹 앱을 실행합니다
python app.py
사용 전 알아둘 점
- OpenRouter 또는 Google Gemini API 키가 필요하므로 외부 유료 모델 서비스에 따라 사용 여부가 달라집니다.
- 생성 신뢰도에는 여전히 한계가 있으며, README에 따르면 더 안정적이고 다양한 결과를 얻기까지 갈 길이 멉니다.
- 한 번에 많은 후보를 생성하려면 높은 동시 요청을 지원하는 API 키가 필요합니다.
토픽
자주 묻는 질문
- PaperBanana은(는) 무엇인가요?
- LLM과 이미지 생성으로 방법 설명과 그림 캡션을 논문에 어울리는 학술 다이어그램과 플롯으로 만드는 멀티 에이전트 프레임워크입니다. PaperBanana는 레퍼런스를 활용해 학술용 일러스트를 생성하는 멀티 에이전트 시스템입니다. 방법 섹션과 그림 캡션을 입력하면 Retriever, Planner, Stylist, Visualizer, Critic 에이전트로 구성된 파이프라인을 실행합니다. Retriever는 PaperBananaBench 데이터셋에서 관련 예시를 가져오고, Planner는 상세한 그림 설명을 작성합니다. Stylist는 이를 학술적인 미적 관습에 맞게 다듬고, Visualizer는 이미지를 생성하며, Critic은 결과를 검토해 Visualizer가 반복 개선할 수 있도록 합니다.
- PaperBanana은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- PaperBanana은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- PaperBanana은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. PaperBanana의 마지막 커밋은 2026년 10월 19일입니다.
- PaperBanana은(는) 어디에 사용할 수 있나요?
- 논문 본문과 캡션을 바탕으로 아키텍처 다이어그램이나 방법론 다이어그램 초안을 작성합니다. 여러 그림 후보를 생성한 뒤 논문 제출에 사용할 최적의 결과를 고릅니다. 이미 생성한 다이어그램을 고해상도로 업스케일하거나 편집합니다. PaperBananaBench 데이터셋을 기준으로 다이어그램 생성 파이프라인을 벤치마킹합니다.
- PaperBanana는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/dwzhu-pku/PaperBanana.git uv로 가상 환경을 만듭니다: uv venv 필요한 패키지를 설치합니다: uv pip install -r requirements.txt configs/model_config.yaml에 API 키를 설정한 다음 Gradio 웹 앱을 실행합니다: python app.py
- PaperBanana은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dwzhu-pku/PaperBanana
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
OpenAI, Claude, Gemini, DeepSeek 및 자체 호스팅 모델에 연결할 수 있는 오픈소스 크로스 플랫폼 AI 채팅 클라이언트로, 웹·데스크톱·모바일을 지원합니다.
대규모 언어 모델을 로컬에서 실행하고, 채팅 UI와 OpenAI/Anthropic 호환 API를 제공하는 무료 오픈소스 데스크톱 앱입니다.
Python 코드로 동작을 작성하고 실행하는 AI 에이전트를 만들기 위한 미니멀한 Python 라이브러리입니다.
Python, .NET, Java에서 모델·플러그인·벡터 데이터베이스 연동을 통해 AI 에이전트와 멀티 에이전트 시스템을 구축하는 SDK입니다.
스토리 아이디어, 각본, 소설을 대본·스토리보드·캐릭터·영상 생성 에이전트의 협업으로 여러 장면의 영상으로 만드는 에이전트형 영상 생성 프레임워크입니다.