How neshanthr/llm-controllered-uav works
The product turns an operator’s natural-language request into a structured UAV mission, validates it, then dispatches flight operations and plots the recorded trajectory. Its main stages are planning, safety validation, mission dispatch, and vehicle control; trajectory logging is a supporting internal layer. The README documents the Ollama/Qwen and MAVSDK–MAVLink–PX4 SITL–Gazebo stack. Source excerpts confirm the Python call chain and logging/plotting links; simulator links and some integrations are documented rather than verified in sampled implementation.
Main entry points: main.py CLI orchestrator · executor.py Mission dispatcher · drone.py Drone controller · planner.py LLM planner
Components 14
Mission planning
- LLM planner
planner.py - Mission validator
validator.py
Mission dispatch
- CLI orchestrator
main.py - Mission dispatcher
executor.py
Flight control
- Flight executor
flight_executor.py - Drone controller
drone.py - MAVSDK
- MAVLink
- PX4 SITL
- Gazebo simulator
Flight observability
- Trajectory logger
trajectory_logger.py - Trajectory plotter
plot_trajectory.py
Other components
- Operator
- Ollama / Qwen
Connections 14
- Operator → CLI orchestrator: enters prompt
main.py - CLI orchestrator → LLM planner: requests plan
main.py - LLM planner → Ollama / Qwen: generates mission
README.md - CLI orchestrator → Mission validator: validates mission
main.py - CLI orchestrator → Mission dispatcher: dispatches mission
main.py - Mission dispatcher → Flight executor: selects flight operation
executor.py - Flight executor → Drone controller: runs flight actions
flight_executor.py - Drone controller → MAVSDK: controls vehicle
drone.py - MAVSDK → MAVLink: communicates over
README.md - MAVLink → PX4 SITL: sends vehicle commands
README.md - PX4 SITL → Gazebo simulator: controls simulation
README.md - Drone controller → Trajectory logger: records waypoints
drone.py - Mission dispatcher → Trajectory plotter: plots after execution
executor.py - Trajectory plotter → Trajectory logger: reads trajectory
plot_trajectory.py