KnockOutEZ/wigolo
The go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.
4,358 ★303 forksTypeScriptUpdated 1d ago
What you need to know
Local-first web intelligence for AI agents — one MCP/REST surface for search, fetch, crawl, extract, cache, find-similar, research, and autonomous agent loops. Keyless (no API keys, $0 per query), private (everything lives in ~/.wigolo/), with on-device ranking and embedding models.
Install
npx wigolo init npx wigolo init --agents=claude-code,cursor Docker: docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo
Usage
- •Requires Node >= 20 and ~1.5GB free disk (downloads browser engine + on-device models)
- •npx wigolo doctor to verify health; npx wigolo config --uninstall --yes to remove
- •Optional free Gemini key for synthesis: export WIGOLO_LLM_PROVIDER=gemini; export GEMINI_API_KEY=<free-key>
- •REST (no MCP client needed): wigolo serve; curl -X POST http://127.0.0.1:3333/v1/search
Key features
- ✓10 tools: search (18 engines, rank fusion, ML rerank), fetch (tiered HTTP→headless-browser on anti-bot challenges), crawl, extract, cache, find_similar, research, agent, diff, watch
- ✓Explainable per-result evidence scores, verbatim excerpts pinned to byte-offset source spans, citation IDs, freshness signals
- ✓Keyless by default; local cache makes re-querying instant; on-device reranker + embeddings
- ✓REST API (OpenAPI 3.1), TypeScript & Python SDKs, Docker, and LangChain/CrewAI/LlamaIndex/Vercel AI SDK integrations
- ✓Public beta with a 7,600-test suite; actively maintained
Best for
Agents that need private, keyless, no-metered-bill web search, fetch, and crawl with transparent, inspectable evidence.
Caveats
- ⚠Public beta status
- ⚠Requires ~1.5GB disk for the on-device browser engine and ML models
- ⚠research/agent/search-answer synthesis needs an optional LLM key (free Gemini tier is enough) or local ollama
- ⚠AGPL-3.0 license (network-service obligation only if you run a modified version as a service)
- ⚠Some challenge-protected sites score IP reputation — datacenter IPs may not clear walls a home connection would
Platforms: macOS · Linux · WindowsClients: Claude Code · Cursor · Codex · Gemini CLI · OpenCode · VS Code · Windsurf · Zed · Antigravity · any MCP client
Documentation ↗Reviewed 2026-08-07
Topics
agentaiai-agentclaudeclideveloper-toolslocal-firstmcpmcp-servermetasearchmodel-context-protocolnodejsprivacyragsearchsearch-enginetypescriptweb-crawlerweb-scrapingweb-search
- Stars
- 4,358★
- Forks
- 303
- Language
- TypeScript
- License
- NOASSERTION
- Created
- 2026-04-12
- Last push
- 2026-08-06