Building autonomous deep research pipelines (like Stanford STORM or OpenAI Deep Research) typically faces two massive hurdles:
- Insane Token Burn: Ingesting dozens of raw web pages consumes 200k to 500k tokens per research question, costing $5 to $15 per report.
- Hallucinated Citations: When LLMs summarize long contexts, they frequently misattribute quotes or fabricate URLs and reference numbers.
To solve this, we engineered agent-deep-research — a local-first Python engine that slashes token consumption by over 85% while guaranteeing zero hallucinated citations through cryptographic SHA-256 provenance ledgers.
The Core Innovation: BM25 Lexical Distillation
Instead of feeding raw HTML or giant text blobs into the LLM context:
- The engine fetches candidate sources using free, zero-key endpoints (DuckDuckGo, Wikipedia, ArXiv).
- Content is partitioned into 250-word passages and indexed in an in-memory BM25 Lexical Matrix.
- Only the top-k highest density factual passages matching the query sub-claims are extracted.
- Each extracted fact is stamped with a cryptographic SHA-256 hash of the exact source text.
Raw Sources (250,000 tokens) | v [BM25 Fact Distiller] --> Cuts 87% Token Waste | v Distilled Facts (<18,000 tokens) + SHA-256 Hash Ledger | v [LLM Synthesizer] --> 100% Verifiable Citations Production Usage in Python
Install the package:
pip install agent-deep-research Run a zero-key deep research task:
from agent_deep_research import DeepResearcher, ResearchQuery researcher = DeepResearcher.create_default() # Execute multi-stage synthesis report = researcher.research( query="Solid-state battery commercialization breakthroughs 2026", max_sources=15, compress_ratio=0.15 # Keeps only top 15% highest-density information ) print(f"Report Title: {report.title}") print(f"Token Efficiency: Saved {report.tokens_saved_pct}% tokens") print(f"Citations Verified: {report.verified_citations_count} / {report.total_citations_count}") print(report.markdown_content) Native MCP Server Included
agent-deep-research also runs as a standalone Model Context Protocol (MCP) server:
python -m agent_deep_research.server Now Claude Desktop, Cursor, and open-source agents can invoke deep_research, quick_search, and verify_claim directly.
Sovereign Ecosystem & Open Source
- ⭐ GitHub Repository: https://github.com/BenniAlencar/agent-deep-research
- 🌐 Listed on Glama.ai: https://glama.ai/mcp/servers/uzomrlxpz3
- 🌐 Benni OS Portal: https://benni-os.net
