FalcoMP
FalcoMP is a terminal-based device manager for MicroPython boards built around mpremote.
It provides a structured interface for interacting with devices over serial, managing files, and streamlining development workflows.
Gratuity is not necessary but may be directed to Buy Me a Coffee
Features
-
Device Discovery
- Automatically detects devices connected via serial on startup
-
Terminal UI (TUI)
- Keyboard-driven interface
-
File Explorer
- Browse device filesystem
- Create and delete files/directories
- Run micropython files directly on the device remotely.
-
Command Abstraction
- Wraps common
mpremoteoperations:- Run scripts
- Open REPL
- File transfer
- Directory management
- Wraps common
-
Smart Sync
- Diff-based synchronization between local working directory and device
- Only modified files are written
- Reduces unnecessary writes
-
Stub Generator
- Generates local type stubs from device modules
- Improves editor support with a custom typing file catered to your specific port
-
Configuration Injection
- Automatically deploys a lightweight JSON config to each device
- Enables:
- Device naming
- Ignore rules
- Sync behavior control
Installation
python -m venv env
env/Scripts/activate
pip install falco-mp
Usage
Start the interface:
env/Scripts/activate
falco-mp
Basic Workflow
- Connect your MicroPython device via USB
- Launch FalcoMP
- Select your device from the menu
- Use available actions:
- Run scripts
- Open REPL
- Sync files
- Manage filesystem
- Generate Typings/Stubs
Configuration
Each device receives a small JSON configuration file on first connection.
Example structure:
{
"name": "MyDevice",
"serial": "<device serial if applicable>",
"verify-on-sync": true,
"preserve-device-files": false,
"print_sync_report": true,
"ignore": ["typings", "__pycache__"],
"notes": []
}
- Stored directly on the device
- Used to control sync behavior and UI display
Design Philosophy
- Pure Python implementation
- Minimal overhead on device
- Deterministic file operations
- Optimized for MicroPython constraints
Requirements
- Python 3.10+
- MicroPython 1.16+
Notes
- FalcoMP does not replace
mpremote— it builds on top of it - Designed for local, direct USB workflows (not network-first)
License
MIT License
Metadata
Release files for falco-mp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| falco_mp-0.1.2.tar.gz | 19.5 kB | Without provenance | Details for falco_mp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| falco_mp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for falco_mp-0.1.2-py3-none-any.whl |
Total release size: 40.8 kB
Release files / falco_mp-0.1.2.tar.gz
| Download URL | falco_mp-0.1.2.tar.gz |
|---|---|
| Size | 19.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
294189c7ec9fefdbce67fcf3ee0d2eee00a6ff814164fbf770eb21d9f0048281
|
|
BLAKE2b-256 checksum How to use checksums |
88ade453a06e2eccca1ab861795046a51ec14fdc1e7dfc92c7947747f14b5857
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.12.2 Windows/11
|
Release files / falco_mp-0.1.2-py3-none-any.whl
| Download URL | falco_mp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f8519e32af035f016ff3010f084fd78bfeb894f80fc49c6093e8275cdc5ebb4
|
|
BLAKE2b-256 checksum How to use checksums |
1708eb6ffefa46d148e510d27202cb18ec0990185a7838fdfc22f3c1b92ffd98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.12.2 Windows/11
|
Security for falco-mp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.