Skip to content

installation

Jump to bottom
alzzdev edited this page Jun 10, 2026 · 1 revision

Installation

This guide covers the steps needed to install and run Atdork on your system.

Prerequisites

  • Python 3.9 or later
  • pip (Python package installer)

Verify your Python version:

python --version

If you don't have Python, download it from python.org or use your system package manager.

Basic Installation

  1. Clone the repository

    git clone https://github.com/amnottdevv/atdork.git
cd atdork

  2. Install required packages

    pip install -r requirements.txt

    This installs:

    • duckduckgo-search (metasearch library)
    • rich (terminal formatting)
    • pyfiglet (banner generation)

  3. Verify installation

    python main.py --version

    You should see the version number (e.g., 1.2). If the command runs without errors, Atdork is ready to use.

Optional Dependencies

Tor (for anonymous routing)

If you intend to use the --tor flag, install Tor on your system.

  • Linux (Debian/Ubuntu) 
    sudo apt install tor
sudo systemctl start tor
  • macOS (Homebrew) 
    brew install tor
brew services start tor
  • Windows
    Download the Tor Expert Bundle from torproject.org and run it.
    By default, Tor listens on 127.0.0.1:9050. Atdork connects to this address when --tor is used.

Proxy files

No additional software is required to use proxy lists. Simply prepare a text file with one proxy URL per line (e.g., http://user:pass@proxy:8080 or socks5://127.0.0.1:1080).

Troubleshooting Installation

pip: command not found

Install pip via your package manager or follow the pip installation guide.

Permission errors

Use a virtual environment to avoid system‑wide package conflicts:

python -m venv venv
source venv/bin/activate   # Linux/macOS
venv\Scripts\activate      # Windows
pip install -r requirements.txt

ModuleNotFoundError: No module named 'ddgs'

Make sure you installed the correct library:

pip install duckduckgo-search

Note: The package name is duckduckgo-search, but the import is ddgs.

Git not installed

Download the repository as a ZIP file from GitHub and extract it manually.

Upgrading

To get the latest version of Atdork, pull the latest changes and update dependencies:

git pull origin main
pip install -r requirements.txt --upgrade

Next: Quick Start

Clone this wiki locally