Skip to main content

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 mpremote operations:
      • Run scripts
      • Open REPL
      • File transfer
      • Directory management
  • 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

  1. Connect your MicroPython device via USB
  2. Launch FalcoMP
  3. Select your device from the menu
  4. 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)

Source distribution for falco-mp 0.1.2
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)

Table of built distributions (wheels) for falco-mp 0.1.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page