Skip to content

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

Languages