Open Source RoboticsRobots, software & learning

Flix

Robot / hardware build

ESP32 quadcopter with a 3D-printed frame, four brushed motors switched by MOSFETs, an SPI IMU board, Arduino firmware with Wi-Fi/MAVLink control and a Gazebo simulator; no repository license file was identified. [1] [8]

Build & first use →Official websiteUpstream build guideBill of materials

For
Builders and educators able to 3D print, solder, flash ESP32 Arduino firmware and configure parameters through QGroundControl [1] [3]
Cost
No current cost yet. Upstream bill of materials [1]
Source rights
Some licenses are unresolved. Review licenses

Source researched · Not tested by us
Sources checked · Research details

Licenses & related hardware
Ecosystem
Arduino, Gazebo
License
MIT (declared in pyflix package metadata only) · no license identified for mechanical design, electronics, firmware, documentation · Details by part

Requirements · Research details and dates

On this page

Overview

Flix is a quadcopter built around an ESP32 board, a 3D-printed frame and four brushed motors, with Arduino firmware under 2,000 lines, Wi-Fi/MAVLink control and a Gazebo simulator. The README describes it as made for education and research. It suits builders who want to read and change a compact flight controller and who can print, solder and flash an ESP32 themselves. [1] [9]

Is this for you?

Use cases
  • Education
  • Research on flight control

[1]

Known limitations
  • README disclaimer: not easy to assemble and set up; provided as is
  • Barometer not used; position control planned
  • Frame optimized for the GY-91 board; other IMU boards need modified mount holes
  • No repository license file identified

Source-review boundaries; no build or flight performed.

[1] [8] · Editorial assessment

What you need

Operating system
  • Windows
  • Linux
  • macOS

Firmware build host operating systems, not drone software.

[3]

Host computer

Computer running Arduino IDE or Arduino CLI on Windows, Linux or macOS; Ubuntu 20.04 recommended for the Gazebo 11 simulator

[3] [9]

Dependencies
  • Arduino IDE 2 or Arduino CLI
  • ESP32 Arduino core 3.3.6
  • FlixPeriph library (latest)
  • MAVLink library 2.0.25
  • QGroundControl or Mavlink Joystick app for control
  • Gazebo 11 for simulation

[3] [9]

Tools
  • 3D printer
  • Soldering iron
  • Solder wire with flux
  • Screwdrivers
  • Multimeter

[1]

Skills
  • 3D printing
  • Soldering and wiring
  • Arduino/ESP32 firmware flashing
  • QGroundControl parameter setup

Derived from documented tools and setup steps.

[1] [3] · Editorial assessment

Hardware & parts

Upstream bill of materials [1]

Hardware configuration

Small quadcopter with four brushed motors and 55 or 65 mm propellers on a 3D-printed frame

[1]

Actuators
  • Four 8520 3.7 V brushed motors switched by 100N03A MOSFETs

README says the exact 3.7 V motor variant is required, not a ranged 3.7-6 V motor.

[1]

Controller

ESP32 Mini board (ESP32-S3/ESP32-C3 boards also supported)

[1]

Sensors
  • GY-91 / MPU-9265 (or other MPU-9250/MPU-6500), ICM-20948 or GY-521 (MPU-6050) IMU board

Barometer on GY-91 is not used.

[1]

Power

1S 3.7 V Li-Po (LW 952540 or size-compatible, 25C or more) with MX2.0 connector; optional 5 V boost converter

[1]

Assembly & first use

Open the upstream getting-started guide [3] · Project documentation [1]

  • Print the Version 1.1 frame, ESP32 holder and washers
  • Solder MOSFETs, pull-down resistors, IMU and power wiring per the README tables
  • Install Arduino IDE or Arduino CLI with ESP32 core 3.3.6, FlixPeriph and MAVLink 2.0.25
  • Set IMU type and orientation, calibrate the accelerometer, verify IMU status and attitude
  • Run motor tests without propellers and check rotation against the motor table
  • Configure smartphone, SBUS or USB remote control before flight

Editorial source-navigation sequence, not a reproduced or safety-qualified procedure.

[1] [3] · Editorial assessment

Assembly

Brief photo assembly guide; the pictured early build uses an inverted motor-direction scheme, so the motor table governs wiring.

[4]

Calibration

Accelerometer calibration via the ca console command; IMU orientation parameters; SBUS calibration via cr; joystick calibration in QGroundControl

[3]

Cost

No current, complete configuration-specific build cost has been established for this profile.

Cost, license and remaining gaps

No upstream price or BOM total was identified, so a build budget is not stated here. The parts table gives part types and quantities but no prices. [1]

