explaingit

knockoutez/wigolo

Analysis updated 2026-05-18

3,421TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A local, keyless toolkit that gives AI coding agents web search, page fetching, crawling, and research abilities with no cloud bill.

Mindmap

mindmap
  root((repo))
    What it does
      Web search for agents
      Fetch and crawl pages
      Extract structured data
      Autonomous research
    Tech stack
      TypeScript
      Node.js
      MCP protocol
    Use cases
      Give agent web access
      Research a topic
      Scrape and extract data
    Audience
      Vibe coders
      Developers
    Setup
      npx wigolo init
      No API key needed
      Optional free LLM key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let a coding agent like Claude Code or Cursor search the live web without any API key.

USE CASE 2

Fetch and clean up a single web page into readable text for an agent to use.

USE CASE 3

Crawl an entire site and pull structured data out of the pages.

USE CASE 4

Run an autonomous research task that gathers and cites sources on a topic.

What is it built with?

TypeScriptNode.jsMCP

How does it compare?

knockoutez/wigololidge-jun/opencodexgloridust/wechatoncloud
Stars3,4213,4093,323
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-26
MaintenanceActive
Setup difficultyeasyeasymoderate
Complexity2/53/54/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Needs Node 20+ and about 1.5GB disk space, advanced research features work best with a free LLM API key.

You can use, modify, and share the code, but if you run a modified version as a network service, you must also share your source code under the same license.

In plain English

wigolo gives an AI coding assistant a single set of tools for everything web related: searching, fetching pages, crawling sites, extracting structured data, caching results, finding similar content, and running research tasks on its own. It is designed to run locally on your own machine, next to tools like Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Zed, and others, or inside your own self hosted agent setup. The core tools work with no API keys and no cloud service, and nothing you search or fetch leaves your own computer's storage folder. Getting started is a single command, npx wigolo init, which downloads the local browser engine and on device models, checks that everything works, and reports the status of each piece. You can also tell it which coding agents to wire up automatically in that same command, so a tool you already use daily is ready right away. It needs Node version 20 or newer and about 1.5 gigabytes of free disk space, and works on macOS, Linux, and Windows. Search, fetch, crawl, extract, cache, and find similar all work without any paid key. Two more advanced tools, research and agent, use a language model to write a finished, cited answer instead of just returning raw search results, so those work better with a free API key from a provider like Gemini, though other providers or a fully local model work too. Every search result comes back with an exact excerpt from the source page, a citation the agent can quote, and a score showing how trustworthy that result is. Weak or unreliable results get flagged automatically, and any cached or stale data is labeled as such, so the agent always knows what it is working with. wigolo is offered under the AGPL 3.0 license and is currently in public beta.

Copy-paste prompts

Prompt 1
Set up wigolo and wire it into my Claude Code agent using npx wigolo init.
Prompt 2
Use wigolo to search the web for the latest documentation on a library I'm using.
Prompt 3
Fetch this URL with wigolo and summarize the page content for me.
Prompt 4
Run a wigolo research task on a topic and give me a cited answer.
Prompt 5
Show me how to configure a free Gemini key so wigolo's research tool writes full answers.

Frequently asked questions

What is wigolo?

A local, keyless toolkit that gives AI coding agents web search, page fetching, crawling, and research abilities with no cloud bill.

What language is wigolo written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does wigolo use?

You can use, modify, and share the code, but if you run a modified version as a network service, you must also share your source code under the same license.

How hard is wigolo to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is wigolo for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.