Getting Started

What is this?

This is an Open Source Software (OSS) project: PythonRobotics, which is a Python code collection of robotics algorithms.

The focus of the project is on autonomous navigation, and the goal is for beginners in robotics to understand the basic ideas behind each algorithm.

In this project, the algorithms which are practical and widely used in both academia and industry are selected.

Each sample code is written in Python3 and only depends on some standard modules for readability and ease of use.

It includes intuitive animations to understand the behavior of the simulation.

See this paper for more details:


For development:

  • pytest (for unit tests)

  • pytest-xdist (for parallel unit tests)

  • mypy (for type check)

  • sphinx (for document generation)

  • pycodestyle (for code style check)

How to use

  1. Clone this repo and go into dir.

>$ git clone

>$ cd PythonRobotics
  1. Install the required libraries.

using conda :

>$ conda env create -f requirements/environment.yml

using pip :

>$ pip install -r requirements/requirements.txt
  1. Execute python script in each directory.

  2. Add star to this repo if you like it 😃.