Built-in tool for web search using Brave Search API.

Brave Search provides high-quality web search results with privacy focus.

Setup

You need a Brave Search API key to use this tool:

1. Get your API key from https://brave.com/search/api/

2. Set the environment variable:

   export BRAVE_API_KEY="your-api-key-here"

Or configure in your application:

config :nous,
  brave_api_key: System.get_env("BRAVE_API_KEY")

Rate Limits

• Free Plan: 1 query/second, up to 2,000 queries/month
• Base AI Plan: Up to 20 queries/second, 20M queries/month
• Pro AI Plan: Up to 50 queries/second, unlimited monthly queries

Usage

agent = Nous.new("lmstudio:qwen3-vl-4b-thinking-mlx",
  tools: [&BraveSearch.web_search/2]
)

{:ok, result} = Nous.run(agent, "What's the latest news about AI?")

The AI will automatically search the web when it needs current information.