Install and setup

TrailsBI needs Python 3.9 or later and nothing else. Pick one way to install it, run it on a Power BI project, and fix the one warning Windows users sometimes see.

Install

With pip or uv. Either installs for your user account only, with no admin rights:

pip install trailsbi

Or, with no install at all, download trailsbi.pyz from the latest release and run it with Python:

python trailsbi.pyz "D:\Reports\Sales"

Each release lists SHA-256 checksums in SHA256SUMS.txt; the Trust page shows how to check them.

Run it

In Power BI Desktop, save the report as a Power BI project (File, Save as, Power BI project). Then point TrailsBI at the project file or its folder:

trailsbi "D:\Reports\Sales\Sales.pbip" --open

It writes one HTML page to the current folder and, with --open, opens it in your browser.

Update

pip install -U trailsbi

Warning: the script trailsbi.exe is installed in '...\Scripts' which is not on PATH

On Windows, Python from the Microsoft Store or the Python install manager puts commands installed with pip in a Scripts folder that is not on your PATH. pip warns about it while installing, and running trailsbi then returns 'trailsbi' is not recognized.

The fix takes a minute and needs no admin rights:

  1. Open the Start menu.
  2. Search for Edit environment variables for your account.
  3. Select Path and click Edit.
  4. Click New and paste the folder from pip's warning. It ends in \Scripts.
  5. Click OK, then OK again.

Windows that were already open keep the old PATH, so run it in a new PowerShell or Command Prompt window:

trailsbi "your-PBIP-project-folder-or-file-path"

Installed with uv? Run uv tool update-shell once, which adds uv's tool folder to your PATH, then open a new terminal.

Still not recognized? Check which Python pip used with python -m pip --version, and that pip install trailsbi ran with that same Python. Or use python -m trailsbi, which needs no PATH change.

Something else? See support.