robowrap 0.8.4

A student-first wrapper around the DJI RoboMaster EP Python SDK.

robowrap

Student-first wrapper for the RoboMaster EP Python SDK.

The design goal is the same one shown in test.py: students should be able to write robot behavior as a sequence of clear intentions such as move, detect, grab, and close without learning the SDK transport layer first. Grouped subsystems like robot.cam, robot.arm, and robot.gun mirror the physical robot and keep the first classroom exercise short.

Project links

• PyPI package: robowrap on PyPI
• Modern SDK package: robomaster-sdk-modern on PyPI
• Modern SDK repository: RoboMaster-SDK (maintained fork)
• Original SDK: DJI RoboMaster SDK

Python support

robowrap now supports modern Python and is packaged for Python 3.9+, including Python 3.14+.

This change was made because the original DJI RoboMaster SDK appears to be unmaintained and still targets older Python releases. To keep the RoboMaster EP usable on current Python versions, robowrap now depends on the maintained robomaster-sdk-modern package instead.

Installation

python -m pip install --upgrade pip
python -m pip install robomaster-sdk-modern robowrap

robowrap depends on robomaster-sdk-modern, so installing robowrap is usually enough. Installing both explicitly makes the SDK choice clear.

robot.cam.view() uses PySide6 for live display and does not use OpenCV. This avoids the PyAV/OpenCV duplicate FFmpeg conflict on macOS.

To build and publish a new release:

python -m pip install --upgrade build twine
python -m build
python -m twine upload dist/*

Snake_case policy

• The public wrapper API is now snake_case only.
• Legacy camelCase and mixed-case names still work for one transition release and emit DeprecationWarning.
• Those aliases are scheduled for removal in 0.9.0, not before 2026-09-01.

Start here

• Student guide
• Quickstart
• API reference
• Coverage matrix
• Snake case migration
• Troubleshooting
• Contributor checklist
• Changelog

Example

from robowrap import RoboMaster

robot = RoboMaster()
robot.set_leds(0, 128, 255)
robot.forward(0.5)
robot.cam.detect_person()
robot.cam.view()
frame = robot.cam.frame()
robot.arm.move_to(x=0, z=50)
robot.close()