About Donkey

Donkey is a high level self driving library written in Python. It was developed with a focus on enabling fast experimentation and easy contribution.


Build your own Donkey2

Donkey2 is the standard car that most people build first. The parts cost $200 and take 2 hours to assemble. Here are the main steps to build your own car:

  1. Assemble hardware.
  2. Install software.
  3. Calibrate your car.
  4. Start driving.
  5. Train an autopilot.
  6. Experiment with simulator.

Hello World.

Donkeycar is designed to make adding new parts to your car easy. Here's and example car application that captures images from the camera and saves them.

import donkey as dk

#initialize the vehicle
V = dk.Vehicle()

#add a camera part
cam = dk.parts.PiCamera()
V.add(cam, outputs=['image'], threaded=True)

#add tub part to record images
tub = dk.parts.Tub(path='~/d2/gettings_started', 
                   inputs=['image'], 
                   types=['image_array'])
V.add(tub, inputs=inputs)

#start the vehicle's drive loop
V.start(max_loop_count=100)

Installation

For linux/OS users clone the master branch to get the lastest version.

git clone https://github.com/wroscoe/donkey donkeycar
pip install -e donkeycar

How to install on Windows


Why the name Donkey?

The ultimate goal of this project is to build something useful. Donkey's were one of the first domesticated pack animals, they're notoriously stubborn, and they are kid safe. Until the car can nagigate from one side of a city to the other, we'll hold off naming it after some celestial being.