No license file was identified in the pinned archive. Firmware and simulator files carry copyright headers without a license grant. The pyflix package metadata declares MIT, but that declaration covers only the Python package, and no MIT license text file was found. Simulator model metadata states its license as Unknown. Reuse rights for the CAD, firmware and documentation therefore remain unresolved. [5] [6] [7] [8]

The README disclaimer calls the project not easy to assemble and set up, and says it is provided without warranties. Weight, flight time and dimensions were not stated in the inspected sources. Repository activity continued after v1.5. No assembly, flashing, simulation or flight was performed for this profile. [1] [2]

3D preview

Preview not available yet. Design-source links are available. A configuration-matched assembly and its file-level reuse scope have not yet been reviewed for a hosted preview.

Project notes

Which configuration this profile covers

This profile pins release v1.5. The README at that release documents the Version 1.1 3D-printed frame build. The v1.5 release notes describe a first PCB attempt (the Flix2 board) whose IMU did not work, so an external MPU-6050 board was used. No PCB design files were identified in the pinned archive, so the PCB route is outside this profile. [1] [2] [8]

The Version 1.1 table lists an ESP32 Mini, an IMU board (GY-91/MPU-9265, ICM-20948 or GY-521), four 8520 3.7 V brushed motors with 100N03A MOSFETs, 55 or 65 mm propellers, a 1S Li-Po rated 25C or more, and printed frame, ESP32 holder and washer parts. Two details matter when ordering. The README asks for motors rated exactly 3.7 V, not a 3.7–6 V range. It also says the frame is laid out for the GY-91, so other IMU boards need modified mounting holes. The barometer is not used. Required tools are a 3D printer, soldering iron, solder with flux, screwdrivers and a multimeter. [1]

Firmware and setup requirements

The usage guide specifies ESP32 Arduino core 3.3.6 and MAVLink library 2.0.25, built with Arduino IDE or Arduino CLI, but asks for the latest FlixPeriph library without a fixed version, so a later rebuild may not use the same driver code. Before flight it requires setting the IMU type and orientation, calibrating the accelerometer, checking IMU status and attitude, and running motor tests with the propellers removed. The assembly guide warns that its photos show an early build with inverted motor directions, so wiring should follow the motor table rather than the photos. That table and the usage guide's motor-test commands agree: front-right and rear-left motors turn counter-clockwise, front-left and rear-right clockwise. Control can come from a smartphone app, QGroundControl with a USB controller, or an SBUS receiver. [1] [3] [4]

What we checked

Source research only; no installation, physical build, flashing or flight test performed. No affiliate links added.

Updates

Upstream last updated
Sep 30, 2026 [2]
Latest release
May 17, 2026 [2]
Profile updated
Oct 5, 2026
Sources last checked
Oct 5, 2026
Next review
Nov 5, 2026
Reviewed revision
4530c05b5c2a297b6a054c694bedbcbcb117a9cc (release v1.5, published 2026-05-17); README hardware table describes the Version 1.1 3D-printed frame build · combined hardware and software repository

Source files and licenses

Firmware, CAD and documentation are public, but no repository license file was identified; covered as source-available with reuse rights unresolved.

LayerAvailability / license
mechanical designavailable · No license identified
STL and STEP files for frame v1.1, ESP32 holder and washer. No license file identified in the inspected sources; copyright headers do not grant reuse permission. [1] [8]
electronicsavailable · No license identified
Simplified connection diagram and pin tables only; no PCB design files identified in the pinned archive (v1.5 release notes mention a Flix2 PCB). No license file identified in the inspected sources; copyright headers do not grant reuse permission. [1] [2] [8]
firmwareavailable · No license identified
Arduino firmware with copyright headers by Oleg Kalachev. No license file identified in the inspected sources; copyright headers do not grant reuse permission. [6] [8]
softwareavailable · MIT (declared in pyflix package metadata only)
tools/pyproject.toml declares MIT for pyflix, but no MIT license text file was identified. Gazebo simulator sources carry copyright headers; model.config files state license Unknown. [5] [7] [8] [9]
documentationavailable · No license identified
No license file identified in the inspected sources; copyright headers do not grant reuse permission. [1] [3] [8]

Flight control does not use learned weights.

No dataset is part of the selected build.

References

Each source links to the exact revision we read. “Used for” shows where this page relies on it.

Correction guidance · Discussion is not enabled · Profile format 0.7.0-draft.5

Change history

2026-10-05 — Initial intake from pinned release v1.5 (Growbotics comparison lead verified against upstream).