Skip to main content

Developer Tools for Drones.

Project description

# DroneKit Python


[![PyPi published version](](
[![Windows Build status](](
[![OS X Build Status](](
[![Linux Build Status](]( <a href=""><img align="right" src=""></img></a>

DroneKit-Python helps you create powerful apps for UAVs.

## Overview

DroneKit-Python (formerly DroneAPI-Python) contains the python language implementation of DroneKit.

The API allows developers to create Python apps that communicate with vehicles over MAVLink. It provides programmatic access to a connected vehicle's telemetry, state and parameter information, and enables both mission management and direct control over vehicle movement and operations.

The API is primarily intended for use in onboard companion computers (to support advanced use cases including computer vision, path planning, 3D modelling etc). It can also be used for ground station apps, communicating with vehicles over a higher latency RF-link.

## Getting Started

The [Quick Start]( guide explains how to set up DroneKit on each of the supported platforms (Linux, Mac OSX, Windows) and how to write a script to connect to a vehicle (real or simulated).

A basic script looks like this:

from dronekit import connect

# Connect to UDP endpoint.
vehicle = connect('', wait_ready=True)
# Use returned Vehicle object to query device state - e.g. to get the mode:
print("Mode: %s" %

Once you've got DroneKit set up, the [guide]( explains how to perform operations like taking off and flying the vehicle. You can also try out most of the tasks by running the [examples](

## Resources

The project documentation is available at []( This includes [guide](, [example]( and [API Reference]( material.

The example source code is hosted here on Github as sub-folders of [/dronekit-python/examples](

The [DroneKit Forums]( are the best place to ask for technical support on how to use the library. You can also check out our [Gitter channel]( though we prefer posts on the forums where possible.

* **Documentation:** [](
* **Guides:** [](
* **API Reference:** [](
* **Examples:** [/dronekit-python/examples](
* **Forums:** [](
* **Gitter:** []( though we prefer posts on the forums where possible.

## Users and contributors wanted!

We'd love your [feedback and suggestions]( about this API and are eager to evolve it to meet your needs, please feel free to create an issue to report bugs or feature requests.

If you've created some awesome software that uses this project, [let us know on the forums here](!

If you want to contribute, see our [Contributing]( guidelines, we welcome all types of contributions but mostly contributions that would help us shrink our [issues list](

## Licence

DroneKit-Python is made available under the permissive open source [Apache 2.0 License](


Copyright 2015 3D Robotics, Inc.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dronekit-2.9.2.tar.gz (44.4 kB view hashes)

Uploaded source

Built Distributions

dronekit-2.9.2-py3.6.egg (116.0 kB view hashes)

Uploaded 3 6

dronekit-2.9.2-py3-none-any.whl (56.9 kB view hashes)

Uploaded py3

dronekit-2.9.2-py2.7.egg (118.1 kB view hashes)

Uploaded 2 7

dronekit-2.9.2-py2-none-any.whl (57.8 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page