BypassBuddy

BypassBuddy is a powerful, modular link resolution tool designed to bypass ad-shorteners and reveal the final destination URL instantly. It features a premium, aesthetic user interface and a robust backend powered by FastAPI.

Features

• Instant Resolution: Bypasses common ad-shorteners and link lockers.
• Premium UI: A clean, "Claude-like" aesthetic with dark mode support, smooth animations, and mobile responsiveness.
• Modular Architecture: Easily extensible system where each bypass module is independent.
• Dynamic Support: The UI automatically updates to show the count of supported domains.
• Developer Friendly: Built with FastAPI, including automatic Swagger documentation at /docs.

Tech Stack

• Backend: Python (FastAPI, Uvicorn)
• Frontend: HTML5, Vanilla JS, TailwindCSS
• Networking: curl_cffi for advanced browser impersonation (TLS fingerprinting).
• Parsing: BeautifulSoup4 and lxml.

Setup

1. Clone the repository:

   git clone https://github.com/<your-username>/BypassBuddy.git
   cd BypassBuddy

2. Create a virtual environment:

   python -m venv .venv
   # Windows
   .venv\Scripts\activate
   # Linux/Mac
   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the server:

   python -m uvicorn app.main:app --reload

5. Open the App: Visit http://localhost:8000 in your browser.

Usage

Simply paste a supported short link into the input field and click "Resolve". The application will process the link and display the final destination.

Disclaimer

This tool is for educational purposes only. Use it responsibly and only on links you are authorized to access.