Quantimero

Quantum-Powered Random Number Generation Showcase

Quantimero is a hackathon project that demonstrates various use cases for quantum-seeded entropy as a source of true randomness. This interactive web application showcases how quantum entropy can be applied to different scenarios requiring unpredictable random generation.

🎯 Project Overview

This project was developed for a hackathon to explore and demonstrate the practical applications of quantum-based random number generation. Instead of relying on pseudo-random algorithms, Quantimero uses quantum entropy as a seed to generate truly random outcomes across multiple use cases.

✨ Features

Random Generation Use Cases

1. 🎲 Dice Rolling - Generate random dice rolls (1-6) for games and decision making
2. 🪙 Coin Flipping - Fair coin tosses for binary decisions (Heads/Tails)
3. 🔐 Password Generation - Create secure random passwords using quantum entropy
4. 🎯 Winner Selection - Randomly select winners from a list of participants
5. 🃏 Playing Cards - Generate random playing cards for card games
6. #️⃣ Hash Generation - Create cryptographic hashes using quantum-seeded randomness

Interactive Features

• Matrix Animation - Visual feedback during random generation with a Matrix-style animation
• Participant Management - Add/remove participants for winner selection
• Real-time Generation - All random values generated simultaneously with quantum entropy
• Modern UI - Clean, responsive interface showcasing all use cases

🛠️ Technology Stack

• Frontend: React 19
• Styling: CSS3 with modern animations
• Random Generation: Quantum-seeded entropy with SHA256 hashing
• UI Components:
  • React Matrix Animation for visual effects
  • React Dice Roll for dice animations
  • Custom card components for playing cards
• Build Tool: Create React App
• Package Manager: pnpm

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• pnpm package manager

Installation

1. Clone the repository:

git clone <repository-url>
cd hack-calimero

2. Install dependencies:

pnpm install

3. Start the development server:

pnpm start

4. Open http://localhost:3000 to view the application

Available Scripts

• pnpm start - Runs the app in development mode
• pnpm build - Builds the app for production
• pnpm test - Launches the test runner
• pnpm eject - Ejects from Create React App (one-way operation)

🎮 How It Works

1. Quantum Entropy Source: The application uses quantum-based randomness as the initial entropy source
2. SHA256 Hashing: The quantum seed is processed through SHA256 to generate a deterministic hash
3. Multiple Extractions: Different portions of the hash are used to generate various random outcomes:
   • First character (hex) modulo operations for dice and coin
   • Hash slices for passwords and participant selection
   • Full hash display for cryptographic purposes

🎨 Use Case Demonstrations

Dice Rolling

Perfect for board games, RPGs, or any scenario requiring fair dice rolls.

Coin Flipping

Binary decision making with guaranteed fairness using quantum randomness.

Password Generation

Secure password creation using quantum entropy for maximum unpredictability.

Winner Selection

Fair participant selection for contests, giveaways, or random assignments.

Playing Cards

Random card generation for digital card games and simulations.

Hash Generation

Cryptographic hash demonstration showing quantum-seeded randomness.

🏗️ Project Structure

src/
├── components/          # React components for each use case
│   ├── Card/           # Base card component
│   ├── CardGrid/       # Grid layout for all cards
│   ├── CoinCard/       # Coin flip display
│   ├── DiceCard/       # Dice roll display
│   ├── HashCard/       # Hash generation display
│   ├── PasswordCard/   # Password generation display
│   ├── PlayingCard/    # Playing card display
│   └── WinnerCard/     # Winner selection display
├── hooks/              # Custom React hooks
│   ├── useParticipants.js    # Participant management
│   ├── usePlayingCard.js     # Playing card logic
│   └── useRandomGeneration.js # Main random generation logic
└── images/             # Project assets

🎯 Hackathon Context

This project was created to demonstrate the practical applications of quantum computing in everyday scenarios. By using quantum entropy as a randomness source, we showcase how quantum technology can enhance security, fairness, and unpredictability in various applications.

🔮 Future Enhancements

• Integration with actual quantum random number generators
• Additional use cases (lottery numbers, team assignments, etc.)
• Historical tracking of generated values
• API endpoints for external applications
• Mobile-responsive improvements

📄 License

This project was created for hackathon purposes. Please refer to the license file for usage terms.

---

Quantimero - Where Quantum Meets Random 🎲✨