Metadata-Version: 2.4
Name: databao
Version: 0.6.2
Summary: QA agent for the Databao platform
Requires-Python: <3.14,>=3.11
Requires-Dist: claude-agent-sdk==0.1.56
Requires-Dist: click>=8.2
Requires-Dist: dbt-core==1.10.20
Requires-Dist: dbt-duckdb==1.10.1
Requires-Dist: dbt-metricflow==0.10.1
Requires-Dist: dbt-sqlite==1.10.0
Requires-Dist: duckdb>=1.1.0
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx>=0.28
Requires-Dist: jinja2>=3.1
Requires-Dist: kaleido>=1.0
Requires-Dist: langchain-anthropic>=0.3
Requires-Dist: langchain-mcp-adapters>=0.1
Requires-Dist: langgraph>=0.4
Requires-Dist: mcp[cli]>=1.0
Requires-Dist: metricflow==0.208.1
Requires-Dist: opentelemetry-api<1.42.0,>=1.30.0
Requires-Dist: pandas>=2.0
Requires-Dist: plotly>=6.1.1
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: python-dotenv>=1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: questionary>=2.0
Requires-Dist: requests>=2.32
Requires-Dist: rich>=13.0
Requires-Dist: sse-starlette>=2.0
Requires-Dist: tqdm>=4.67.3
Requires-Dist: typing-extensions>=4.15.0
Requires-Dist: uvicorn[standard]>=0.34
Provides-Extra: bigquery
Requires-Dist: dbt-bigquery==1.10.3; extra == 'bigquery'
Requires-Dist: google-cloud-bigquery>=3.40.1; extra == 'bigquery'
Provides-Extra: postgresql
Requires-Dist: asyncpg>=0.31.0; extra == 'postgresql'
Requires-Dist: dbt-postgres==1.9.1; extra == 'postgresql'
Provides-Extra: snowflake
Requires-Dist: dbt-snowflake==1.10.5; extra == 'snowflake'
Requires-Dist: snowflake-connector-python>=3.17.2; extra == 'snowflake'
Description-Content-Type: text/markdown

[![official project](https://jb.gg/badges/official.svg)](https://github.com/JetBrains#jetbrains-on-github)
[![PyPI version](https://img.shields.io/pypi/v/databao.svg)](https://pypi.org/project/databao)

<h1 align="center">Databao CLI</h1>

<p align="center">Databao is a data assistant in Slack for all your teams, with answers you can trust.

<p align="center">Databao CLI is the local toolkit for building and maintaining the semantic layer that powers the assistant for dbt projects. </p>


<p align="center">
 <a href="https://jetbrains.com/databao">Databao</a> •
 <a href="#quickstart">Quickstart</a> •
 <a href="https://docs.databao.app">Docs</a>
</p>

---

## Prerequisites

1. Python 3.11+
2. [uv](https://docs.astral.sh/uv/)
3. Claude Code
4. Google account
5. Git repository with your dbt project

---

## Installation

Databao CLI is [available on PyPI](https://pypi.org/project/databao/).

### Install globally

```bash
uv tool install databao
```

### Run without installing

```bash
uvx databao
```

---

## Quickstart

1. In the terminal, navigate to the root of your dbt project.

2. Launch Databao:

   ```bash
   databao
   ```
   
3. In the browser tab that opens, click **Sign in with Google** and follow the prompts.

4. In the terminal, select **Start Databao in Claude Code**:

   ```bash
   ? What would you like to do? (Use arrow keys)
   » Start Databao in Claude Code
   Advanced settings
   Quit
   ```
   
5. When asked by Claude, agree to use the skill and follow the prompts to generate the semantic layer.

6. When the semantic layer is generated, Claude will offer you to commit and push it to your GitHub repository.

For more details, 
check out the [quickstart guide](https://docs.databao.app/quickstart) in the [Databao docs](https://docs.databao.app).

---

## Troubleshooting

### Running Docker on ARM Macs (Apple Silicon)

The Kaleido container used for plot rendering relies on Chromium, which does not
run natively on ARM. To make it work, enable Rosetta emulation in Docker Desktop:

1. Open **Docker Desktop** -> **Settings** -> **General**.
2. Enable **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**.
3. Click **Apply & Restart**.

Without this, the Kaleido/Chromium container will fail to start on ARM Macs.
Docker's default QEMU emulation doesn't cover all the x86 instructions Chromium
uses and crashes on them (illegal-instruction / `SIGILL`), so Rosetta is
required here.

---

<p align="center">
 <a href="https://jetbrains.com/databao">Databao</a> •
 <a href="https://docs.databao.app">Docs</a>
</p>