fbuild

library2.2.3pypypi✓ verified 82d ago

A platform-agnostic embedded build tool compatible with PlatformIO projects. Version 2.2.3 is the latest stable release. The project is actively maintained with a Rust core and Python CLI. Release cadence is irregular; check GitHub for updates.

devops

pip install fbuild

package ↗

INSTALL

IMPORT

SIG · FBUILD

fbuild

devopspythonv2.2.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Daemon

✓ from fbuild import Daemon

✗ from fbuild import FBuild

connect_daemon

✓ from fbuild import connect_daemon

AsyncDaemon

✓ from fbuild import AsyncDaemon

Basic usage: configure and run an embedded build. Adjust board and platform to match your project.

from fbuild import FBuild, FBuildConfig config = FBuildConfig( project_dir='./my_project', board='arduino_uno', platform='atmelavr' ) builder = FBuild(config) result = builder.build() print('Build succeeded:', result.success)

fbuild --version

Debug

Known issues

breakingPython 3.11+ requirement: fbuild 2.x requires Python >=3.10. Earlier Python versions (3.8, 3.9) are not supported.

fix

Upgrade Python to 3.10 or later.

affects: 2.0.0 and later

deprecatedThe `win_freestanding` and `linux_freestanding` platforms have been removed from fbuild 2.x. They were previously used for generating freestanding binaries.

fix

Use the standard platform: `win` or `linux` with appropriate config. Or switch to a different build system for freestanding targets.

affects: 2.0.0+

gotchaWhen using fbuild on Windows, make sure your build tools (like GCC or MSVC) are available in PATH. fbuild does not install compilers automatically.

fix

Install a compiler (e.g., MinGW or MSVC) and ensure it's accessible.

affects: all

gotchaIf your PlatformIO project has custom `extra_scripts`, they might not run under fbuild. fbuild uses its own build process and may ignore PlatformIO's extra scripts.

fix

Port any necessary extra_script logic to fbuild's configuration or pre/post build hooks.

affects: all

deprecatedThe command-line tool `fbuild` was renamed from `fb` in version 2.0.0. The old `fb` command is no longer available.

fix

Use `fbuild` instead of `fb` in scripts and documentation.

affects: 2.0.0+

Upgrade

Version history

2.2.3latest on PyPI · released Apr 24, 2026

Audit

Dependencies

platformiooptionalRequired for PlatformIO project compatibility when using fbuild with PlatformIO platforms

Agent activity

4 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/fbuild/ ↗