README.md 1.18 KB
Newer Older
Will Roscoe's avatar
Will Roscoe committed
# Donkey: a self driving library and control platform for small scale DIY vehicles. 
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
Donkey is minimalist and modular self driving library written in Python. It is developed for hobbiests with a focus on allowing fast experimentation and easy community contributions.  
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
####Use Donkey if you want to:
Will Roscoe's avatar
Will Roscoe committed
* [Quickly build your own self driving RC car.](docs/01-build_a_car.md) (~$200 + 5hrs).
* Use existing autopilots to drive your car.
* Use community datasets to create, improve and test autopilots that other people can use.  


Will Roscoe's avatar
Will Roscoe committed
#### Library Features:
* Data logging of image, steering angle, & throttle outputs. 
* Wifi car controls (a virtual joystic).
* Community contributed driving data and autopilots.
* Hardware CAD designs for optional upgrades.


Will Roscoe's avatar
Will Roscoe committed
### Drive your car
Once you have built your car you can use it like this.

Will Roscoe's avatar
Will Roscoe committed
1. Start the default pilot server. `python demos/serve.py`

2. Start your car and connect it to the pilot server. `python demos/drive_pi.py  --remote http://<your_pilot_server_ip>:8887`

Will Roscoe's avatar
Will Roscoe committed
3. Go to `<your_pilot_server_ip>:8887` on your phone or computer to start driving your car. 

Will Roscoe's avatar
Will Roscoe committed
 Use the [scripts](scripts) for more tools to manipulate datasets and train autopilots.
Will Roscoe's avatar
Will Roscoe committed
 
Will Roscoe's avatar
Will Roscoe committed