kjacone/kamikaze_drone repository overview

⁠ROS-powered autonomous drone

ROS-powered autonomous drone control system with predictive control, trajectory planning, and real-time monitoring.

⁠Overview

This is a containerized autonomous drone control platform built with ROS Noetic. It provides modular services for drone control, Model Predictive Control (MPC), trajectory planning, performance monitoring, and system observability.

⁠Features

• ROS Noetic-based drone control
• Model Predictive Control (MPC)
• Trajectory planning and optimization
• Real-time performance monitoring
• Prometheus & Grafana observability
• Docker & Docker Compose support
• Modular, independently deployable services
• AMD64 and ARM64 support

⁠Docker Images

⁠Quick Start

⁠Pull the main image

docker pull kjacone/kamikaze_drone:latest

⁠Run

docker run -d \
  --name kamikaze_drone \
  -p 11311:11311 \
  -p 8001:8001 \
  kjacone/kamikaze_drone:latest

⁠Docker Compose

For the complete system with monitoring:

docker compose --profile full up -d

Check services:

docker compose ps

View logs:

docker compose logs -f

Stop the system:

docker compose down

⁠Architecture

Kamikaze Drone
      │
      ├── ROS Control
      ├── Predictive Controller
      ├── Trajectory Planner
      └── Performance Monitor
                │
                ▼
           Prometheus
                │
                ▼
             Grafana

⁠Monitoring

When the monitoring profile is enabled:

• Prometheus — metrics collection
• Grafana — dashboards and visualization

⁠Architecture Support

linux/amd64
linux/arm64

For Apple Silicon or ARM64 systems:

docker run --platform linux/arm64 kjacone/kamikaze_drone:latest

For AMD64:

docker run --platform linux/amd64 kjacone/kamikaze_drone:latest

⁠Requirements

• Docker Engine 20.10+
• Docker Compose v2+
• 8 GB RAM minimum
• 16 GB RAM recommended
• 20 GB+ available storage

⁠Configuration

Configuration can be provided through environment variables or Docker Compose.

Example:

ROS_MASTER_URI=http://ros-master:11311
ROS_HOSTNAME=kamikaze-drone
LOG_LEVEL=INFO

Do not expose ROS or monitoring ports publicly without appropriate network security.

⁠Useful Commands

Check running containers:

docker ps

Check resource usage:

docker stats

Check disk usage:

docker system df

View container logs:

docker logs -f kamikaze_drone

⁠License

MIT License.

Category: Robotics / Artificial Intelligence