KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #claude-code #codex #cli #agent-skills #ai #dsh-plugin #mcp #windows #agent

deep_q_learning

★ 32 Open GitHub ↗

A collection of experiments in reinforcement learning. For now, consists only of Deep Q Learning, but willl eventually contain others.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Deep Q Reinforcement Learning

## Description
Reinforcement learning can be used as a technique to train an agent to play a game in a given enviroment. Q-learning is a simple type of reinforcement learning, whereby a "Q-table" is created and contains the AI's estimates of the "quality" (hence the name) of each action available to the agent in each game state. As the agent plays the game and collects more information, it updates the Q-table with new estimages. Q-learning is simple and effective, but not scalable - in all but the most simple games, the state space (i.e. the number of all possible combinations of environment states) becomes too large for a simple look-up table to be effective.

The Q table is really just a method of estimating the Q-function. That is, a function that takes the game state and an action as its inputs, and returns an estimate of the quality of that action as an output. Another method of doing this is to use convolutional neural networks to estimate all possible action values for a given game state. This combination of Q learning with deep learning is call a Deep Q Network (DQN). The advantage of DQNs is (a) we do not need to store an impossibly large Q-table to play a moderately complex game, and (b) neural networks are good at finding patterns, so it doesn't need to have previously encountered an exact version of a game frame in order to be able to generalize the model to make a decent guess at the answer.

This repository contains my implementation of a Deep Q Network to play the game Snake. It is worth noting a few things:
- The agent is only supplied with the game screen of each frame as a 3-dimensional (RGB) pixel array, a positive or negative reward for each game screen, and a set of possible actions to take. 
- It does NOT know what the pixels represent. I.e. it doesn't start out knowing what a "snake" is, or that the food is good and crashing is bad. 
- It does NOT know what each action represents. It doesn't know what "up", "down", "left" or "right" do in the context of the game. 
All it knows is that the pixel array changes with each game screen, that the actions may or may not affect how the pixels change, and that sometimes the game score changes - but it doesn't know what actions or (sequences of actions) cause this. From this input, the agent plays millions of game screens and eventually learns to win the game.

Below is an animation of the AI in this repo after 2 million game frames of training (approximately 20 hours on my GPU-enabled laptop).

![](https://raw.githubusercontent.com/MProx/deep_q_learning/master/snake_trained.gif)

## Dependencies
- Gym
- [Gym_snake](https://github.com/grantsrb/Gym-Snake)
- Matplotlib
- Tensorflow (tested with tensorflow-gpu==2.0.0b1)
- Numpy

## Usage:
Clone this repository. From the command like, execute the following to see all flags and options:

> $ python DQN_snake.py --help

To train the model with default parameters (default of 1,000,000 frames), use the '-m'

> $ python DQN_snake.py -m train

To train the model on a different number of frames, use the '-n' flag:

> $ python DQN_snake.py -m train -n 2000000

To test the model on untrained weights and biases, use the '-m' flag (expect poor performance):

> $ python DQN_snake.py -m test

To supply a trained model file for evaluation, use the '-f' flag:

> $ python DQN_snake.py -m test -f snake.h5

To edit hyperparameters, change the class variables in thier definition near the top of the DQN_snake.py file.

Once the model is running, open a terminal or command prompt and start tensorboard with the following command:

> $ tensorboard --logdir ./logs/

Then open a browser window and navigate to localhost:6006/ to see stats and training progress.

## TO DO:

- Possibly move all hyperparameters to a separate file, save in JSON format

- Improve the model to use Double-DQN, Dueling DQN, etc.

deep_q_learning

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README