About Donkey®

Release All Contributors License Discord


Donkey is a Self Driving Car Platform for hobby remote control cars. Donkey Car is made up of several components: * It is a high level self driving library written in Python. It was developed with a focus on enabling fast experimentation and easy contribution. * It is an Open Source Hardware design that makes it easy for you to build your own car * It is a simulator that enables you to use Donkey without hardware * It is a community of enthusiasts, developers and data scientists that enjoy racing, coding and discussing the future of ML, Cars and who will win the next race.

Enjoy


Build your own Donkey

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

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

Hello World.

Donkeycar is designed to make adding new parts to your car easy. Here's an 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='~/mycar/data',
                   inputs=['image'],
                   types=['image_array'])
V.add(tub, inputs=inputs)

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

Installation

How to install


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 navigate from one side of a city to the other, we'll hold off naming it after some celestial being.