Open-source visual tracking, AI object detection, and target-following software for PX4 drones and UAV companion computers.
PixEagle connects camera input to target state, follower command intent, operator telemetry, and guarded PX4 integration. Its modular Python and React stack combines OpenCV, YOLO, MAVSDK, MAVLink, FastAPI, and browser video streaming for education, research, companion-computer prototyping, and custom UAV vision projects.
Watch | Quick start | Explore capabilities | Read the docs | Collaborate
Watch the PixEagle playlist or see the PX4 and MAVLink routing tutorial. A new PixEagle v7 walkthrough is planned; the repository documentation remains the source of truth for current setup and safety behavior.
Maintained guided-bootstrap architectures: Debian-family Linux on x86_64
or ARM64. The one-line path follows the current main branch and is intended
for evaluation, education, and development.
curl -fsSL https://raw.githubusercontent.com/alireza787b/PixEagle/main/install.sh | bashFor the shortest first run:
- Press Enter for the recommended Core profile and displayed optional defaults.
- At dashboard access, enter
lfor this computer only, or press Enter for the displayed network address. - Press Enter at the login prompts to use
admin/admin. - Open the URL printed by setup, sign in, and select a target. Fresh installs use the bundled video; updates preserve the configured source.
Re-running the installer updates and repairs in place. It preserves an existing dashboard account and service/boot policy instead of repeating those setup prompts or silently changing them.
The included-video lab calculates follower command intents but cannot publish
PX4 commands. Network access is for temporary trusted lab networks; choose
l on an untrusted host. admin/admin is a beginner lab default, not a
deployment credential. Use the
Production Remote Runbook
before public or operational exposure.
Need Full AI, CUDA/Jetson, Raspberry Pi, GStreamer, services, repair, or secure remote access? Continue with the Installation Guide and Setup Profiles.
Experimental Core local preview: bundled video, classic tracking, authenticated loopback dashboard, and no PX4 commands. AI, cameras, services, remote access, and PX4/SITL are outside this preview. It is not a maintained deployment platform.
Install Git for Windows, CPython 3.11 or 3.12 x64, and Node.js 24 first. See the Windows Preview Guide for exact requirements, then open PowerShell:
$env:PIXEAGLE_ENABLE_EXPERIMENTAL_WINDOWS = "1"
irm https://raw.githubusercontent.com/alireza787b/PixEagle/main/install.ps1 | iex
cd "$HOME\PixEagle"
.\scripts\run.batPress Enter during first setup to keep admin/admin, then open
http://127.0.0.1:3040. Stop the preview with:
.\scripts\stop.batStatus, restart, media verification, repair behavior, and current limitations are documented in the Windows Preview Guide.
| Area | Current software surface |
|---|---|
| Video input | Files, USB/CSI cameras, RTSP, HTTP, UDP, and custom GStreamer pipelines |
| Tracking | OpenCV CSRT/KCF, optional dlib, AI-assisted SmartTracker, and external gimbal tracking |
| AI detection | Registered local YOLO detect/OBB models with runtime and accelerator checks |
| Guidance | Multicopter, fixed-wing, and gimbal follower profiles that produce typed command intents |
| PX4 integration | Telemetry and guarded Offboard publication paths through MAVSDK, MAVLink, and MAVLink2REST |
| Operator console | Live video, OSD, tracking/following state, settings, users, models, diagnostics, and logs |
| Streaming | Browser HTTP JPEG, WebSocket JPEG, and WebRTC, plus optional H.264/RTP/UDP GStreamer output |
| Engineering | Schema-driven configuration, typed REST APIs, component factories, and automated contract tests |
Hardware, network, model, and flight behavior still require validation on the exact target system. A listed integration surface is not a claim that every device or operating condition has been qualified.
camera or stream
-> frame preprocessing
-> detector / tracker
-> normalized target state
-> follower command intent
-> readiness and safety gates
-> local command preview OR reviewed PX4 / gimbal publisher
Only the configured live path can reach a control publisher. Recorded-video replay and the beginner lab remain separate command-preview workflows.
| Goal | Start here |
|---|---|
| Install, update, or troubleshoot | Installation, Setup Profiles, Troubleshooting |
| Configure cameras, streaming, and AI | Video System, Tracker System, Model Catalog, AI Accelerators |
| Connect PX4 or develop followers | Drone Interface, Follower System, Safety, Command Preview |
| Deploy or secure a system | Service Management, Production Remote Runbook, Binary Download Policy |
| Extend PixEagle | Full Documentation, Core App and API, Configuration, Architecture, Agent Guide |
See Known Issues and the Changelog before a new integration or deployment.
The release badge and release notes show the current local/demo software release. CI validates backend, dashboard, schema, setup, and selected media contracts. These checks do not prove tracker quality on a new camera, Raspberry Pi or Jetson performance, PX4 vehicle response, SITL/HIL behavior, field safety, or regulatory compliance.
Reproducible tests, Raspberry Pi acceptance, and production handoffs should use a reviewed exact commit as described in Exact-Commit Installation.
PixEagle is not certified avionics. Real-vehicle use requires qualified operators, independent safety review, verified failsafes and abort paths, controlled test progression, and compliance with local law. Use is at your own risk under the warranty and liability terms in the Apache License 2.0.
Reports from real cameras, Raspberry Pi or Jetson systems, PX4/Pixhawk, simulation, and controlled hardware tests are valuable when they include exact versions, configuration, commands, and sanitized logs.
PixEagle welcomes focused engineering contributions and collaboration in computer vision, aerial object detection, tracking, embedded acceleration, PX4/MAVLink integration, operator interfaces, and reproducible validation.
- Bug reports and feature proposals: GitHub Issues
- Questions and technical discussion: GitHub Discussions
- Research, commercial integration, and custom development: p30planets@gmail.com
- Maintainer: Alireza on LinkedIn
PixEagle source code is available under the Apache License 2.0. Models, datasets, downloaded binaries, and other third-party artifacts may have separate license terms.