Build

Building for Trezor Model One? See the legacy documentation.

Setup

Install Nix (provides the nix-shell command). All system dependencies are managed by it.

We use uv to manage Python dependencies. It is installed automatically inside nix-shell.

The recommended setup is to first enter nix-shell, then initialize the uv environment within it.

git clone --recurse-submodules https://github.com/trezor/trezor-firmware.git
cd trezor-firmware
nix-shell
uv sync
source .venv/bin/activate

git submodule update --init --recursive --force
nix-shell
uv sync
source .venv/bin/activate

After completing setup, see Emulator or Embedded build instructions.