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

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/benbusby-whoogle-search
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/benbusby/whoogle-search
OSRepos URL: https://osrepos.com/repo/benbusby-whoogle-search

## 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.

## Topics

- privacy
- metasearch-engine
- adblock
- docker
- python
- self-hosting
- search-engine

## Repository Information

Last analyzed by OSRepos: Wed Dec 10 2025 16:01:37 GMT+0000 (Western European Standard Time)
Detail views: 5
GitHub clicks: 6

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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](https://heroku.com/about "Heroku Quick Deploy" target="_blank" rel="noopener"), [Render](https://render.com "Render.com" target="_blank" rel="noopener"), [Repl.it](https://repl.it "Repl.it" target="_blank" rel="noopener"), [Fly.io](https://fly.io "Fly.io" target="_blank" rel="noopener"), and [Koyeb](https://www.koyeb.com "Koyeb" target="_blank" rel="noopener").
*   **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](https://aur.archlinux.org/packages/whoogle-git/ "AUR package" target="_blank" rel="noopener") and through [Chaotic-AUR](https://chaotic.cx "Chaotic-AUR" target="_blank" rel="noopener").
*   **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.

## Links
*   **GitHub Repository**: [https://github.com/benbusby/whoogle-search](https://github.com/benbusby/whoogle-search "Whoogle Search GitHub" target="_blank" rel="noopener")