Hypatia

Research, made traceable.
Open-source AI research agent for scientific work.

Hypatia extends Pi with source-backed workflows to discover, compare, verify, and reproduce research, with reports and provenance saved to your workspace.

Quick start

Requires Node.js 22.22 or newer.

npm install -g @tquang122/hypatia
hypatia setup
hypatia "what do we know about scaling laws"

Use hpt as a shorter alias. See the installation guide for standalone installers, pinned versions, and skills-only setup. The setup guide covers providers and local models.

Research workflows

/wiki init creates empty source/concept folders; ingested knowledge remains a proposal until reviewed and applied. When research workflows delegate, the lead can pass selected wiki pages, claim status, and original source URLs to the evidence-scout; the scout verifies the originals and records which wiki pages it consulted.

Reports and provenance are saved in outputs/; paper-style drafts go in papers/. Use /outputs to search and preview them alongside drafts and other research artifacts.

The built-in research-diagrams skill guides source-grounded Mermaid diagrams for chat and saved research artifacts.

Chat TUI

The fullscreen chat includes searchable /help, citation browsing with /sources, and research-agent progress above the composer. The pinned prompt uses a subtle theme-matched background and a muted divider on taller terminals. When scrolled up, Pi's single built-in ↓ Jump to latest message · Esc control returns to the newest output. In fullscreen mode, Esc is assigned to this scroll action and takes precedence over Pi's normal interrupt shortcut. Clicking the control preserves any draft. Pi 1.2 validates themes at startup and fixes inline images in Herdr, mouse-wheel handling around focused fullscreen overlays, and custom-editor compaction colors. The /sources citation list and /idea model selector also respond to the mouse wheel. /outputs opens a searchable artifact browser with text previews and report/provenance pairing; /compact and summarized /tree navigation preserve research context.

Chat equations use Pi's built-in LaTeX-to-Unicode rendering for supported notation. Write display equations as standalone $$...$$ or \[...\] blocks; they keep normal upright text styling. Saved transcript text and exports stay unchanged.

Configure per-role model, fallback, and thinking choices with /model-routes or hypatia model routes. See the model routing guide.

Sources and evaluation

Hypatia searches scholarly databases, public code, the web, and Hugging Face, and reads local PDFs and documents. AlphaXiv public search supports semantic, keyword, and fast title modes, date filters, ranking choices, and result limits. Public paper reading and linked GitHub implementation lookup also work without sign-in; agentic search, PDF Q&A, and repository file reading remain optional account features. Hypatia can also recover legal open-access copies for paywalled papers. See the tool documentation.

hypatia alpha search --mode title "Attention Is All You Need"
hypatia alpha search --published-after 2025-01-01 --prioritize recency --limit 20 "long-context retrieval"
hypatia alpha implementations 1706.03762

Optional local Kev advice is off by default. When enabled, hypatia_kev_advisory returns scores and a separate suggested order without changing source results. Each suggestion includes its source rank, suggested rank, and signed kevRankDelta (positive means moved up); scores are ranking signals, not calibrated confidence. It accepts loopback services only; see the Kev setup and limits.

Benchmark details and score adapters are documented in evals/README.md. Telemetry is off unless you opt in with HYPATIA_TELEMETRY=1 and your own PostHog key; prompts, model output, paper text, and tool arguments are excluded.

Contributing

git clone https://github.com/TQuang122/hypatia.git
cd hypatia
npm install
npm test

See CONTRIBUTING.md · Documentation · Release notes · MIT License