FDJ-SLAYER/README.md

FDJ SLAYER

A Python application that generates random EuroMillions lottery draws using multiple entropy sources to maximize randomness.

Description

This project aims to create truly random EuroMillions lottery draws by combining various entropy sources including hardware information, weather data, system metrics, and cryptographic functions. It generates a configurable number of draws and allows users to view them.

Features

• Multiple entropy sources for good randomness:
  • Weather data from OpenMeteo API
  • Hardware and system information
  • OS random data and cryptographic functions
  • CPU/memory usage and other dynamic metrics
• Configurable number of lottery draws
• Progress bar visualization during draw generation (yes, it's a huge feature :p)

Installation

1. Clone the repository:

git clone https://github.com/Floriansylvain/FDJ-SLAYER.git
cd FDJ-SLAYER

2. Install dependencies:

pip install -r requirements.txt

Usage

Run the main script to generate lottery draws:

python src/main.py

The program will:

1. Generate the configured number of random draws
2. Display a randomly selected draw as the final result
3. Allow you to view additional draws on request

How It Works

The application uses a combination of entropy sources to generate truly random lottery draws:

1. Static Entropy Sources:

   • OS random data
   • Hardware identifiers
   • System configuration
   • Weather data from geographically random locations

2. Dynamic Entropy Sources:

   • Current timestamp
   • CPU and memory usage
   • Process and thread information
   • Network statistics

All sources are combined, hashed, and processed to create seeds for the random number generator that selects the lottery numbers.

Configuration

Edit the constants in scr/constants.py to modify:

Parameter	Description
NUMBER_OF_DRAWS	Number of draws to generate
NUMBER_OF_NUMBERS	Number of main numbers in a draw (5 for EuroMillions)
MAX_NUMBER	Maximum main number value (50 for EuroMillions)
NUMBER_OF_STARS	Number of star numbers in a draw (2 for EuroMillions)
MAX_STAR	Maximum star number value (12 for EuroMillions)
Weather API parameters	Configuration for the OpenMeteo API

Dependencies

Package	Purpose
openmeteo_requests	Weather data retrieval
progress	Progress bar visualization
psutil	System metrics collection
requests-cache	Caching API requests
numpy	ValuesAsNumpy() on API results
Markdown Table Formatter

License

TODO: Add a license