PicoForge

An open source commissioning tool for Pico FIDO security keys

Important

Check application Installation Wiki for installation guide of the PicoForge app on your system.

RP2350 (Pico2) Notice: If you are using an RP2350-based device (Pico2, etc.), please switch to RS-Key firmware instead of pico-fido for better support while using picoforge.

Supported Firmwares:

• RS-Key: v0.2.X, v0.3.X, v0.4.X
• LibreKeys One: v7.4.2
• pico-fido: v7.0, v7.2, v7.4, v7.6

About

PicoForge is a modern desktop application for configuring and managing RS-Key and pico-fido security keys. Built with Rust and GPUI, it provides an intuitive interface for:

• Reading device information and firmware details
• Configuring USB VID/PID and product names
• Adjusting LED settings (GPIO, brightness, driver)
• Managing security features (secure boot, firmware locking) (WIP)
• Real-time system logging and diagnostics
• Support for multiple hardware variants and vendors

Screenshots

Main Interface

PassKeys Management

Configuration Interface

Installation

Linux:

Other OS:

Check the official PicoForge Wiki for installation info of the application.

Requirements

Development Requirements

To contribute to PicoForge, you'll need:

• Rust - System programming language (1.80+)
• PC/SC Middleware:
  • Linux: pcscd (usually pre-installed)
  • macOS: Built-in
  • Windows: Built-in

Building from Source

1. Clone the Repository

git clone https://github.com/librekeys/picoforge.git
cd picoforge

Tip

Read-only mirrors are available for cloning:

Platform	URL
GitHub (Primary)	https://github.com/librekeys/picoforge
GitLab Mirror	https://gitlab.com/librekeys/picoforge
Codeberg Mirror	https://codeberg.org/librekeys/picoforge
Disroot Mirror	https://git.disroot.org/librekeys/picoforge

2. Build and Run

To run the application in development mode:

cargo run

To build for production:

cargo build --release

The compiled binary will be available in target/release/picoforge (Linux/macOS) or target/release/picoforge.exe (Windows).

Building and Development with Nix

Nix provides developers with a complete and consistent development environment.

You can use Nix to build and develop picoforge painlessly.

1. Install Nix

Follow the Installation Guide and NixOS Wiki to install Nix and enable Flakes.

2. Build & Run

a. with Flakes

You can build and run PicoForge with a single command:

nix run github:librekeys/picoforge

Or simply build it and link to the current directory:

nix build github:librekeys/picoforge

Tip

You can use our binary cache to save build time by allowing Nix to set extra-substitutes.

b. without Flakes

Download the package definition:

curl -LO https://raw.githubusercontent.com/librekeys/picoforge/main/package.nix

Run the following command in the directory containing package.nix:

nix-build -E 'with import <nixpkgs> {}; callPackage ./package.nix { }'

The compiled binary will be available at: result/bin/picoforge

3. Develop

You can enter a developement environement with all the required dependencies.

a. with Flakes

nix develop github:librekeys/picoforge

b. without Flakes

You can use the shell.nix file that is at the root of the repository by running:

nix-shell

Then you can build from source and run the application with:

cargo run

Contributing

Contributions are welcome (REALLY NEEDED, PLEASE HELP US)!

Please check the CONTRIBUTING.md file for the full contribution process and development guidelines.

Reference the project source code documentation for API details and architecture overview.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only).

See LICENSE for full details.

Repository Maintainers

• Suyog Tandel (@lockedmutex)
• Fabrice Bellamy (@Lab-8916100448256)

We are looking for new maintainers who can help us with actively maintaining the repository. If you are interested, please reach out to us on Matrix or Discord.

Package Maintainers

• JetCookies (@jetcookies): Maintainer of the Nix package.
• Suyog Tandel (@lockedmutex): Maintainer of the RPM package and Fedora Copr repository.

Support

• Matrix: Join our Matrix room
• Discord: Join our Discord server
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Disclaimer

Warning

PicoForge is experimental software and still in the Beta stage! The app does contain bugs and is not secure by any means.

It does not support all the features exposed by the pico-fido firmware and pico-hsm.

Caution

USB VID/PID Notice: The vendor presets provided in this software include USB Vendor IDs (VID) and Product IDs (PID) that are the intellectual property of their respective owners. These identifiers are included for testing and educational purposes only. You are NOT authorized to distribute or commercially market devices using VID/PID combinations you do not own or license. Commercial distribution requires obtaining your own VID from the USB Implementers Forum (usb.org) and complying with all applicable trademark and certification requirements. Unauthorized use may violate USB-IF policies and intellectual property laws. The PicoForge developers assume no liability for misuse of USB identifiers.

---

Made with ❤️ by the LibreKeys community

Copyright © 2026 Suyog Tandel