Repolode
제출하기
StarTrail-org

StarTrail-org/PixelRAG

웹 페이지와 PDF를 스크린샷으로 렌더링해 이미지에서 검색하는 시각적 RAG 툴킷

GitHub에서 보기웹사이트
스타
10,303
포크
909
열린 이슈
18
마지막 커밋
4일 전

어떤 프로젝트인가요?

PixelRAG는 문서를 이미지로 다루는 검색 증강 생성 파이프라인입니다. 웹 페이지나 PDF를 텍스트 청크로 파싱하는 대신 스크린샷 타일로 렌더링하고, Qwen3-VL-Embedding 모델로 이미지 임베딩을 생성한 다음 FAISS 또는 Qdrant 벡터 인덱스에서 검색합니다. 표, 차트, 레이아웃 같은 시각적 구조가 유지되므로 텍스트 기반 파싱에서 흔히 놓치는 정보도 리더 모델이 질문에 답하는 데 활용할 수 있습니다.

이 프로젝트는 URL과 PDF를 캡처하는 `pixelshot` CLI, 청킹·임베딩·인덱싱과 FastAPI 검색 서버를 실행하는 `pixelrag` 명령, 페이지 렌더링을 위한 Python API를 제공합니다. 828만 개 Wikipedia 페이지의 사전 구축 인덱스는 호스팅된 검색 엔드포인트에서 사용할 수 있으며, 임베딩 모델을 조정할 수 있도록 LoRA 어댑터와 학습 데이터도 공개되어 있습니다. Claude Code 플러그인과 opencode 패키지를 통해 코딩 에이전트에서 스크린샷 기능을 사용할 수도 있습니다.

핵심 기능

  • 01Playwright/CDP 및 PDF 렌더링을 통해 웹 페이지와 PDF를 스크린샷 타일로 렌더링합니다.
  • 02Qwen3-VL-Embedding으로 페이지 이미지의 임베딩을 생성하며, LoRA 파인튜닝 어댑터도 선택적으로 사용할 수 있습니다.
  • 03로컬에서 FAISS 인덱스를 만들거나, 설정 가능한 양자화와 페이로드 필터링을 지원하는 Qdrant를 사용합니다.
  • 04이미지 쿼리도 받는 FastAPI 엔드포인트로 검색을 제공합니다.
  • 05CUDA를 사용하는 Linux 또는 Apple Silicon MPS를 사용하는 macOS에서 실행되며, 지원되지 않으면 CPU로 전환합니다.

활용 사례

  • 표, 차트, 인포그래픽에 답이 담긴 문서를 검색합니다.
  • Claude Code 같은 코딩 에이전트가 웹 페이지를 이미지로 읽도록 합니다.
  • 비공개 PDF나 웹 페이지 모음에서 시각적 검색 인덱스를 구축합니다.
  • 호스팅된 Wikipedia 인덱스에서 스크린샷 기반 검색을 실험합니다.

토픽

#rag#multimodal#vision#vector-search#embeddings#document-retrieval#vlm#agent#ai#memory

자주 묻는 질문

PixelRAG은(는) 무엇인가요?
웹 페이지와 PDF를 스크린샷으로 렌더링해 이미지에서 검색하는 시각적 RAG 툴킷 PixelRAG는 문서를 이미지로 다루는 검색 증강 생성 파이프라인입니다. 웹 페이지나 PDF를 텍스트 청크로 파싱하는 대신 스크린샷 타일로 렌더링하고, Qwen3-VL-Embedding 모델로 이미지 임베딩을 생성한 다음 FAISS 또는 Qdrant 벡터 인덱스에서 검색합니다. 표, 차트, 레이아웃 같은 시각적 구조가 유지되므로 텍스트 기반 파싱에서 흔히 놓치는 정보도 리더 모델이 질문에 답하는 데 활용할 수 있습니다.
PixelRAG은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
PixelRAG은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
PixelRAG은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. PixelRAG의 마지막 커밋은 2026년 10월 14일입니다.
PixelRAG은(는) 어디에 사용할 수 있나요?
표, 차트, 인포그래픽에 답이 담긴 문서를 검색합니다. Claude Code 같은 코딩 에이전트가 웹 페이지를 이미지로 읽도록 합니다. 비공개 PDF나 웹 페이지 모음에서 시각적 검색 인덱스를 구축합니다. 호스팅된 Wikipedia 인덱스에서 스크린샷 기반 검색을 실험합니다.
PixelRAG은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/StarTrail-org/PixelRAG

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

관련 프로젝트