Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ Local-first web intelligence for AI agents — **no keys, no cloud, no metered b
<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>

<sub>sponsored by</sub><br>
<a href="https://wigolo.app/go/testmu/?ref=readme-top"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/testmu-ai-dark.svg"><img alt="TestMu AI" src="assets/sponsors/testmu-ai.svg" height="20"></picture></a>
<a href="https://wigolo.app/go/testmu/?ref=readme-top"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/testmu-ai-dark.svg"><img alt="TestMu AI" src="assets/sponsors/testmu-ai.svg" height="20"></picture></a>&nbsp;&nbsp;&nbsp;
<a href="https://wigolo.app/go/fluxion/?ref=readme-top"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/fluxion-ai-dark.png"><img alt="Fluxion AI" src="assets/sponsors/fluxion-ai.png" height="20"></picture></a>

[Quickstart](#quickstart) · [Tools](#tools) · [Why wigolo](#why-its-different) · [Discord](https://discord.gg/BkUUgz2bNF) · [Sponsors](#sponsors) · [Benchmark](#benchmark) · [Docs](docs/README.md) · [Examples](examples/README.md) · [Licensing](LICENSING.md) · [Feedback](#beta--feedback) · [FAQ](#faq)

Expand Down Expand Up @@ -419,6 +420,17 @@ Thank you to the sponsors below, who help keep wigolo maintained and free for ev

<sub>**[TestMu AI](https://wigolo.app/go/testmu/?ref=readme)** (formerly LambdaTest) is the world's first full-stack agentic AI quality engineering platform, trusted by 18,000+ enterprises.</sub>

<br>

<a href="https://wigolo.app/go/fluxion/?ref=readme">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/fluxion-ai-dark.png">
<img alt="Fluxion AI" src="assets/sponsors/fluxion-ai.png" height="32">
</picture>
</a>

<sub>**[Fluxion AI](https://wigolo.app/go/fluxion/?ref=readme)** provides reliable, cost-efficient access to GPT, Claude, and other leading AI models through one unified API. Save up to 70% compared with official API pricing — and get $1 in API credits when you sign up through this link.</sub>

</div>

**wigolo is free for everyone.** If you or your company would like to help keep it maintained, there's room for more sponsors — reach out at **[ktowhid20@gmail.com](mailto:ktowhid20@gmail.com)**, or see [what sponsorship includes](https://wigolo.app/sponsors/) and the terms in [SPONSORS.md](SPONSORS.md). A one-off via [Buy Me a Coffee](https://buymeacoffee.com/knockoutez) is welcome too.
Expand Down
14 changes: 14 additions & 0 deletions SPONSORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,20 @@ engineering platform, trusted by 18,000+ enterprises.
TestMu AI is wigolo's first sponsor. Thanks for the support.


### Fluxion AI

<a href="https://wigolo.app/go/fluxion/?ref=sponsors-page">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/fluxion-ai-dark.png">
<img alt="Fluxion AI" src="assets/sponsors/fluxion-ai.png" height="40">
</picture>
</a>

[Fluxion AI](https://wigolo.app/go/fluxion/?ref=sponsors-page) provides reliable,
cost-efficient access to GPT, Claude, and other leading AI models through one
unified API. Save up to 70% compared with official API pricing — and get $1 in
API credits when you sign up through this link.

## Want to sponsor wigolo?

There is room for more companies and individuals alongside the sponsors above.
Expand Down
Binary file added assets/sponsors/fluxion-ai-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/sponsors/fluxion-ai.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 5 additions & 3 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,11 +112,13 @@ Core tools never need an LLM. Configuring one adds answer synthesis (`format: "a

Any service that speaks the OpenAI API works through the `openai` provider: set its base URL, its key, and one of its model names.

> **Sponsored example.** [Fluxion AI](https://wigolo.app/go/fluxion/?ref=docs) sponsors wigolo. Any OpenAI-compatible provider works the same way — swap in its base URL, key and model name. The full walkthrough is in [examples/llm-synthesis-fluxion](../examples/llm-synthesis-fluxion/).

```bash
export WIGOLO_LLM_PROVIDER=openai
export OPENAI_BASE_URL=https://api.example.com/v1 # the service's OpenAI-compatible endpoint
export OPENAI_API_KEY=sk-... # your key for that service
export WIGOLO_LLM_MODEL=model-name # one of its model ids
export OPENAI_BASE_URL=https://fluxionai.world/v1
export OPENAI_API_KEY=sk-... # your Fluxion AI key
export WIGOLO_LLM_MODEL=claude-haiku-4-5
```

### Keyless local ladder
Expand Down
1 change: 1 addition & 0 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ self-hosted automation (n8n-style platforms, cron jobs, plain shell).
| [n8n-remote-mcp](./n8n-remote-mcp/) | config reference: point self-hosted n8n (or any remote MCP/REST client) at `wigolo serve` |
| [watch-changelog-webhook](./watch-changelog-webhook/) | change-watch jobs on a changelog, on-demand checks, diff reports, webhook delivery |
| [plugin-search-engine](./plugin-search-engine/) | minimal `searchEngine` plugin — extend wigolo's engine set with your own source |
| [llm-synthesis-fluxion](./llm-synthesis-fluxion/) | sponsored example: answer synthesis and research briefs through Fluxion AI's OpenAI-compatible API |

## Previews

Expand Down
43 changes: 43 additions & 0 deletions examples/llm-synthesis-fluxion/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# answer synthesis through Fluxion AI

> **Sponsored example.** [Fluxion AI](https://wigolo.app/go/fluxion/?ref=docs) sponsors wigolo. Search, fetch, crawl and extract never need a model; this only adds synthesis on top. Any OpenAI-compatible provider works the same way — see [Swapping providers](#swapping-providers).

wigolo's core tools run keyless. An LLM adds three things on top: `format: "answer"` on `search`, essay-grade briefs from `research`, and a structured-extraction fallback. This wires those up through Fluxion AI's OpenAI-compatible API.

## Set it up

1. Create a key at [Fluxion AI](https://wigolo.app/go/fluxion/?ref=docs).
2. Point wigolo's `openai` provider at Fluxion:

```bash
export WIGOLO_LLM_PROVIDER=openai
export OPENAI_BASE_URL=https://fluxionai.world/v1
export OPENAI_API_KEY=sk-... # your Fluxion AI key
export WIGOLO_LLM_MODEL=claude-haiku-4-5
```

`claude-haiku-4-5` is fast and inexpensive for synthesis; any model from Fluxion's model list works.

For an agent wired over MCP, put the same variables in the server's `env` block, for example in Claude Code:

```bash
claude mcp add wigolo --scope user \
-e WIGOLO_LLM_PROVIDER=openai \
-e OPENAI_BASE_URL=https://fluxionai.world/v1 \
-e OPENAI_API_KEY=sk-... \
-e WIGOLO_LLM_MODEL=claude-haiku-4-5 \
-- npx -y wigolo
```

## Try it

```bash
npx wigolo search "what changed in the latest node.js release" --format=answer
npx wigolo research "compare sqlite fts5 and tantivy for local search"
```

`search` returns a cited answer instead of evidence only, and `research` returns a written brief. Without a model configured, both still work and return the structured evidence for your agent to write from.

## Swapping providers

The same three variables point wigolo at any OpenAI-compatible service that takes an API key: change `OPENAI_BASE_URL`, `OPENAI_API_KEY` and `WIGOLO_LLM_MODEL`. Anthropic, OpenAI, Gemini and Groq also have first-class providers, and a local model server needs no key at all — see [configuration](../../docs/configuration.md#llm-providers-optional).
Binary file added site/public/sponsors/fluxion-ai-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/public/sponsors/fluxion-ai.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions site/src/lib/sponsors.ts
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,20 @@ export const SPONSORS: readonly Sponsor[] = [
},
since: "2026",
},
{
slug: "fluxion",
name: "Fluxion AI",
description:
"Fluxion AI provides reliable, cost-efficient access to GPT, Claude, and other leading AI models through one unified API. Save up to 70% compared with official API pricing — and get $1 in API credits when you sign up through this link.",
url: "https://fluxionai.world/register?source=github&campaign=github-wigolo&promo=WIGOLO",
logo: {
light: "/sponsors/fluxion-ai.png",
dark: "/sponsors/fluxion-ai-dark.png",
width: 799,
height: 160,
},
since: "2026",
},
];

export const getSponsor = (slug: string): Sponsor | undefined =>
Expand Down