Skip to content

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

Bump to v0.2.0, add PyPI publish workflow

Jordan7cb48029d99e
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 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/v1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-09
Initial 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.0
diff --git a/pyproject.toml b/pyproject.toml
index 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__.py
index 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"