Skip to content

pbidriver 0.1.0

Choose a tag to compare

@speak2jerome speak2jerome released this 22 Nov 08:08
· 8 commits to main since this release

First public release of pbidriver: WebDriver for Power BI Desktop. It lets AI agents see and drive Power BI Desktop locally, with no screen grabs and no publishing to the service. Every command prints one JSON object.

Highlights

  • See: pixel-exact captures of the canvas, single visuals, every visual, the full UI and the Table / Model / DAX query / TMDL views, with --annotate (visual indices drawn on the image) and --scale.
  • Any open Power BI: page and visual captures, reload after PBIP edits and unsaved state through Microsoft's Desktop Bridge (Power BI Desktop June 2026+), no DevTools needed.
  • Read: the data behind visuals: chart points, cards, whole tables and matrices, slicer options and selection.
  • Model: dax queries and model (tables, columns, measures with DAX, relationships) through the ADOMD.NET client that ships with Power BI.
  • Never stuck on dialogs: in-app, native and legacy Internet Explorer dialogs are detected on every call and answered with dialog --click; input is refused while a modal is open.
  • Interact: slicer, click, hover (tooltips), menu (context and More options), scroll, type, key, bookmarks, wait.
  • Measure: perf returns Performance Analyzer timings per visual, optionally with each visual's DAX query.
  • Report file: inventory lists pages, visuals, fields, filters and bookmarks from .pbix, .pbit and .pbip files.
  • Lifecycle: launch, instances, status, save, close --discard | --save.

Install

pip install https://github.com/speak2jerome/pbidriver/releases/download/v0.1.0/pbidriver-0.1.0-py3-none-any.whl

Needs Windows 10/11, Power BI Desktop and Python 3.9+. Tested on Power BI Desktop 2.152 (March 2026) and 2.159 (November 2026), Microsoft Store builds. See the README for every command and the agent instructions snippet.