brave-search-python-client

What it is and what it does

Brave Search Python Client is an async-first wrapper around the Brave Search API that lets you perform web, image, news, and video searches from Python code. It uses pydantic-settings for configuration, tenacity for resilience, and typer for its command-line interface. The library is designed to work with current Python versions (3.11, 3.12, 3.13) and includes both a programmatic API for integration into applications and a CLI for shell scripts.

Typical use cases include adding search capabilities to Python applications, giving language models access to current web information, and running searches from the command line. The package is in pre-alpha development status but actively maintained, with comprehensive documentation, examples, and test coverage.

Use it for:

• Integrate web search into Python applications so users can find current information without leaving your app.
• Add real-time web data to LLM applications to supplement model knowledge with current search results.
• Use the CLI in shell scripts to fetch search results in JSON format for further processing.
• Build image or video search features into web or desktop applications.
• Create news aggregation tools that pull recent articles on specific topics.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Brave Search API that supports web, image, news, and video search with both async library and CLI interfaces.

Yes, with conditions. The package is actively maintained, has low install friction, and offers a clean async API with CLI support. However, it is marked pre-alpha, so expect potential API changes. You must obtain a Brave Search API key and be aware of the free tier's 2,000 monthly request limit. If you need a stable, production-ready search client and can work within those constraints, this is a solid choice.

Install

brave-search-python-client on PyPI

pip install brave-search-python-client

uv add brave-search-python-client

poetry add brave-search-python-client

Installing brave-search-python-client

Before you install

Low install friction with a pure-Python wheel and only three runtime dependencies (pydantic-settings, tenacity, typer). Actively maintained with recent releases; last commit 2026-08-08.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects without restriction.

Quickstart

pip install brave-search-python-client

import asyncio
from brave_search_python_client import BraveSearch, WebSearchRequest

async def search():
    client = BraveSearch()
    response = await client.web(WebSearchRequest(q="python"))
    return response

asyncio.run(search())

Requires a Brave Search API key (obtain from https://brave.com/search/api/); free tier includes 2,000 requests per month.

Verify before relying

• Whether tenacity is used for automatic retry logic on API failures
• Specific rate-limiting behavior and how it interacts with the free tier quota

Package facts

Evidence: brave_search_python_client-0.4.27-py3-none-any.whl

Keywords: act, api, brave, brave-api, brave-search, brave-search-api, brave-search-python-client, bravesearch, bravesearchapi, codecov, copier, cyclonedx, detect-secrets, devcontainer, docker, git-cliff, jupyter, marimo, mypy, nox, oe-python-template, pip-audit, pip-licenses, pre-commit, pydantic, pypi, pytest, python, readthedocs, ruff, sonarcloud, sonarqube, sphinx, streamlit, typer, uv, web-search, websearch

Tags

More WWW/HTTP packages