Metadata-Version: 2.1
Name: donkeycar
Version: 5.1.0
Summary: Self driving library for python.
Home-page: https://github.com/autorope/donkeycar
Author: Will Roscoe, Adam Conway, Tawn Kramer
License: MIT
Keywords: selfdriving cars donkeycar diyrobocars
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3.11
Requires-Python: <3.12,>=3.11.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pillow
Requires-Dist: docopt
Requires-Dist: tornado
Requires-Dist: requests
Requires-Dist: PrettyTable
Requires-Dist: paho-mqtt
Requires-Dist: simple-pid
Requires-Dist: progress
Requires-Dist: pyfiglet
Requires-Dist: psutil
Requires-Dist: pynmea2
Requires-Dist: pyserial
Requires-Dist: utm
Requires-Dist: pandas
Requires-Dist: pyyaml
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: responses ; extra == 'dev'
Requires-Dist: mypy ; extra == 'dev'
Provides-Extra: macos
Requires-Dist: tensorflow-macos ==2.15.* ; extra == 'macos'
Requires-Dist: matplotlib ; extra == 'macos'
Requires-Dist: kivy ; extra == 'macos'
Requires-Dist: pandas ; extra == 'macos'
Requires-Dist: plotly ; extra == 'macos'
Requires-Dist: albumentations ; extra == 'macos'
Provides-Extra: nano
Requires-Dist: Adafruit-PCA9685 ; extra == 'nano'
Requires-Dist: adafruit-circuitpython-ssd1306 ; extra == 'nano'
Requires-Dist: adafruit-circuitpython-rplidar ; extra == 'nano'
Requires-Dist: Jetson.GPIO ; extra == 'nano'
Requires-Dist: numpy ==1.23.* ; extra == 'nano'
Requires-Dist: matplotlib ==3.7.* ; extra == 'nano'
Requires-Dist: kivy ; extra == 'nano'
Requires-Dist: plotly ; extra == 'nano'
Requires-Dist: pandas ==2.0.* ; extra == 'nano'
Provides-Extra: pc
Requires-Dist: tensorflow ==2.15.* ; extra == 'pc'
Requires-Dist: matplotlib ; extra == 'pc'
Requires-Dist: kivy ; extra == 'pc'
Requires-Dist: pandas ; extra == 'pc'
Requires-Dist: plotly ; extra == 'pc'
Requires-Dist: albumentations ; extra == 'pc'
Provides-Extra: pi
Requires-Dist: picamera2 ; extra == 'pi'
Requires-Dist: Adafruit-PCA9685 ; extra == 'pi'
Requires-Dist: adafruit-circuitpython-ssd1306 ; extra == 'pi'
Requires-Dist: adafruit-circuitpython-rplidar ; extra == 'pi'
Requires-Dist: RPi.GPIO ; extra == 'pi'
Requires-Dist: tensorflow-aarch64 ==2.15.* ; extra == 'pi'
Requires-Dist: opencv-contrib-python ; extra == 'pi'
Provides-Extra: torch
Requires-Dist: torch ==2.1.* ; extra == 'torch'
Requires-Dist: pytorch-lightning ; extra == 'torch'
Requires-Dist: torchvision ; extra == 'torch'
Requires-Dist: torchaudio ; extra == 'torch'
Requires-Dist: fastai ; extra == 'torch'

# Donkeycar: a python self driving library


![Build Status](https://github.com/autorope/donkeycar/actions/workflows/python-package-conda.yml/badge.svg?branch=main)
![Lint Status](https://github.com/autorope/donkeycar/actions/workflows/superlinter.yml/badge.svg?branch=main)
![Release](https://img.shields.io/github/v/release/autorope/donkeycar)


[![All Contributors](https://img.shields.io/github/contributors/autorope/donkeycar)](#contributors-)
![Issues](https://img.shields.io/github/issues/autorope/donkeycar)
![Pull Requests](https://img.shields.io/github/issues-pr/autorope/donkeycar?)
![Forks](https://img.shields.io/github/forks/autorope/donkeycar)
![Stars](https://img.shields.io/github/stars/autorope/donkeycar)
![License](https://img.shields.io/github/license/autorope/donkeycar)

![Discord](https://img.shields.io/discord/662098530411741184.svg?logo=discord&colorB=7289DA)

Donkeycar is minimalist and modular self driving library for Python. It is
developed for hobbyists and students with a focus on allowing fast experimentation and easy
community contributions.

#### Quick Links
* [Donkeycar Updates & Examples](http://donkeycar.com)
* [Build instructions and Software documentation](http://docs.donkeycar.com)
* [Discord / Chat](https://discord.gg/PN6kFeA)

![donkeycar](https://github.com/autorope/donkeydocs/blob/master/docs/assets/build_hardware/donkey2.png)

#### Use Donkey if you want to:
* Make an RC car drive its self.
* Compete in self driving races like [DIY Robocars](http://diyrobocars.com)
* Experiment with autopilots, mapping computer vision and neural networks.
* Log sensor data. (images, user inputs, sensor readings)
* Drive your car via a web or game controller or RC controller.
* Leverage community contributed driving data.
* Use existing CAD models for design upgrades.

### Get driving.
After building a Donkey2 you can turn on your car and go to http://localhost:8887 to drive.

### Modify your cars behavior.
The donkey car is controlled by running a sequence of events

```python
#Define a vehicle to take and record pictures 10 times per second.

import time
from donkeycar import Vehicle
from donkeycar.parts.cv import CvCam
from donkeycar.parts.tub_v2 import TubWriter
V = Vehicle()

IMAGE_W = 160
IMAGE_H = 120
IMAGE_DEPTH = 3

#Add a camera part
cam = CvCam(image_w=IMAGE_W, image_h=IMAGE_H, image_d=IMAGE_DEPTH)
V.add(cam, outputs=['image'], threaded=True)

#warmup camera
while cam.run() is None:
    time.sleep(1)

#add tub part to record images
tub = TubWriter(path='./dat', inputs=['image'], types=['image_array'])
V.add(tub, inputs=['image'], outputs=['num_records'])

#start the drive loop at 10 Hz
V.start(rate_hz=10)
```

See [home page](http://donkeycar.com), [docs](http://docs.donkeycar.com)
or join the [Discord server](http://www.donkeycar.com/community.html) to learn more.
