Tello-X 🚁

The easy way to control a DJI Tello drone from Python.

Features

• Easily pilot the Tello drone by sending commands and reading sensor data.
• Built-in support for AprilTag detection.
• Built-in data logging

Installation

We recommen installing tellox in a virtual environment:

# Create a virtual environment for your project
cd path/to/your/project
python -m venv venv

# Activate the virtual environment (you'll need to do this whenever you start a new shell)
source venv/bin/activate  # or just `venv/Scripts/activate` in Windows PowerShell

# Install this library
pip install tellox

That's it! Connect to your Tello over WiFi and try some of the examples.

For a minimal example:

import time
import tellox as tx

pilot = tx.Pilot()
pilot.takeoff()
pilot.land()

A note on coordinate frames

The Tello's body frame is defined North-East-Down (a standard for aircraft), so x points forward (out of the camera), y points to the right of the drone, and z points down. The camera frame is defined with z pointing out of the camera and x pointing to the right of the drone. If you use pilot.detect_tags to get the relative pose of AprilTags in the drone's view, then the returned translation pose_t and rotation pose_R are defined relative to the camera frame. To convert the tag position to the drone body frame, use pilot.convert_to_drone_frame.

License

Released under the MIT License by Charles Dawson.

Contributing

If you find a bug or would like to contribute a feature, that's awesome! Please file an issue and open a pull request. More details on contribution can be found in the CONTRIBUTING.md file.