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 trailsbiOr, 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" --openIt writes one HTML page to the current folder and, with --open, opens it in your browser.
Update
pip install -U trailsbiWarning: 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:
- Open the Start menu.
- Search for Edit environment variables for your account.
- Select Path and click Edit.
- Click New and paste the folder from pip's warning. It ends in
\Scripts. - 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.