{"id":13595081,"url":"https://github.com/brave/goggles-quickstart","last_synced_at":"2026-02-09T19:07:38.830Z","repository":{"id":37844511,"uuid":"506163521","full_name":"brave/goggles-quickstart","owner":"brave","description":"Educational material to learn about Goggles and how to create your own. ","archived":false,"fork":false,"pushed_at":"2024-08-14T03:17:38.000Z","size":201,"stargazers_count":670,"open_issues_count":25,"forks_count":67,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-07-18T09:04:18.591Z","etag":null,"topics":["ranking","search","transparency"],"latest_commit_sha":null,"homepage":"https://search.brave.com/goggles","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brave.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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}},"created_at":"2022-06-22T08:34:06.000Z","updated_at":"2025-07-17T22:00:49.000Z","dependencies_parsed_at":"2024-11-06T17:38:53.898Z","dependency_job_id":"2e2b47e9-c7e7-4e57-a675-ede56fb79c36","html_url":"https://github.com/brave/goggles-quickstart","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brave/goggles-quickstart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brave%2Fgoggles-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brave%2Fgoggles-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brave%2Fgoggles-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brave%2Fgoggles-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brave","download_url":"https://codeload.github.com/brave/goggles-quickstart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brave%2Fgoggles-quickstart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266586905,"owners_count":23952205,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["ranking","search","transparency"],"created_at":"2024-08-01T16:01:43.642Z","updated_at":"2026-02-09T19:07:33.506Z","avatar_url":"https://github.com/brave.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eBrave Search Goggles\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e\n    Search\n    · Open Ranking\n    · Algorithmic Transparency\n  \u003c/em\u003e\n  \u003cbr /\u003e\n  \u003cem\u003e\n    \u003ca href=\"https://search.brave.com/goggles\"\u003eTry it\u003c/a\u003e\n    · \u003ca href=\"https://search.brave.com/goggles/discover\"\u003eDiscover\u003c/a\u003e\n    · \u003ca href=\"https://brave.com/goggles\"\u003eWhitepaper\u003c/a\u003e\n  \u003c/em\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\nGoggles enable anyone, be it individuals or a community, to alter the ranking\nof Brave search by using a set of instructions (rules and filters). Anyone can\ncreate, apply, or extend a Goggle. Essentially Goggles act as a custom\nre-ranking on top of Brave’s search index.\n\nThis means that, instead of a single ranking, Brave Search can offer an almost\nlimitless number of ranking options. While Brave Search doesn't have editorial\nbiases, all search engines have some level of intrinsic bias due to underlying\ndata (the Web) and some algorithmic choices of features to select. Goggles\nallows for users to counter such intrinsic biases in the ranking, and also to\ncreate custom search experiences that couldn’t be covered by an all-purpose\nsearch engine such as Brave Search.\n\nGoggles are owned solely by their creators and, if public, can be used by\nanyone on top of Brave Search index.\n\nWant to start building your own goggles, or fork or extend existing ones? Check\nout our Goggles [quickstart guide](./goggles/quickstart.goggle).\n\nWant to learn more about the motivation for Goggles? Check out the [Goggles whitepaper](https://brave.com/goggles).\n\n## [Getting Started](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#getting-started)\n\n* [Goggles syntax](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#goggles-syntax)\n* [Creating a Goggle](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#creating-a-goggle)\n* [Updating a Goggle](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#updating-a-goggle)\n* [Deleting a Goggle](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#deleting-a-goggle)\n* [Learn by example](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#learn-by-example)\n* [Fine-tuning a Goggle](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#fine-tuning-a-goggle)\n* [Sharing a Goggle with the world](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#sharing-a-goggle-with-the-world)\n* [What happens when two instructions are conflicting?](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#what-happens-when-two-instructions-are-conflicting)\n* [How can I exclude any result not matched by my Goggle?](https://github.com/brave/goggles-quickstart/blob/main/getting-started.md#what-happens-when-two-instructions-are-conflicting)\n\n## [FAQ](https://github.com/brave/goggles-quickstart/blob/main/faq.md#faq)\n\n* [Who owns a Goggle?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#who-owns-a-goggle)\n* [Why can’t I apply multiple Goggles at the same time?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#why-cant-i-apply-multiple-goggles-at-the-same-time)\n* [Can Goggles ownership be transferred?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#can-goggles-ownership-be-transferred)\n* [Do Goggles contribute to polarization?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#do-goggles-contribute-to-polarization)\n* [What’s next for Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#do-goggles-contribute-to-polarization)\n* [Why is Goggles in Beta?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#why-is-goggles-in-beta)\n* [Why is a particular page not recoverable with Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#why-is-a-particular-page-not-recoverable-with-goggles)\n* [Can anyone create a Goggle or is it only for developers?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#can-anyone-create-a-goggle-or-is-it-only-for-developers)\n* [How can I discover new Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#how-can-i-discover-new-goggles)\n\n\n## Privacy considerations\n\nTo apply a Goggle, a user needs to pass the Goggle URL together with a query.\nWe treat Goggle URLs with the same strict provisions we use to handle other\ndata elements (like IP or geo-coordinates) that could serve as identifiers.\nBrave does not track the queries of any of its users, and searching with\nGoggles is no exception. However, note that if a Goggle is used only by one, or\na very small number of people, the Goggle URL could serve as an identifier, and\nenable the creation of a profile of the user’s queries while using that\nparticular Goggle.\n\nLearn more about our [privacy policy](https://search.brave.com/help/privacy-policy).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrave%2Fgoggles-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrave%2Fgoggles-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrave%2Fgoggles-quickstart/lists"}