Whoogle Search: A Privacy-Respecting, Ad-Free Metasearch Engine

Summary

Whoogle Search is a self-hosted metasearch engine that delivers Google results without ads, tracking, or JavaScript. It prioritizes user privacy and offers a customizable, clean search experience. Easily deployable via Docker or various cloud platforms, Whoogle provides a seamless transition to a more private search environment.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

Whoogle Search is a powerful, self-hosted metasearch engine designed to provide Google search results without ads, JavaScript, AMP links, cookies, or IP address tracking. It prioritizes user privacy and offers a clean, customizable search experience. Built with Python and Flask, Whoogle is easy to deploy and can serve as a primary search engine replacement on both desktop and mobile devices.

It's important to note that as of January 2025, Google has been challenging the ability to perform search queries without JavaScript, which is fundamental to Whoogle's operation. The project is actively working on workarounds to maintain its functionality.

Installation

Whoogle Search offers a variety of deployment options, making it accessible for different user preferences. The most straightforward method is often through Docker, allowing for quick setup and execution.

Key installation methods include:

Docker: Official images are available for linux/amd64 and linux/arm64, deployable via Docker CLI or docker-compose.
Cloud Platforms: One-click deployment options are provided for platforms like Heroku, Render, Repl.it, Fly.io, and Koyeb.
Python Package Managers: Installable via pipx for persistent or sandboxed instances, or directly with pip.
Manual Installation: For those who prefer more control, it can be cloned and run from source, with systemd configuration examples provided.
Arch Linux: Available as an AUR package and through Chaotic-AUR.
Kubernetes: A Helm chart is available for Kubernetes deployments.

For detailed instructions on each method, please refer to the official GitHub repository.

Examples

Using Whoogle Search is intuitive, similar to any standard search engine.

Basic Search: Simply type your query into the search bar.
Time Range Filtering: Append :past <time> to your search query, where <time> can be hour, day, month, or year. For example: coronavirus updates :past hour.
JSON Results (API): Whoogle can return filtered results as JSON. Send Accept: application/json in your request header or append format=json to the search URL.
```
/search?q=whoogle&format=json
```
This provides a structured output for programmatic use.

Why Use It

Whoogle Search stands out as an excellent choice for users seeking a more private and controlled search experience:

Privacy-Focused: It eliminates ads, tracking, cookies, and IP address logging, ensuring your searches remain private.
Ad-Free Experience: Enjoy search results without sponsored content or intrusive advertisements.
Customization: Extensive environment variables allow for fine-grained control over your instance, including proxy support, custom user agents, and site alternatives.
Self-Hosted Control: By self-hosting, you retain full control over your search data and infrastructure.
Simplicity: Unlike some other privacy-focused search engines like Searx, Whoogle focuses solely on Google results and aims for the easiest possible deployment, making the transition from Google seamless.