data-formulator README

The project's README from github.com/microsoft/data-formulator. As one markdown file: README.md.

Data Formulator icon  Data Formulator: AI-powered Data Visualization

🪄 Explore data with visualizations, powered by AI agents.

Try Online Demo   Install Locally

PyPI  License: MIT  YouTube  build  Discord

Why Data Formulator?

Working with data is hard for two simple reasons:

  1. Data lives everywhere. Connecting agents to files, databases, warehouses, and BI tools takes time. It is even harder when agents start answering before the relationships between data sources are clear.
  2. Questions evolve as you explore. Each answer can lead to follow-up questions, comparisons, and new directions. A long chat history makes it hard to see where you are and how you got there.

Data Formulator provides one visual workspace for exploring and analyzing data:

  1. Data connectors give agents a common way to connect to different data sources and maintains a data memory to remember the relationships between them.
  2. Data Threads let you branch into different questions, compare paths, and use visualizations to discover deeper insights without losing context.

https://github.com/user-attachments/assets/8e4f8a08-6423-4227-a1f7-559e0126ce31

[!TIP] Love the charts? They're built on Flint. It's an open-source visualization language that compiles compact chart specs into polished visualizations.

News 🔥🔥🔥

[08-15-2026] Data Formulator 0.8 beta 1 (0.8.0b1) introduces:

Preview with pip install --pre data_formulator==0.8.0b1 or uvx [email protected]. Install the latest stable release (0.7) with pip install data_formulator or run instantly with uvx data_formulator.

See the changelog for release details.

Previous Updates

Here are milestones that lead to the current design:

Overview

Data Formulator is a Microsoft Research project for data exploration with visualizations powered by AI agents. It combines UI interactions with natural language so analysts can communicate intent, branch into alternative analyses, and share results — starting from any data format (screenshot, text, CSV, or database).

Get Started

Play with Data Formulator with one of the following options.

Desktop downloads

CI builds self-contained Windows and macOS applications for pull requests and every update to main. Download the latest archives from the Artifacts section of the most recent desktop builds workflow. Workflow artifacts are retained for 30 days. Tagged builds are also attached as permanent downloads to the corresponding GitHub Release.

Extract the archive, then launch Data Formulator using the instructions for your operating system:

[!WARNING] These are automated preview builds and are not currently code-signed or notarized. Only bypass the operating-system warning when the archive was downloaded directly from this repository's workflow artifacts or releases.

Using Data Formulator

Start with the data you already have: upload CSV, TSV, Excel, JSON, screenshots, or text; connect to databases and data platforms; or ask the analyst to find and load the data you need. The analyst can discover sources, clarify your request, propose a loading plan, and let you review the data before adding it to the workspace.

Continue the conversation in the Data Thread. Ask questions in natural language and follow the reasoning through explanations, tables, and editable charts in one history. Refine a result directly, branch from any earlier step to explore an alternative, or delegate the next investigation to the analyst. When the analysis is ready, compose the results into a report to share.

https://github.com/user-attachments/assets/164aff58-9f93-4792-b8ed-9944578fbb72

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

data-formulator (microsoft/data-formulator)

Searching Database…

Что это такое?Data Formulator — это интерактивный инструмент для анализа данных на основе ИИ от Microsoft Research. Он позволяет исследовать данные, сочетая работу с интерфейсом и обычный язык, а ИИ-агенты берут на себя подключение данных, преобразования и создание графиков.
Это десктопное приложение или то, что я запускаю в браузере?Это Python-пакет, который запускает локальный сервер и открывает рабочую область в браузере. Кроме того, CI собирает автономные десктопные приложения для Windows и macOS.
Как его запустить?Самый быстрый способ — выполнить `uvx dataformulator` (или `pip install dataformulator`), и приложение сразу откроется в браузере. Также есть настройка через Docker Compose, а можно собрать проект самостоятельно по инструкции из DEVELOPMENT.md.
Для каких ИИ-провайдеров нужен API-ключ?Доступ к моделям вы подключаете сами через LiteLLM, который поддерживает OpenAI, Azure, Ollama или Anthropic.
Есть подводные камни при загрузке десктопных приложений?Готовые десктопные приложения для Windows и macOS — это автоматически собранные предварительные версии. Они не подписаны сертификатом разработчика и не прошли нотаризацию, поэтому SmartScreen в Windows и Gatekeeper в macOS будут их блокировать, и вам нужно вручную разрешить запуск приложения.
Работает только на Windows и macOS или на Linux тоже?Готовые десктопные сборки предназначены только для Windows и macOS. Но так как проект распространяется как Python-пакет, версию для браузера можно запустить и на Linux через pip, uv или Docker.
Что такое Data Thread?Это ветвящаяся история диалога в рабочей области: можно задавать уточняющие вопросы, сравнивать альтернативные пути анализа от любого прошлого шага и не терять контекст, как это бывает в обычном линейном чате.
Можно ли работать с большими наборами данных?Да, Data Formulator интегрируется с DuckDB для работы с большими данными и автоматически объединяет несколько таблиц.
Можно ли поделиться результатами с другими?Да, когда анализ готов, можно собрать таблицы, графики и пояснения в отчёт, которым можно поделиться.
Доступен ли интерфейс на языках, отличных от английского?Начиная с версии v0.7 интерфейс поддерживает несколько языков, включая английский и китайский.
Creator
microsoft
Size
41.4 MB
Stars
17.6K
Age
2y
Commits · 90 Days