Skip to content

https://arxiv.org/abs/2606.28344. The end of web parsing. The beginning of scalable pixel-native search. link: https://pixelrag.ai/

docs(pixelbrowse): recommend uv tool/pipx install so pixelshot is on PATH (#45)

Zhifei Li6da67820bf08
diff --git a/README.md b/README.md
index f92ed67..e6048f9 100644
--- a/README.md
+++ b/README.md
@@ -73,10 +73,12 @@ The renderer also ships as a Claude Code plugin — the **pixelbrowse** skill. I
raw HTML, Claude screenshots a page with `pixelshot` and _reads the image_, so it sees
charts, diagrams, tables, and layout the way a person does.
-Install it — no clone needed (`pixelshot` comes from `pip install pixelrag`):
+Install it — no clone needed. Install the `pixelshot` CLI so it's on your `PATH`
+(use `uv tool` or `pipx` to keep it isolated yet always available to Claude — a
+plain `pip install` into a project venv may leave `pixelshot` off `PATH`):
```bash
-pip install pixelrag # provides the pixelshot command
+uv tool install pixelrag # pixelshot on PATH (or: pipx install pixelrag)
claude plugin marketplace add StarTrail-org/PixelRAG
claude plugin install pixelbrowse@pixelrag-plugins
```
diff --git a/plugin/skills/pixelbrowse/SKILL.md b/plugin/skills/pixelbrowse/SKILL.md
index 4462baf..d5ef4cc 100644
--- a/plugin/skills/pixelbrowse/SKILL.md
+++ b/plugin/skills/pixelbrowse/SKILL.md
@@ -13,6 +13,10 @@ allowed-tools: "Bash, Read"
Use `pixelshot` to capture any URL or document as tiled JPEG images, then read the images visually.
+Requires the `pixelshot` command on `PATH`. If `pixelshot` is not found, install it
+(isolated, on `PATH`): `uv tool install pixelrag` (or `pipx install pixelrag`, or
+`pip install pixelrag`) — then retry. Don't go hunting for it in project venvs.
+
## How to use
```bash