{"id":16360058,"url":"https://github.com/frgfm/drlnd-p1-navigation","last_synced_at":"2026-05-05T23:31:28.486Z","repository":{"id":110055999,"uuid":"219807080","full_name":"frgfm/drlnd-p1-navigation","owner":"frgfm","description":"Navigation project of Udacity Deep Reinforcement Learning","archived":false,"fork":false,"pushed_at":"2019-11-07T00:46:47.000Z","size":324,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-05T02:35:23.579Z","etag":null,"topics":["deep-reinforcement-learning","dqn","experience-replay","pytorch","unity"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frgfm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-05T17:47:14.000Z","updated_at":"2019-11-12T23:41:44.000Z","dependencies_parsed_at":"2023-04-22T18:04:52.006Z","dependency_job_id":null,"html_url":"https://github.com/frgfm/drlnd-p1-navigation","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/frgfm/drlnd-p1-navigation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frgfm%2Fdrlnd-p1-navigation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frgfm%2Fdrlnd-p1-navigation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frgfm%2Fdrlnd-p1-navigation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frgfm%2Fdrlnd-p1-navigation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frgfm","download_url":"https://codeload.github.com/frgfm/drlnd-p1-navigation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frgfm%2Fdrlnd-p1-navigation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32672518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deep-reinforcement-learning","dqn","experience-replay","pytorch","unity"],"created_at":"2024-10-11T02:10:24.705Z","updated_at":"2026-05-05T23:31:28.469Z","avatar_url":"https://github.com/frgfm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Banana craving monkey\n[![License](https://img.shields.io/badge/License-MIT-brightgreen.svg)](LICENSE) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/77f12eeafe1c4e2bae444876625dc3f2)](https://www.codacy.com/manual/fg/banana-craving-monkey?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=frgfm/banana-craving-monkey\u0026amp;utm_campaign=Badge_Grade) [![CircleCI](https://circleci.com/gh/frgfm/banana-craving-monkey.svg?style=shield)](https://circleci.com/gh/frgfm/banana-craving-monkey)\n\nThis repository is an implementation of DQN agent for the navigation project of Udacity Deep Reinforcement Learning nanodegree, in the banana collection game provided by unity.\n\n![banana-gif](\u003chttps://video.udacity-data.com/topher/2018/June/5b1ab4b0_banana/banana.gif\u003e)\n\n\n\n## Table of Contents\n\n- [Environment](#environment)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Usage](#usage)\n- [Credits](#credits)\n- [License](#license)\n\n\n\n## Environment\n\nA reward of +1 is provided for collecting a yellow banana, and a reward of -1 is provided for collecting a blue banana. Thus, the goal of your agent is to collect as many yellow bananas as possible while avoiding blue bananas.\n\nThe state space has 37 dimensions and contains the agent's velocity, along with ray-based perception of objects around the agent's forward direction. Given this information, the agent has to learn how to best select actions. Four discrete actions are available, corresponding to:\n\n- **0** - move forward.\n- **1** - move backward.\n- **2** - turn left.\n- **3** - turn right.\n\nThe task is episodic, and in order to solve the environment, your agent must get an average score of +13 over 100 consecutive episodes.\n\n\n\n## Getting started\n\n### Prerequisites\n\n- Python 3.6 (or more recent)\n- [pip](https://pip.pypa.io/en/stable/)\n- [ml-agents](https://github.com/Unity-Technologies/ml-agents) v0.4 (check this [release](https://github.com/Unity-Technologies/ml-agents/releases/tag/0.4.0b) if you encounter issues)\n\n### Installation\n\nYou can install the project requirements as follows:\n\n```shell\ngit clone https://github.com/frgfm/banana-craving-monkey.git\ncd banana-craving-monkey\npip install -r requirements.txt\n```\n\nDownload the environment build corresponding to your OS\n\n- Linux: [here](https://s3-us-west-1.amazonaws.com/udacity-drlnd/P1/Banana/Banana_Linux.zip)\n- Mac OSX: [here](https://s3-us-west-1.amazonaws.com/udacity-drlnd/P1/Banana/Banana.app.zip)\n- Windows (32-bit): [here](https://s3-us-west-1.amazonaws.com/udacity-drlnd/P1/Banana/Banana_Windows_x86.zip)\n- Windows (64-bit): [here](https://s3-us-west-1.amazonaws.com/udacity-drlnd/P1/Banana/Banana_Windows_x86_64.zip)\n\nThen extract the archive in the project folder.\n\n\n\nIf you wish to use the agent trained by repo owner, you can download the model parameters as follows:\n\n```shell\nwget https://github.com/frgfm/banana-craving-monkey/releases/download/v0.1.0/dqn_fixed_target.pt\n```\n\n\n\n## Usage\n\n### Training\n\nAll training arguments can be found using the `--help` flag:\n\n```shell\npython train.py --help\n```\n\nBelow you can find an example to train your agent:\n\n```shell\npython train.py --deterministic --lr 5e-4 --no-graphics --eps-decay 0.98 --eps-end 0.02\n```\n\n### Evaluation\n\nYou can use an existing model's checkpoint to evaluate your agent as follows:\n\n```shell\npython evaluate.py --checkpoint ./dqn_fixed_target.pt\n```\n\n\n\n## Credits\n\nThis implementation is vastly based on the following papers:\n\n- [DQN paper](https://storage.googleapis.com/deepmind-media/dqn/DQNNaturePaper.pdf)\n- [Double DQN](https://arxiv.org/abs/1509.06461)\n- [Dueling DQN](https://arxiv.org/abs/1511.06581)\n- [Prioritized Experience replay](https://arxiv.org/abs/1511.05952)\n\n\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrgfm%2Fdrlnd-p1-navigation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrgfm%2Fdrlnd-p1-navigation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrgfm%2Fdrlnd-p1-navigation/lists"}