hanyazou/TelloPy

DJI Tello drone controller python package

# TelloPy — Python controller for DJI Tello drones

## What it is
TelloPy is a Python package that lets you control a DJI Tello toy drone. The core code was adapted (ported) from the GOBOT project, which is written in Go. For deep protocol details, the README points to GOBOT's blog post (April 2018).

## Installation
Two options:
* **From PyPI (stable version):** `pip install tellopy`
* **From source:** Clone the GitHub repo, build a wheel with `python setup.py bdist_wheel`, then install the generated `.whl` file.

## Documentation
The README doesn't include separate docs. Instead, run Python and use the built-in help system: `import tellopy` then `help(tellopy)` to see the package's API docstrings.

## Examples (in the `examples` folder)
* **simple_takeoff** — Tello takes off, then lands automatically after a few seconds. Run with `python -m tellopy.examples.simple_takeoff`.
* **video_effect** — Filters and displays the real-time video stream from Tello. Requires extra packages: `av`, `opencv-python`, `image`.
* **joystick_and_video** — Controls Tello with a PS3/PS4/Xbox One gamepad while viewing video. Same video-related packages as above, plus `pygame`.

## Related side projects (links in README)
* **HalloPy** — Hand-motion controller: control Tello with hand movements.
* **telloCV** — OpenCV-based controller: generates video frames for computer-vision use, and includes a color tracker that follows a detected color in the scene.

Related

  • Project
    robocurve/inspect-robots

    Inspect Robots is an open‑source Python framework for defining robotics benchmarks and running any policy—LLM agents, VLAs, scripted scripts—on real robots, simulators, or a mock world. It logs full sensor streams, policy transcripts, and scores, and offers live Rerun visualisation. Plugins add support for specific robots (YAM, Franka, etc.) and backends (ROS, Isaac Sim). The core is lightweight (NumPy only) with optional extras for visualization, LLM agents, code‑as‑policy, and voice input.

  • Project
    TongjiSuperPower/sp_vision_25

    An open-source auto-aiming and fire-control system for combat robots that uses neural network detection and trajectory planning to maximize hit rates and minimize kill times.

  • Project
    zita-ch/supermimic_vibed

    This project is an independent reproduction of the SuperMimic method for whole-body humanoid control. It trains a policy to track LAFAN1 motions using a differentiable world model, achieving results on par with the paper in under 1.5 GPU-hours on a single GPU.

  • Project
    Flaminis/Dalaran

    A robotics-first observability and visualization stack for multimodal time-series data, providing synchronized 3D/2D viewing and Arrow-backed storage for robot sensor streams.