Metadata-Version: 2.4
Name: getdango
Version: 1.0.4
Summary: Open source data platform built with production-grade tools - dlt, dbt, DuckDB, and Metabase
Author: Dango Team
License: Apache-2.0
Project-URL: Homepage, https://getdango.dev
Project-URL: Documentation, https://docs.getdango.dev
Project-URL: Repository, https://github.com/getdango/dango
Project-URL: Issues, https://github.com/getdango/dango/issues
Keywords: data,analytics,dbt,duckdb,metabase,dlt,etl,data-platform,open-source
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: duckdb<1.6,>=1.5.0
Requires-Dist: dbt-duckdb<1.11,>=1.10.0
Requires-Dist: dbt-core~=1.10.0
Requires-Dist: dlt[duckdb]~=1.24.0
Requires-Dist: click>=8.1.7
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: jinja2>=3.1.4
Requires-Dist: watchdog>=5.0.0
Requires-Dist: rich>=13.7.0
Requires-Dist: inquirer>=3.4.0
Requires-Dist: requests>=2.33.0
Requires-Dist: httpx<1.0,>=0.27.0
Requires-Dist: idna>=3.15
Requires-Dist: starlette>=1.0.1
Requires-Dist: fastapi<0.137,>=0.136.0
Requires-Dist: uvicorn[standard]>=0.27.0
Requires-Dist: python-multipart>=0.0.27
Requires-Dist: websockets>=12.0
Requires-Dist: aiofiles>=23.2.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: structlog>=24.1.0
Requires-Dist: tomlkit>=0.13.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: plotly>=5.18.0
Requires-Dist: altair>=5.2.0
Requires-Dist: marimo>=0.23.0
Requires-Dist: presidio-analyzer>=2.2.0
Requires-Dist: spacy<3.9,>=3.8.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: cryptography>=46.0.7
Requires-Dist: pwdlib[bcrypt]<1.0,>=0.3.0
Requires-Dist: pyotp<3.0,>=2.9
Requires-Dist: toml>=0.10.2
Requires-Dist: google-api-python-client>=2.100.0
Requires-Dist: google-auth-oauthlib>=1.0.0
Requires-Dist: google-auth>=2.22.0
Requires-Dist: boto3>=1.34.0
Requires-Dist: paramiko>=3.0.0
Requires-Dist: apscheduler<4,>=3.11
Requires-Dist: sqlalchemy<3,>=2.0
Requires-Dist: croniter<4,>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=9.0.3; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: mypy>=1.11.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
Requires-Dist: types-requests>=2.31.0; extra == "dev"
Requires-Dist: types-psutil>=5.9.0; extra == "dev"
Requires-Dist: types-toml>=0.10.0; extra == "dev"
Requires-Dist: types-aiofiles>=23.2.0; extra == "dev"
Requires-Dist: pre-commit>=3.6.0; extra == "dev"
Requires-Dist: pip-audit>=2.7.0; extra == "dev"
Dynamic: license-file

# Dango

[![PyPI version](https://img.shields.io/pypi/v/getdango)](https://pypi.org/project/getdango/)
[![Python versions](https://img.shields.io/pypi/pyversions/getdango)](https://pypi.org/project/getdango/)
[![License](https://img.shields.io/github/license/getdango/dango)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/getdango/dango)](https://github.com/getdango/dango)

**Open-source data platform for small teams.**

Dango gives you a complete data stack — ingestion, warehouse, transformations, and dashboards — in a single CLI. It combines [dlt](https://dlthub.com/) for data loading, [DuckDB](https://duckdb.org/) as the analytics database, [dbt](https://www.getdbt.com/) for SQL transformations, and [Metabase](https://www.metabase.com/) for dashboards. One `pip install`, one command to start.

> **Upgrading from v0.1.x?** v1.0.0 is a complete rewrite. Back up your data and run `dango init` to create a new v1 project. See the [migration guide](https://docs.getdango.dev) for details.

## Quick Start

**Prerequisites:** Python 3.10-3.12, [Docker](https://docs.docker.com/desktop/) (for Metabase)

```bash
mkdir my-project && cd my-project
pip install getdango
dango init
dango start
```

Open [http://localhost:8800](http://localhost:8800) to see your data platform.

Or use the install script:

```bash
curl -sSL https://getdango.dev/install.sh | bash
```

For detailed installation instructions, see the [documentation](https://docs.getdango.dev).

## Features

- **33 data sources** — Stripe, Google Sheets, Google Analytics, Shopify, PostgreSQL, MySQL, CSV, REST APIs, and more
- **Auto-generated dbt models** — staging models created automatically when you add a source
- **Web dashboard** — monitor syncs, browse your data catalog, manage sources
- **Metabase integration** — dashboards and SQL queries, auto-configured and ready to use
- **Cloud deployment** — deploy to DigitalOcean or any server with `dango deploy`
- **Authentication** — admin login, user management, 2FA, API keys
- **Schema drift detection** — get alerted when source schemas change
- **PII scanning** — detect personally identifiable information across your tables
- **Notebooks** — Marimo notebooks connected to your DuckDB warehouse
- **Monitoring** — metric tracking with trend detection and drill-downs
- **Scheduled syncs** — cron-based scheduling with retry and timeout handling
- **Webhooks** — Slack notifications for sync results and alerts
- **File watcher** — auto-sync when CSV files change on disk

## Architecture

```
Sources  →  dlt  →  DuckDB  →  dbt  →  Metabase
(APIs,       (load)  (warehouse) (transform) (dashboards)
 CSVs,
 databases)
```

All data stays local in DuckDB. No external warehouse needed.

## Tech Stack

| Component | Tool | Role |
|-----------|------|------|
| Ingestion | [dlt](https://dlthub.com/) | Load data from 33+ sources |
| Warehouse | [DuckDB](https://duckdb.org/) | Embedded analytics database |
| Transformation | [dbt](https://www.getdbt.com/) | SQL modeling and testing |
| Dashboards | [Metabase](https://www.metabase.com/) | BI and SQL queries |
| Web UI | [FastAPI](https://fastapi.tiangolo.com/) | Monitoring and management |
| Containers | [Docker](https://www.docker.com/) | Metabase and service orchestration |

## Documentation

Full documentation at [docs.getdango.dev](https://docs.getdango.dev).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

## License

Apache 2.0 — see [LICENSE](LICENSE) for details.

## Links

- [PyPI](https://pypi.org/project/getdango/)
- [Changelog](CHANGELOG.md)
- [Issues](https://github.com/getdango/dango/issues)
