Repolode
aeroxy

aeroxy/paper-bro

arXiv 논문 링크를 붙여 넣으면 AERO에서 호스팅되는 대화형 단계별 강의를 생성합니다.

스타
13
포크
1
열린 이슈
4
마지막 커밋
4일 전

어떤 프로젝트인가요?

paper-bro는 arXiv 논문을 대화형 강의로 바꿉니다. 논문의 arXiv ID나 URL을 붙여 넣으면 파이프라인이 본문을 읽고, 개요를 구성하고, 실습이 포함된 강의를 작성한 뒤 헤드리스 브라우저에서 검증하고 결과를 게시합니다. 논문마다 강의 하나가 생성됩니다. 첫 요청이 빌드를 시작하고, 이후 방문자는 같은 페이지로 안내됩니다.

서버는 Neon Postgres 데이터베이스와 React 프런트엔드를 사용하는 단일 Rust 바이너리(axum 및 tokio)입니다. 모델 호출은 OpenAI 호환 엔드포인트라면 어디든 보낼 수 있으며, 빌드의 각 단계가 체크포인트로 저장되어 작업이 중단되더라도 이어서 진행할 수 있습니다. 진행 상황은 SSE를 통해 논문 페이지로 스트리밍됩니다. 게시에는 개인 액세스 토큰을 사용해 AERO의 MCP 엔드포인트에 연결합니다.

강의 텍스트는 정제되며, 실습은 출처가 불투명한 샌드박스 iframe에서 실행됩니다. 따라서 모델이 작성한 코드는 호스트 사이트의 쿠키, 스토리지 또는 네트워크에 접근할 수 없습니다. 이 프로젝트는 리버스 프록시 뒤에서 자체 호스팅하는 용도로 설계되었습니다.

핵심 기능

  • 01arXiv 논문 ID나 URL을 여러 강의로 구성된 대화형 강의로 변환합니다.
  • 02강의를 병렬로 생성하고 게시 전에 헤드리스 브라우저 QA로 검증합니다.
  • 03모든 내용을 다시 생성하는 대신 저장된 체크포인트부터 중단된 빌드를 재개합니다.
  • 04빌드 진행 상황을 논문 페이지에 실시간으로 스트리밍합니다.
  • 05모델이 작성한 실습을 호스트 사이트와 격리된 샌드박스 iframe에서 실행합니다.
  • 06OpenAI 호환 모델 서버라면 무엇이든 사용할 수 있습니다.

활용 사례

  • 논문을 처음부터 읽는 대신 안내형 강의와 퀴즈로 연구 논문을 공부합니다.
  • 팀이나 수업에서 여러 논문을 함께 공부할 수 있도록 자체 호스팅 강의 생성기를 운영합니다.
  • 샌드박스 처리된 LLM 콘텐츠 파이프라인이 Rust에서 어떻게 구성되는지 살펴봅니다.

빠른 시작

  1. 1

    환경 템플릿을 복사한 뒤 데이터베이스, AERO 토큰, LLM 설정을 입력합니다

    cp .env.example .env
  2. 2

    Chrome for Testing에서 headless Chrome 빌드를 설치하고 CHROME_PATH를 해당 경로로 지정합니다

  3. 3

    프런트엔드를 빌드합니다

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

    서버를 시작합니다

    cargo run -- serve

사용 전 알아둘 점

  • Neon Postgres 데이터베이스, AERO 토큰, OpenAI 호환 모델 API 키가 필요합니다.
  • 코스를 한 번 빌드할 때마다 모델 사용료가 약 1달러 듭니다.
  • headless Chromium이 필요하며, Ubuntu 24.04에서 실행하려면 AppArmor 프로필이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

paper-bro은(는) 무엇인가요?
arXiv 논문 링크를 붙여 넣으면 AERO에서 호스팅되는 대화형 단계별 강의를 생성합니다. paper-bro는 arXiv 논문을 대화형 강의로 바꿉니다. 논문의 arXiv ID나 URL을 붙여 넣으면 파이프라인이 본문을 읽고, 개요를 구성하고, 실습이 포함된 강의를 작성한 뒤 헤드리스 브라우저에서 검증하고 결과를 게시합니다. 논문마다 강의 하나가 생성됩니다. 첫 요청이 빌드를 시작하고, 이후 방문자는 같은 페이지로 안내됩니다.
paper-bro은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
paper-bro은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
paper-bro은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. paper-bro의 마지막 커밋은 2026년 11월 3일입니다.
paper-bro은(는) 어디에 사용할 수 있나요?
논문을 처음부터 읽는 대신 안내형 강의와 퀴즈로 연구 논문을 공부합니다. 팀이나 수업에서 여러 논문을 함께 공부할 수 있도록 자체 호스팅 강의 생성기를 운영합니다. 샌드박스 처리된 LLM 콘텐츠 파이프라인이 Rust에서 어떻게 구성되는지 살펴봅니다.
paper-bro는 어떻게 설치하나요?
환경 템플릿을 복사한 뒤 데이터베이스, AERO 토큰, LLM 설정을 입력합니다: cp .env.example .env Chrome for Testing에서 headless Chrome 빌드를 설치하고 CHROME_PATH를 해당 경로로 지정합니다 프런트엔드를 빌드합니다: (cd frontend && bun install && bun run build) 서버를 시작합니다: cargo run -- serve
paper-bro은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aeroxy/paper-bro

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트