Skip to main content

Web search tools for Bub

Project description

bub-web-search

Provider-selectable web search tools for bub.

Providers

Set BUB_SEARCH_PROVIDER to enable exactly one search provider:

  • ollama registers web.search
  • searxng registers searxng.search

If the provider is unset or its required configuration is missing, neither tool is registered.

Installation

bub install bub-web-search

Run bub onboard to select a provider and write its configuration interactively.

Ollama

Required:

  • BUB_SEARCH_PROVIDER=ollama
  • BUB_SEARCH_OLLAMA_API_KEY

Optional:

  • BUB_SEARCH_OLLAMA_API_BASE
    • Default: https://ollama.com/api

The web.search tool accepts query and max_results.

SearXNG

Required:

  • BUB_SEARCH_PROVIDER=searxng
  • BUB_SEARCH_SEARXNG_BASE_URL

Optional:

  • BUB_SEARCH_SEARXNG_TIMEOUT_SECONDS
    • Default: 10
  • BUB_SEARCH_SEARXNG_DEFAULT_LANGUAGE
  • BUB_SEARCH_SEARXNG_DEFAULT_SAFE_SEARCH
    • 0 off, 1 moderate, 2 strict
    • Default: 1
  • BUB_SEARCH_SEARXNG_USER_AGENT
    • Default: bub-web-search/1.0
  • BUB_SEARCH_SEARXNG_AUTH_HEADER
  • BUB_SEARCH_SEARXNG_AUTH_VALUE

The searxng.search tool accepts:

  • query
  • max_results
  • categories
  • engines
  • language
  • time_range
  • safe_search

The SearXNG instance must allow JSON responses from its /search endpoint.

Migration From bub-searxng-search

Replace the package with bub-web-search, set BUB_SEARCH_PROVIDER=searxng, and rename the environment variables:

  • BUB_SEARXNG_SEARCH_BASE_URL to BUB_SEARCH_SEARXNG_BASE_URL
  • other BUB_SEARXNG_SEARCH_* variables to BUB_SEARCH_SEARXNG_*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bub_web_search-0.0.2.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bub_web_search-0.0.2-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file bub_web_search-0.0.2.tar.gz.

File metadata

  • Download URL: bub_web_search-0.0.2.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for bub_web_search-0.0.2.tar.gz
Algorithm Hash digest
SHA256 8ad8e429ac4f9bf5f691fc954814b71515e3bf271bb6fc92b3391aaf1a6e7fd8
MD5 23327b61066a893a954e2e91eeac8a61
BLAKE2b-256 04beccfb0f99b72b5152e8b3067c3df52d0db8d50b8cdd87190fb6b7637e9676

See more details on using hashes here.

File details

Details for the file bub_web_search-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: bub_web_search-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 8.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for bub_web_search-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 41d409f3f76bbff8b7e9e2e6be52035f175ed3505086d71044fe9b8767e0e555
MD5 5e5b13d78085832866d3f1505454c398
BLAKE2b-256 7a68b13432f227d19ed73ef9a6fb1ae0bd536d46926db3a4cb5a052be40c4fc4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page