README.md

March 20, 2025 ยท View on GitHub

๐Ÿ“Œ Description

This project implements a real-time overlay based on YOLOv8 to detect enemies in CS2. It uses ONNX Runtime for model inference and Pygame for overlay rendering. The integrated aim enables smooth target tracking in real-time (but not realy good). The model used in this project was entirely created and annotated by me, using the dataset available at this link : https://universe.roboflow.com/leksa-ub9gf/cs2-dataset-b4kpu/dataset/6

๐Ÿš€ Features

Real-time enemy player detection

Invisible window overlay (transparent) using Pygame

CUDA (GPU) acceleration for fast inference

Optional aimbot with smooth tracking

Simple user interface with buttons and hotkeys

โš™๏ธ Installation

1๏ธโƒฃ Requirements

Python 3.8+

CUDA & CuDNN (if using GPU acceleration)

ONNX Runtime with CUDA support

CS2 in borderless windowed mode

2๏ธโƒฃ Install Dependencies

Clone the project and install dependencies:

3๏ธโƒฃ Add the Model

Place the best.onnx file in the main project folder (or train a new model).

๐ŸŽฏ Usage

Run the main script

๐Ÿ”‘ Hotkeys

F1: Toggle detection on/off

F2: Show/hide labels

K: Enable/disable aim (hold to track target)

๐Ÿ› ๏ธ Future Development

Performance optimization improvements

Enhanced aim target selection

๐Ÿ“œ License

Open-source project under the MIT license.