Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cloudwaddie/aitweaker/llms.txt

Use this file to discover all available pages before exploring further.

AI Leaks Tweaker is a Python desktop application, so you need Python and a few packages before you can run it. The setup scripts in the repository handle dependency installation automatically — you only need to satisfy the prerequisites for your operating system first, then run a single command.

​
Prerequisites

Before running the setup script, make sure you have the following installed:
  • Python 3.8 or later — the application requires Python 3.8+. Verify with python --version (Windows) or python3 --version (macOS/Linux).
  • pip — the Python package installer, bundled with most Python distributions.
  • mitmproxy — install it via pipx so it is available system-wide:
pipx install mitmproxy
Using pipx keeps mitmproxy isolated from your project’s virtual environment and makes the mitmdump command available on your PATH.

​
Install dependencies

The scripts/ directory contains setup scripts that install all Python dependencies listed in requirements.txt (customtkinter, mitmproxy, pystray, Pillow, cx_Freeze, beautifulsoup4, lxml) using pip.
1

Clone or download the repository

Download the AI Leaks Tweaker source code and navigate to the project root directory.
2

Run the setup script for your OS

Open a terminal in the project root and run the setup script for your operating system:
@echo off

REM Check for Python
python --version 2>nul
if %errorlevel% neq 0 (
    echo Python is not installed. Please install Python 3.8+ and add it to your PATH.
    goto :eof
)

REM Install dependencies
echo Installing dependencies...
pip install -r requirements.txt

echo Setup complete.
pause
The script checks that Python is available on your PATH, then installs all required packages from requirements.txt.
On macOS and Linux, make the shell script executable before running it: chmod +x scripts/setup.sh
3

Confirm the setup completed

The script prints Setup complete. when all packages install successfully. If Python is missing, it prints an error and exits — install Python 3.8+ and re-run the script.

​
Run the application

Once setup is complete, launch the AI Leaks Tweaker GUI from the project root: 
@echo off

python app.py
Double-click run.bat in Explorer, or run it from the Command Prompt:
run.bat
The AI Leaks Tweaker window opens. Your next step is to configure the mitmproxy backend so the tool can intercept HTTPS traffic — see the proxy setup guide for full instructions.

Build docs developers (and LLMs) love

Get started for freeTalk to us