Install platformio with Homebrew, MacPorts, Nix, apt

Project links

• Homepage
• Repository
• Package manager page

Commands and aliases

• pio
• piodebuggdb
• platformio

Project history

PlatformIO's official repository records a copyright period beginning in 2014. The project was created to provide a unified, cross-platform embedded-development workflow spanning different boards, architectures, frameworks, and vendor toolchains.

PlatformIO Core became the ecosystem's command-line and build backend. Other PlatformIO IDE and integration products wrap Core while retaining the same project model and CLI capabilities.

Adoption history

PlatformIO gained adoption by replacing vendor-specific embedded setup with a cross-platform build, package, library, board, and upload workflow. Its ecosystem expanded into IDE integrations, continuous integration, debugging, unit testing, static analysis, device monitoring, and remote development.

An official 2016 community announcement marked February 1, 2016 as a new starting point when the PlatformIO Team committed full-time effort to the project.

How it is used

Create or initialize a project, define one or more build environments in the project-root `platformio.ini`, and use `pio run` to build, upload, or execute other targets. PlatformIO resolves the selected board, framework, libraries, toolchain, and upload tools.

PlatformIO accounts are optional for core local builds but are used for registry ownership, organizations, teams, remote development, and restricted resources. Official documentation exposes automation credentials through `PLATFORMIO_AUTH_TOKEN`; it does not document a stable credentials-file location.

Why package nerds care

PlatformIO applies package-manager ideas to embedded development: toolchains, frameworks, libraries, board metadata, and upload utilities are resolved from declarative project environments instead of being assembled manually.

For package enthusiasts, it bridges host package management and target-specific dependency management. Installing one CLI exposes a reproducible workflow across many microcontroller architectures while PlatformIO manages the larger per-project toolchain graph.

Timeline

• 2014: The copyright period recorded in the official PlatformIO Core repository begins.
• 2016: The PlatformIO Team identified February 1 as a new starting point and committed full-time effort to the project.
• 2022: PlatformIO Core's 6.x release line began, continuing the declarative project and package workflow.

Related projects

• PlatformIO supports the Arduino framework while providing a broader multi-framework and multi-architecture environment. Development platforms package lower-level tools such as AVRDUDE for AVR targets and esptool for Espressif targets.

Sources

• https://community.platformio.org/t/urgent-the-further-fate-of-platformio-project-part-ii/148
• https://docs.platformio.org/en/latest/core/
• https://docs.platformio.org/en/latest/projectconf.html
• https://github.com/platformio/platformio-core