# vectifyai/pageindex

> PageIndex is a vectorless, reasoning-based RAG engine for long, complex professional documents such as financial reports, legal documents and technical manuals. Instead of splitting documents into chunks and searching vector embeddings, it builds a hierarchical tree index for each document and has an LLM reason its way through that tree to find relevant sections. The project is written in Python and published on PyPI as the pageindex package.

Source: https://github.com/vectifyai/pageindex
Indexed: commit d2693d8 on 2026-09-30 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 40,446 at index time
- License: MIT
- Code health: 5.1/10, Needs_work
- Last commit: 2026-09-24
- Contributors: 21

## Install

From the README: https://github.com/vectifyai/pageindex#quickstart

Install PageIndex from PyPI.
    pip install -U pageindex

Import the client class.
    from pageindex import PageIndexClient

Submit a PDF to build its tree index and keep the returned document ID.
    doc_id = client.submit_document("report.pdf")["doc_id"]

## How it works

Documents enter as files such as PDFs and are passed to PageIndexClient, which is imported from pageindex. pageindex/flash/main.py is one of the two entry points and runs the PageIndex Flash pipeline that builds the tree index for text-based PDFs. The pageindex/flash/clustering directory groups visual and positional evidence into stable regions and proposes candidates that later assembly can use as structural anchors. The pageindex/flash/labels directory models blocks, lines, spans and caption-like areas as bounded regions, so captions are handled as regions rather than stray text. pageindex/local_chat.py is one of the hotspot files for chat in local mode, where an LLM answers questions from the retrieved parts of the tree, and each finished index is saved as a JSON file that later questions reuse.

- .github/scripts/autoclose-labeled-issues.js: entry point
- pageindex/flash/main.py: entry point
- .claude/commands/dedupe.md: central file
- .github/dependabot.yml: central file
- .github/scripts/comment-on-duplicates.sh: central file
Modules: pageindex, tests, .github, root. 140 files, 33,728 lines, 2,040 symbols.

## Code health

- Score: 5.1/10 (Needs_work)
- Rank: #239 of 4,000+ indexed repos
- Hotspots: pageindex/client.py, pageindex/local_chat.py, pageindex/utils.py, pageindex/agent_tools.py, pageindex/tree_optimize.py
- Lowest file: pageindex/client.py
- Dead code: 2 findings

## Maintenance

- Last commit 2026-09-24, first commit 2025-04-01, 480 commits
- 21 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/vectifyai/pageindex/security

## More

- Page: https://repowise.dev/repo/vectifyai/pageindex
- Ask this codebase: https://repowise.dev/repo/vectifyai/pageindex/chat
- Docs: https://repowise.dev/repo/vectifyai/pageindex/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/vectifyai/pageindex
