Skip to content

๐Ÿง  Interactive maze game powered by a neural network AI. Watch it learn and evolve as it navigates procedurally generated labyrinths in real time. Built with Pygame and TensorFlow.

Notifications You must be signed in to change notification settings

Zebaro24/Neural-Network-Labyrinth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

41 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Neural-Network-Labyrinth ๐Ÿง ๐Ÿ”„๐ŸŽฎ

Project Status License Python TensorFlow

Interactive maze game with neural network AI that learns to navigate labyrinths. Experience machine learning in action through gameplay!


โœจ Core Features

  • Intelligent Navigation:
    • ๐Ÿค– Neural network-controlled character
    • ๐Ÿง  Real-time decision visualization
    • ๐Ÿ”„ On-demand training mode
  • Dynamic Environments:
    • ๐ŸŒ€ Procedurally generated mazes
    • ๐ŸŽš๏ธ Adjustable complexity levels
  • Game Modes:
    • ๐Ÿ‘จโ€๐Ÿ’ป Manual player control
    • ๐Ÿค– AI autonomous navigation
    • ๐Ÿ Progress tracking with scoring
  • Immersive Experience: ๐Ÿ”Š Sound effects ๐ŸŽจ Vector-based graphics ๐Ÿ“Š Performance metrics

๐Ÿงฐ Tech Stack

  • Machine Learning: TensorFlow Keras
  • Game Engine: Pygame
  • Data Processing: NumPy

โš™๏ธ Installation & Setup

  1. Clone repository

    git clone https://github.com/Zebaro24-Stud/Neural-Network-Labyrinth.git
    cd Neural-Network-Labyrinth
  2. Create virtual environment

    python -m venv venv
    # Windows
    venv\Scripts\activate
    # Linux/Mac
    source venv/bin/activate
  3. Install dependencies

    pip install -r requirements.txt

๐Ÿš€ Launching the Game

python main.py

Controls

  • Arrow Keys: Move character (Up, Down, Left, Right)

๐Ÿง  Neural Network Architecture

graph LR
    A[Input Layer<br>4 directions] --> B[Hidden Layer<br>64 neurons]
    B --> C[Output Layer<br>4 actions]
    style A fill:#4CAF50,stroke:#388E3C
    style B fill:#2196F3,stroke:#1976D2
    style C fill:#FF9800,stroke:#F57C00
Loading
  • Optimizer: Adam
  • Loss Function: Categorical Crossentropy
  • Activation: ReLU (Hidden), Softmax (Output)

๐Ÿ—‚๏ธ Project Structure

main.py           # Game entry point
GUI2D.py          # Graphical interface
LabyrinthLogic.py # Maze generation & logic
NeuralNetwork.py  # AI implementation
VectorGraphics.py # UI components
config.py         # Game settings
sound/            # Audio assets
requirements.txt  # Dependencies

๐ŸŽฎ Gameplay Preview

Manual Mode AI Mode
Manual Control AI Navigation

๐Ÿ“ฌ Contacts

๐Ÿ‘จโ€๐Ÿ’ป Developer ๐Ÿ“ง Email ๐Ÿ’ป GitHub
Denys Shcherbatyi zebaro.work@gmail.com @Zebaro24
Dmitro Itsko cloud.me.fr@gmail.com @WhiteDh
Oleksandr Yakovenko wu662542@gmail.com @Glek-Stud

About

๐Ÿง  Interactive maze game powered by a neural network AI. Watch it learn and evolve as it navigates procedurally generated labyrinths in real time. Built with Pygame and TensorFlow.

Topics

Resources

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages