# pbidriver > pbidriver is an open-source (MIT) Python command-line tool, "WebDriver for Power BI Desktop", that lets AI agents > such as Claude Code, GitHub Copilot, OpenAI Codex and Cursor see and drive Microsoft Power BI Desktop on Windows: > pixel-exact screenshots of report pages, single visuals and the Table, Model, DAX query and TMDL views; the data > behind visuals; blocking dialogs; slicers, clicks, tooltips, menus, scrolling and bookmarks; DAX queries and model > metadata; and Performance Analyzer timings. Every command prints one JSON object. Key facts: - Install with `pip install pbidriver`, or from npm with `npx pbidriver` / `npm install -g pbidriver` (runs the same CLI through uv or Python). Needs Windows 10 or 11, Power BI Desktop (Store or installer build) and Python 3.9+ or uv. Runs locally; nothing is published to the Power BI service. - Two ways to connect: a report opened with `pbidriver launch` gets full control through Power BI Desktop's WebView2 DevTools (Chrome DevTools Protocol, via Playwright). Any other open Power BI Desktop window still gets page and visual screenshots, PBIP reload and unsaved state through Microsoft's Desktop Bridge (Power BI Desktop June 2026+), plus DAX and model metadata through the local Analysis Services engine. - Reads chart values from each data point's bound `tooltipInfo`, and table and matrix cells through ARIA grid roles, scrolling virtualized grids. - Handles all three dialog kinds Power BI Desktop uses (in-app WebView2, native WinForms, legacy Internet Explorer), reports them on every call as `alerts.blocked`, and answers them with `pbidriver dialog --click`. - Runs DAX through the ADOMD.NET client that ships with Power BI Desktop, so nothing extra is installed. - Commands: launch, instances, status, pages, alerts, visuals, shot, read, inventory, model, dax, perf, slicer, click, hover, menu, scroll, type, key, bookmarks, wait, dialog, reload, save, close. - Tested on Power BI Desktop 2.152 (March 2026) and 2.159 (November 2026), Microsoft Store builds. - Version 0.1.1, released 2026-11-22. Author: Jerome Eliezer (GitHub: speak2jerome). Licence: MIT. - Not an ODBC driver or data connector: "driver" as in WebDriver. ## Docs - [Documentation site](https://speak2jerome.github.io/pbidriver/): overview and install - [Use with AI agents](https://speak2jerome.github.io/pbidriver/agents/): setup for Claude Code, Copilot, Codex, Cursor, with recipes - [Command reference](https://speak2jerome.github.io/pbidriver/commands/): every command and option - [How it works](https://speak2jerome.github.io/pbidriver/how-it-works/): DevTools, Desktop Bridge, dialogs, data reading, security, limits - [FAQ](https://speak2jerome.github.io/pbidriver/faq/) - [README](https://github.com/speak2jerome/pbidriver/blob/main/README.md) ## Optional - [Changelog](https://github.com/speak2jerome/pbidriver/blob/main/CHANGELOG.md) - [PyPI package](https://pypi.org/project/pbidriver/) - [npm package](https://www.npmjs.com/package/pbidriver) - [Releases](https://github.com/speak2jerome/pbidriver/releases)