Skip to content

Latest commit

 

History

History
110 lines (79 loc) · 1.82 KB

File metadata and controls

110 lines (79 loc) · 1.82 KB

Easy-Drone Quick Start Guide

Installation (One Command!)

cd /path/to/easy-drone-python
pip install -e .

That's it! You're ready to go! 🚁

Verify Installation

python verify_install.py

Run Your First Example

Terminal 1 - Start Subscriber

python examples/simple_subscriber.py

Terminal 2 - Start Publisher

python examples/simple_publisher.py

You should see messages flowing!

What Changed?

Before (Old Way)

cd examples
python simple_publisher.py  # Required sys.path hack inside file

After (New Way)

pip install -e .           # Install once
python examples/simple_publisher.py  # Run from anywhere!

Your Code Doesn't Need Changes!

Your existing code works exactly the same:

from gz_transport import Node
from gz.msgs.stringmsg_pb2 import StringMsg

node = Node()
pub = node.advertise("/topic", StringMsg)
# ... everything works the same!

Optional Features

# Zenoh backend support
pip install -e .[zenoh]

# YOLO computer vision
pip install -e .[yolo]

# Everything
pip install -e .[all]

More Examples

# List topics
python examples/topic_list.py

# Zenoh publisher/subscriber
python examples/zenoh_publisher.py
python examples/zenoh_subscriber.py

# Namespace example
python examples/namespace_example.py robot1-pub

Help & Documentation

Troubleshooting

Import errors?

pip install -e .

Protobuf errors?

pip install --upgrade 'protobuf>=4.25.0'

Still having issues?

python verify_install.py

Happy flying! 🚁✨