Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself. Hosted API + MCP: hyperresearch.ai
Python agentsagentskillscitationsclaude-codecodexcodex-plugincodex-skilldeep-researchdeep-research-agentdeepresearchmcp-serverresearchresearch-agentresearch-tools
Bump to v0.2.0, add PyPI publish workflow
Jordan7cb48029d99e
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.ymlnew file mode 100644index 0000000..a4ff2dd--- /dev/null+++ b/.github/workflows/publish.yml@@ -0,0 +1,47 @@+name: Publish to PyPI++on:+ release:+ types: [published]++permissions:+ contents: read++jobs:+ build:+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4++ - uses: actions/setup-python@v5+ with:+ python-version: "3.13"++ - name: Install build tools+ run: pip install build++ - name: Build package+ run: python -m build++ - name: Upload artifact+ uses: actions/upload-artifact@v4+ with:+ name: dist+ path: dist/++ publish:+ needs: build+ runs-on: ubuntu-latest+ environment: pypi+ permissions:+ id-token: write++ steps:+ - name: Download artifact+ uses: actions/download-artifact@v4+ with:+ name: dist+ path: dist/++ - name: Publish to PyPI+ uses: pypa/gh-action-pypi-publish@release/v1diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b3893fa..64ed68f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,45 @@# Changelog+## [0.2.0] - 2026-04-10++### New++- **`/research` skill** — Scripted deep research workflow as a Claude Code slash command. Clarifies ambiguous requests, searches broadly, fetches aggressively, follows rabbit holes, auto-curates, synthesizes, and presents findings with hub notes+- **`hyperresearch setup`** — Interactive TUI onboarding: web provider, browser profile selection/creation, agent hooks. Auto-launches on first `install`+- **`hyperresearch fetch-batch`** — Concurrent multi-URL fetch with batched sync (O(1) syncs instead of O(n))+- **`hyperresearch link --auto`** — Holistic auto-linking: scans notes for mentions of other notes' titles and appends wiki-links+- **`hyperresearch assets list/path`** — Browse downloaded screenshots and images+- **`--save-assets` flag** — Opt-in screenshot + content image download on fetch+- **`--visible` flag** — Non-headless browser for stubborn auth sites (auto-enabled for LinkedIn, Twitter, Facebook, Instagram, TikTok)+- **`--max-tokens` on search** — Token budget truncation for context-aware agents+- **Auto-curation at fetch time** — Notes arrive with auto-generated tags and summaries+- **MCP write tools** — `fetch_url`, `create_note`, `update_note` (MCP server is now read-write)+- **MinHash+LSH dedup** — O(n) approximate dedup for large vaults (200+ notes), falls back to brute-force for small vaults+- **Hub notes auto-surfaced** after research sessions+- **Synthesis notes** saved as feedback loop (agent Q&A becomes searchable)+- **`hyperresearch-fetcher` subagent** — Haiku-powered URL fetcher installed to `.claude/agents/`+- **Login wall detection** — `AUTH_REQUIRED` error instead of saving login page junk+- **Smart SPA wait** — Polls DOM stability (2s initial + 10s ceiling) instead of fixed delays++### Changed++- **crawl4ai is the sole browser provider** — Removed firecrawl, tavily, trafilatura+- **crawl4ai v0.8.x API** — AsyncWebCrawler, BrowserConfig, CrawlerRunConfig, arun/arun_many+- **Authenticated crawling** via crawl4ai browser profiles (`crwl profiles` or setup TUI)+- **CLI path baked into CLAUDE.md** — Works without venv activation (forward slashes for Windows bash)+- **Deep research philosophy** — Agent docs say "over-collect, then prune" and "go down rabbit holes"+- **Windows encoding fix** — `stream.reconfigure(encoding="utf-8")` at startup, no more charmap crashes+- **Note slugs capped at 80 chars** — Avoids Windows MAX_PATH issues+- **Anti-bot stealth always on** when crawl4ai is used (no setup question)+- **Config commands** now support `web.provider`, `web.profile`, `web.magic`++### Removed++- Dead fields: `confidence`, `superseded_by`, `llm_compiled`, `llm_model`, `compile_source`+- Tag plural normalization (use explicit `tag_aliases` instead)+- `deprecated-no-successor` and `low-confidence` lint rules+- Firecrawl, Tavily, Trafilatura web providers+## [0.1.0] - 2026-04-09Initial release. Forked from [llm-kasten](https://github.com/jordan-gibbs/llm-kasten) and repositioned for agent-driven research workflows.@@ -28,4 +68,5 @@ Initial release. Forked from [llm-kasten](https://github.com/jordan-gibbs/llm-ka- Web viewer with force-directed knowledge graph- 70 tests+[0.2.0]: https://github.com/jordan-gibbs/hyperresearch/releases/tag/v0.2.0[0.1.0]: https://github.com/jordan-gibbs/hyperresearch/releases/tag/v0.1.0diff --git a/pyproject.toml b/pyproject.tomlindex c199993..c8166bf 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "hatchling.build"[project]name = "hyperresearch"-version = "0.1.0"+version = "0.2.0"description = "Agent-driven research knowledge base. Browse, collect, and synthesize web sources into a searchable wiki."readme = "README.md"license = "MIT"diff --git a/src/hyperresearch/__init__.py b/src/hyperresearch/__init__.pyindex a2e70f5..bb3f10c 100644--- a/src/hyperresearch/__init__.py+++ b/src/hyperresearch/__init__.py@@ -1,3 +1,3 @@"""Hyperresearch — agent-driven research knowledge base."""-__version__ = "0.1.0"+__version__ = "0.2.0"