Skip to content

dubiels/treehacks2025

Repository files navigation

HackTCHA 🧑‍💻

Test your CAPTCHAs against multiple industry-standard AI models to assess their resistance to automated solving.

Setup Instructions

Mac/Linux (Terminal)

python3 -m venv captcha_env
source captcha_env/bin/activate

2️⃣ Install Dependencies

pip install -r requirements.txt

Prerequisites

  • Node.js and npm
  • Git (optional)

Installation

  1. Clone the repository (or download and extract the ZIP):
git clone [your-repo-url]
cd [project-directory]
  1. Set up the React frontend:
# Install Node dependencies
npm init -y
npm install react react-dom lucide-react
npm install --save-dev vite @vitejs/plugin-react
  1. Create the project structure:
project_root/
├── package.json
├── vite.config.js
└── frontend/
    ├── index.html
    ├── components/
    │   └── CaptchaTester.jsx
    └── main.jsx
  1. Configure Vite: Create vite.config.js in the project root:
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";

export default defineConfig({
    plugins: [react()],
    root: "frontend",
    build: {
        outDir: "../dist",
    },
    resolve: {
        extensions: [".js", ".jsx"],
    },
});
  1. Update package.json: Make sure your package.json includes these scripts:
{
    "scripts": {
        "dev": "vite",
        "build": "vite build",
        "preview": "vite preview"
    }
}

Running the Application

In one terminal, start server.py:

python server.py

Leave that running, in another terminal, run:

npm run dev

This will run on http://localhost:5173

About

HackTCHA -- Stress-test and obfuscate CAPTCHAs against leading AI models

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •