@oresk/pi-searxng

Pi extension that adds a web_search tool backed by a self-hosted SearXNG instance — a privacy-respecting meta search engine aggregating results from multiple engines.

Install

pi install @oresk/pi-searxng

Configuration

On first run, the extension creates a config file at:

~/.pi/agent/pi-searxng.jsonc

Edit it to configure your SearXNG instance and search preferences:

{
  // SearXNG instance URL.
  // Override with the SEARXNG_URL environment variable.
  "searxngUrl": "https://search.yourdomain.com",

  // Request timeout in milliseconds.
  "timeoutMs": 30000,

  // Maximum number of results per search (1–50).
  "maxResults": 10,

  // SafeSearch level: "off", "moderate", or "strict".
  "safesearch": "off"
}

The SEARXNG_URL environment variable takes priority over the config file:

export SEARXNG_URL="https://search.yourdomain.com"

If neither is set, it defaults to http://localhost:8080.

Setting up SearXNG

If you don't have a SearXNG instance yet, the easiest way is Docker:

docker run -d -p 8080:8080 \
  -e "SEARXNG_BASE_URL=http://localhost:8080/" \
  searxng/searxng

See the SearXNG docs for production setup.

Available Categories

The tool supports all SearXNG engine categories:

Category	Engines
general / web	Google, Brave, DuckDuckGo, Startpage
news	Bing News, Google News, Reuters, Yahoo News
it	StackOverflow, MDN, GitHub, PyPI, Docker Hub, Arch Wiki
science	arXiv, PubMed, Google Scholar, Semantic Scholar
packages	PyPI, Docker Hub, Hoogle
repos	GitHub
q&a	StackOverflow, AskUbuntu, SuperUser
images	Google Images, Bing Images, Unsplash, Pexels, Flickr
videos	YouTube, Vimeo, Dailymotion
social media	Mastodon, Lemmy
software wikis	Arch Linux Wiki, Gentoo Wiki
map	OpenStreetMap
weather	wttr.in
translate	Lingva, Dictzone
dictionaries / define	Wiktionary, Wordnik, Etymonline
music	Bandcamp, SoundCloud, YouTube
files	Pirate Bay, SolidTorrents
wikimedia	Wiktionary, Wikinews

License

MIT