whatisgithub

What is vizdoom_clone_project_vibecoded?

anirban94das/vizdoom_clone_project_vibecoded — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A reinforcement learning project that trains a neural network to play DOOM directly from screen pixels using ViZDoom and PPO.

Mindmap

mindmap
  root((repo))
    What it does
      PPO training
      DOOM scenarios
      Reward shaping
    Tech stack
      Python
      PyTorch
      ViZDoom
    Use cases
      RL research
      Policy visualization
    Audience
      ML hobbyists
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Train an AI agent to play DOOM scenarios from raw screen pixels

USE CASE 2

Study reward shaping techniques for reinforcement learning game agents

USE CASE 3

Visualize what a trained CNN policy is looking at using deconvnet, occlusion, and saliency methods

What is it built with?

PythonPyTorchstable-baselines3ViZDoom

How does it compare?

anirban94das/vizdoom_clone_project_vibecoded0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires ViZDoom, PyTorch, and stable-baselines3, full DOOM levels need bundled or owned WAD files.

So what is it?

This project trains a neural network to play the classic game DOOM using reinforcement learning on top of ViZDoom, a research platform that lets AI agents control DOOM through code. The AI does not use a language model to decide what to do in the moment. Instead it uses a convolutional neural network policy trained with a reinforcement learning algorithm called PPO, learning directly from the pixels of the game screen, since DOOM requires a decision roughly every 30 milliseconds, far faster than a text based AI model could respond. The project covers all 12 of ViZDoom's built in training scenarios, such as a simple room with one monster, a corridor with enemies, and health gathering tasks, as well as full original DOOM and DOOM II levels using any map. Some scenarios, like the basic room and a monster filled corridor, are already trained and perform well, while others are implemented but still need training runs. Free versions of the DOOM game files are bundled in, and the project can automatically use your own copy of the original game files if you own them and place them in the right folder. Because many of the built in scoring rules only weakly reward good play, the project adds optional bonus rewards on top, such as extra reward for exploring new areas, picking up weapons, dealing damage, or gaining health, with different combinations turned on for different scenarios. The project also includes tools for looking inside the trained network to understand what it has learned to pay attention to, using several established visualization techniques borrowed from academic computer vision research. These generate images showing which parts of the screen most influenced the AI's decisions, such as highlighting the monster in a fight scenario, and can be run against a trained model with a live game frame.

Copy-paste prompts

Prompt 1
Help me train the basic ViZDoom scenario using this project's PPO setup and stable-baselines3.
Prompt 2
Explain how this project's reward shaping bonuses work and which ones apply to deadly_corridor.
Prompt 3
Using visualize_cnn_diagnostics.py, walk me through running occlusion sensitivity on my trained model.

Frequently asked questions

What is vizdoom_clone_project_vibecoded?

A reinforcement learning project that trains a neural network to play DOOM directly from screen pixels using ViZDoom and PPO.

What language is vizdoom_clone_project_vibecoded written in?

Mainly Python. The stack also includes Python, PyTorch, stable-baselines3.

How hard is vizdoom_clone_project_vibecoded to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is vizdoom_clone_project_vibecoded for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.