Metadata-Version: 2.4
Name: analytics-models-studio
Version: 0.1.0
Summary: Open-source, self-hosted GUI for scheduling and monitoring dbt Core pipelines
Project-URL: Homepage, https://github.com/analytics-models-studio/ams
Project-URL: Repository, https://github.com/analytics-models-studio/ams
Project-URL: Documentation, https://github.com/analytics-models-studio/ams#readme
Project-URL: Issues, https://github.com/analytics-models-studio/ams/issues
Author: Analytics Models Studio Contributors
License: MIT
Keywords: analytics,data-engineering,dbt,orchestration,scheduler
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: alembic>=1.13.0
Requires-Dist: apscheduler>=3.10.0
Requires-Dist: croniter>=2.0.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: fastapi>=0.111.0
Requires-Dist: pydantic-settings>=2.3.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.7.0
Requires-Dist: sqlalchemy>=2.0.30
Requires-Dist: typer>=0.12.0
Requires-Dist: uvicorn[standard]>=0.30.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: black>=24.4.0; extra == 'dev'
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# Analytics Models Studio (AMS)

> Open-source, self-hosted GUI for scheduling and monitoring dbt Core pipelines.

AMS provides a complete web platform to schedule, monitor, and manage your dbt Core data transformation pipelines — no Airflow, Prefect, or cloud dependency needed.

## Quick Start

```bash
pip install analytics-models-studio
ams init --project-dir /path/to/your/dbt/project
ams serve
```

Open http://localhost:8585 in your browser.

## Features

- 📅 **Job Scheduling** — Cron-based scheduling with model selection, branch targeting, and timeout protection
- 🔄 **Git Integration** — Automatic fetch/checkout/pull before each execution with commit tracking
- 📊 **Log Streaming** — Real-time WebSocket log viewer with per-model result breakdown
- 📈 **Dashboard** — 14-day execution trends, success rates, and pipeline health metrics
- 🕸️ **Lineage Explorer** — Interactive DAG visualization from `manifest.json` with saved views
- 📖 **Data Catalog** — Column-level metadata, test coverage, and model performance analytics
- 🌡️ **Source Freshness** — Monitor data freshness with status indicators and thresholds
- 🔧 **Onboarding Wizard** — Guided setup with environment detection and adapter installation
- 🔐 **Credential Encryption** — Fernet-based at-rest encryption for service accounts and tokens
- 🖥️ **Cross-Platform** — Windows Server, Linux, macOS with conda/venv environment support
- 🧩 **API-First** — Full REST API with OpenAPI docs at `/docs`

## CLI

```
ams serve     Start the web server
ams init      Initialize AMS configuration
ams version   Show installed version
ams info      Show environment information
```

## Requirements

- Python ≥ 3.10
- dbt-core ≥ 1.7 (with your database adapter)
- Git ≥ 2.30

## License

MIT
