feat: initial readme

2026-08-19 19:53:19 +02:00 · 2025-03-28 00:54:49 +01:00
parent e981b0f393
commit 378f5d38a7
1 changed files with 88 additions and 0 deletions
@@ -0,0 +1,88 @@
+# 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](https://open-meteo.com/)
+  - 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:
+```bash
+git clone https://github.com/Floriansylvain/FDJ-SLAYER.git
+cd FDJ-SLAYER
+```
+
+2. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+
+Run the main script to generate lottery draws:
+```bash
+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](https://pypi.org/project/openmeteo-requests/) | Weather data retrieval           |
+| [progress](https://pypi.org/project/progress/)                     | Progress bar visualization       |
+| [psutil](https://pypi.org/project/psutil/)                         | System metrics collection        |
+| [requests-cache](https://pypi.org/project/requests-cache/)         | Caching API requests             |
+| [numpy](https://pypi.org/project/numpy/)                           | `ValuesAsNumpy()` on API results |
+Markdown Table Formatter
+## License
+
+TODO: Add a license