explaingit

startrail-org/pixelrag

Analysis updated 2026-05-18

33JSONAudience · developerComplexity · 5/5LicenseSetup · hard

TLDR

A retrieval system that indexes and searches document screenshots directly, so tables and charts stay searchable.

Mindmap

mindmap
  root((PixelRAG))
    What it does
      Renders pages to tiles
      Indexes images directly
      Searches visual content
    Tech stack
      Python
      Qwen3-VL-Embedding
      FAISS
      FastAPI
    Use cases
      Search Wikipedia index
      Build a custom image index
      Give Claude a pixelbrowse skill
    Audience
      Developers
      AI researchers
      RAG builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search a pre-built 8.28 million page Wikipedia index by visual content.

USE CASE 2

Build a searchable image index from your own documents or web pages.

USE CASE 3

Use the pixelbrowse Claude Code plugin so Claude can read screenshots instead of raw HTML.

USE CASE 4

Fine-tune the Qwen3-VL-Embedding model on your own screenshot data.

What is it built with?

PythonFAISSFastAPIQwen3-VL-EmbeddingPlaywright

How does it compare?

startrail-org/pixelragmdn/browser-compat-datafyrd/caniuse
Stars335,6635,835
LanguageJSONJSONJSON
Setup difficultyhardeasyeasy
Complexity5/52/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Full pipeline needs GPU-based embedding, pinned CUDA and PyTorch versions, and a separate uv environment for training.

Apache-2.0 license: use, modify, and distribute freely, including commercially, with attribution and no patent claims against contributors.

In plain English

Most search systems work by extracting text from a document and indexing that text. Tables, charts, diagrams, and anything that depends on visual layout are often reduced to fragments or lost entirely during that extraction step. PixelRAG takes a different approach: it converts documents into screenshot tiles and indexes the images directly, so visual structure stays intact for the AI model that reads the retrieved results. The project ships with a pre-built index of 8.28 million Wikipedia pages that you can query immediately through a hosted API or by running the search server locally. It also includes a command-line tool called pixelshot that renders any web page or PDF into screenshot tiles, and a pipeline for building a searchable index from your own document collections. The retrieval model is a fine-tuned version of Qwen3-VL-Embedding, trained specifically on screenshot data so that images with similar visual content are placed close together in the embedding space. The tool also ships as a plugin for Claude Code called pixelbrowse. When the plugin is active, Claude can screenshot a web page and read the image rather than fetching raw HTML, which means it can interpret charts, tables, and formatted layouts the way a person would. The pipeline is split into stages: rendering, chunking, embedding, index building, and serving. You install only the stages you need. A separate training environment is included for fine-tuning the embedding model on your own data. The pre-trained adapter weights and the training dataset are both available on Hugging Face. The project comes from Berkeley AI research groups and is released under Apache-2.0.

Copy-paste prompts

Prompt 1
Explain how rendering pages to screenshot tiles helps preserve tables and charts compared to text-based RAG.
Prompt 2
Walk me through setting up the pixelbrowse Claude Code plugin from this repo.
Prompt 3
Help me build a custom pixelrag.yaml config to index my own local documents.
Prompt 4
What GPU and dependency setup do I need to run pixelrag-train for fine-tuning the embedding model?

Frequently asked questions

What is pixelrag?

A retrieval system that indexes and searches document screenshots directly, so tables and charts stay searchable.

What language is pixelrag written in?

Mainly JSON. The stack also includes Python, FAISS, FastAPI.

What license does pixelrag use?

Apache-2.0 license: use, modify, and distribute freely, including commercially, with attribution and no patent claims against contributors.

How hard is pixelrag to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is pixelrag for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.