{"id":30067092,"url":"https://github.com/statico/llm-tools-brave","last_synced_at":"2025-08-08T08:06:47.850Z","repository":{"id":300426411,"uuid":"993527772","full_name":"statico/llm-tools-brave","owner":"statico","description":"A tool plugin for LLM to support web search via Brave","archived":false,"fork":false,"pushed_at":"2025-06-21T16:13:39.000Z","size":63,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T16:35:47.481Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/statico.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T00:33:00.000Z","updated_at":"2025-06-21T16:13:42.000Z","dependencies_parsed_at":"2025-06-21T16:35:58.664Z","dependency_job_id":"dc0b379d-3e86-4904-a157-4f3aae5d3726","html_url":"https://github.com/statico/llm-tools-brave","commit_stats":null,"previous_names":["statico/llm-tools-brave"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/statico/llm-tools-brave","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fllm-tools-brave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fllm-tools-brave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fllm-tools-brave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fllm-tools-brave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/statico","download_url":"https://codeload.github.com/statico/llm-tools-brave/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fllm-tools-brave/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269385800,"owners_count":24408433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-08T08:06:44.787Z","updated_at":"2025-08-08T08:06:47.837Z","avatar_url":"https://github.com/statico.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# llm-tools-brave\n\nA tool plugin for [LLM](https://llm.datasette.io/) that allows you to search the web using [Brave Search API](https://brave.com/search/api/).\n\n[![PyPI](https://img.shields.io/pypi/v/llm-tools-brave.svg)](https://pypi.org/project/llm-tools-brave/)\n[![Tests](https://github.com/statico/llm-tools-brave/actions/workflows/test.yml/badge.svg)](https://github.com/statico/llm-tools-brave/actions/workflows/test.yml)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/statico/llm-tools-brave/blob/main/LICENSE)\n\n## Installation\n\nInstall this plugin in the same environment as [LLM](https://llm.datasette.io/):\n\n```bash\nllm install llm-tools-brave\n```\n\n## Usage\n\nCreate an account at [Brave Search API](https://api-dashboard.search.brave.com/) and get your API key. Add it to llm with `llm keys set brave`.\n\nThis plugin provides four search tools which can be bundled together or provided separately.\n\nUse `-T Brave` to include all tools, or use individual tool names: `-T web_search`, `-T image_search`, `-T news_search`, `-T video_search`.\n\n### web_search\n\nSearch the web for high-quality, relevant results with descriptions and snippets:\n\n```bash\nllm -m claude-4-sonnet -T web_search \"search the web to get today's weather in nyc\"\n```\n\n### image_search\n\nSearch for images with metadata and thumbnails:\n\n```bash\nllm -m claude-4-sonnet -T image_search \"find images of golden retrievers\"\n```\n\n### news_search\n\nSearch for recent news articles with age and source information:\n\n```bash\nllm -m claude-4-sonnet -T news_search \"latest news about AI developments\"\n```\n\n### video_search\n\nSearch for videos with duration, thumbnails, and source information:\n\n```bash\nllm -m claude-4-sonnet -T video_search \"python programming tutorials\"\n```\n\n## Features\n\n- **Web Search**: Get comprehensive web results with descriptions and extra snippets\n- **Image Search**: Find images with metadata, dimensions, and thumbnail previews\n- **News Search**: Access recent news articles with publication timing\n- **Video Search**: Discover videos with duration and preview information\n- **Advanced Filtering**: Support for country-specific results, language preferences, freshness filters, and domain inclusion/exclusion\n- **Error Handling**: Robust error handling with informative error messages\n\n## Development\n\nTo set up this plugin locally, first checkout the code. Then create a new virtual environment:\n\n```bash\ncd llm-tools-brave\npython -m venv venv\nsource venv/bin/activate\n```\n\nInstall the dependencies and test dependencies:\n\n```bash\npip install -e '.[test]'\n```\n\nTo run the tests:\n\n```bash\npytest\n```\n\n## Dependencies\n\n- [llm](https://llm.datasette.io/): The LLM CLI tool this plugin extends\n- [httpx](https://www.python-httpx.org/): For making HTTP requests to the Brave Search API\n\n## Credits\n\n\u003e [!NOTE]\n\u003e This is a fork of [llm-tools-exa](https://github.com/daturkel/llm-tools-exa) by [Dan Turkel](https://github.com/daturkel), converted from the Exa API to Brave Search API. All credit for the original implementation goes to Dan Turkel. This conversion was mostly vibe coded with Claude 4 and Cursor.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatico%2Fllm-tools-brave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstatico%2Fllm-tools-brave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatico%2Fllm-tools-brave/lists"}