Hadrian is experimental alpha software. Do not use in production.
Hadrian
ConfigurationFeatures

Web Search

Configure web search providers for the web_search tool

The [features.web_search] section configures web search providers that can be used by the web_search tool in chat conversations.

Configuration Reference

Main Settings

[features.web_search]
enabled = true
default_provider = "tavily"
max_results = 10
KeyTypeDefaultDescription
enabledbooleantrueEnable web search
default_providerstringnoneDefault provider name
max_resultsinteger10Maximum results to return

Providers

Tavily

AI-optimized search API:

[[features.web_search.providers]]
type = "tavily"
api_key = "${TAVILY_API_KEY}"
KeyTypeDescription
api_keystringTavily API key

Privacy-focused search API:

[[features.web_search.providers]]
type = "brave"
api_key = "${BRAVE_SEARCH_API_KEY}"
KeyTypeDescription
api_keystringBrave Search API key

Google search via Custom Search JSON API:

[[features.web_search.providers]]
type = "google"
api_key = "${GOOGLE_API_KEY}"
search_engine_id = "${GOOGLE_CSE_ID}"
KeyTypeDescription
api_keystringGoogle API key
search_engine_idstringCustom Search Engine ID

Microsoft Bing Web Search API:

[[features.web_search.providers]]
type = "bing"
api_key = "${BING_SEARCH_API_KEY}"
KeyTypeDescription
api_keystringBing Search API key

SerpAPI

Scraping-based search API (Google, Bing, etc.):

[[features.web_search.providers]]
type = "serp"
api_key = "${SERPAPI_KEY}"
KeyTypeDescription
api_keystringSerpAPI key

Complete Example

[features.web_search]
enabled = true
default_provider = "tavily"
max_results = 10

[[features.web_search.providers]]
type = "tavily"
api_key = "${TAVILY_API_KEY}"

[[features.web_search.providers]]
type = "brave"
api_key = "${BRAVE_SEARCH_API_KEY}"

[[features.web_search.providers]]
type = "google"
api_key = "${GOOGLE_API_KEY}"
search_engine_id = "${GOOGLE_CSE_ID}"

Provider Comparison

ProviderPricingBest For
TavilyFreemiumAI/LLM applications, clean results
BraveFreemiumPrivacy-conscious, web search
GooglePay-per-queryComprehensive results, custom filtering
BingPay-per-queryMicrosoft ecosystem
SerpAPIPay-per-queryMultiple search engines, SERP data

Web search results are formatted for LLM consumption and injected into the conversation context.

On this page