$git clone https://github.com/KnockOutEZ/wigoloLocal-first web intelligence for AI agents — no keys, no cloud, no metered bill.
| 1 | <div align="center"> |
| 2 | |
| 3 | <img alt="wigolo — the go-to web for your agent" src="assets/brand/wigolo-banner.png" width="640"> |
| 4 | |
| 5 | Local-first web intelligence for AI agents — **no keys, no cloud, no metered bill.** |
| 6 | |
| 7 | <sub>works with **Claude Code · Cursor · Codex · Gemini CLI · VS Code · Windsurf · Zed · Antigravity**</sub> |
| 8 | <br> |
| 9 | <sub>and beyond **LangChain · CrewAI · LlamaIndex · Vercel AI SDK · n8n & self-hosted agents · any MCP client · plain REST**</sub> |
| 10 | |
| 11 | [](https://www.npmjs.com/package/wigolo) |
| 12 | [](https://www.npmjs.com/package/wigolo) |
| 13 | [](https://github.com/KnockOutEZ/wigolo/stargazers) |
| 14 | [](https://github.com/KnockOutEZ/wigolo/actions/workflows/ci.yml) |
| 15 | [](https://nodejs.org) |
| 16 | [](https://modelcontextprotocol.io) |
| 17 | [](#license) |
| 18 | [](#beta--feedback) |
| 19 | [](https://x.com/yourtowhid) |
| 20 | |
| 21 | <a href="https://trendshift.io/repositories/79424?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-79424" target="_blank"><img src="https://trendshift.io/api/badge/repositories/79424" alt="wigolo on Trendshift" width="250" height="55"/></a> |
| 22 | <a href="https://trendshift.io/repositories/79424?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-79424" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/79424/daily?language=TypeScript" alt="KnockOutEZ%2Fwigolo | Trendshift" width="250" height="55"/></a> |
| 23 | |
| 24 | [Quickstart](#quickstart) · [Tools](#tools) · [Why wigolo](#why-its-different) · [Benchmark](#benchmark) · [Docs](docs/README.md) · [Examples](examples/README.md) · [Feedback](#beta--feedback) · [FAQ](#faq) |
| 25 | |
| 26 | New features and updates ship steadily. Follow <a href="https://x.com/yourtowhid"><b>@yourtowhid on X</b></a> for all of it and new ways to use wigolo, and reach out there for collaborations or feedback · also on <a href="https://www.linkedin.com/in/yourtowhid/">LinkedIn</a> |
| 27 | |
| 28 | </div> |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | wigolo gives an AI agent one surface for everything web-related: **search, fetch, crawl, extract, cache, find-similar, research,** and autonomous gather loops. It runs wherever your agent runs — as an MCP server next to your coding agent, as a REST/MCP endpoint on the box where your self-hosted agents live, or embedded through an SDK inside your own app. The core tools need no API keys, nothing it touches leaves `~/.wigolo/`, and no bill grows with how much your agent thinks. |
| 33 | |
| 34 | <div align="center"> |
| 35 | |
| 36 | <img alt="wigolo demo — Claude Code answering a live web question through wigolo, no API keys" src="assets/wigolo-demo.gif" width="800"> |
| 37 | |
| 38 | </div> |
| 39 | |
| 40 | ## Quickstart |
| 41 | |
| 42 | ```bash |
| 43 | npx wigolo init # set up the local engine — any system |
| 44 | npx wigolo init --agents=claude-code,cursor # …or set up + wire your day-to-day agents in one command |
| 45 | ``` |
| 46 | |
| 47 | Requires **Node ≥ 20** and ~1.5 GB of free disk on macOS, Linux, or Windows. Bare `init` sets up the local engine: it downloads the browser engine and on-device models, runs a health check, and reports each component. Adding `--agents` wires the named agents in the same run, so a coding agent you use daily is ready in one command. |
| 48 | |
| 49 | - **Supported agents** — `--agents` takes any of `claude-code` · `cursor` · `codex` · `gemini-cli` · `vscode` · `windsurf` · `zed` · `antigravi |