database-tycoon 0.1.0__py3-none-any.whl

database_tycoon-0.1.0.dist-info/METADATA

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: database-tycoon
+Version: 0.1.0
+Summary: Database Tycoon — local-first analytics CLI that adapts to your existing data stack
+Project-URL: Homepage, https://github.com/Database-Tycoon/tycoon-cli
+Project-URL: Repository, https://github.com/Database-Tycoon/tycoon-cli
+Project-URL: Issues, https://github.com/Database-Tycoon/tycoon-cli/issues
+Author: Database Tycoon Team
+License: MIT
+License-File: LICENSE
+Keywords: analytics,cli,data,dbt,dlt,duckdb
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Requires-Python: >=3.12
+Requires-Dist: dbt-core==1.11.8
+Requires-Dist: dbt-duckdb==1.10.1
+Requires-Dist: dlt[duckdb]==1.24.0
+Requires-Dist: duckdb==1.5.1
+Requires-Dist: httpx==0.28.1
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==14.3.3
+Requires-Dist: typer==0.24.1
+Provides-Extra: ask
+Requires-Dist: ibis-framework[duckdb]==12.0.0; extra == 'ask'
+Requires-Dist: nao-core==0.0.59; extra == 'ask'
+Provides-Extra: dagster
+Requires-Dist: dagster-dbt==0.28.20; extra == 'dagster'
+Requires-Dist: dagster-dlt==0.28.20; extra == 'dagster'
+Requires-Dist: dagster-webserver==1.12.20; extra == 'dagster'
+Requires-Dist: dagster==1.12.20; extra == 'dagster'
+Provides-Extra: server
+Requires-Dist: fastapi==0.135.3; extra == 'server'
+Requires-Dist: uvicorn[standard]==0.44.0; extra == 'server'
+Requires-Dist: websockets==16.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# tycoon
+
+A pip-installable CLI that wires dlt → DuckDB → dbt → Rill into a working local analytics stack. No Docker, no cloud account required.
+
+**Adaptable**: bring your own ingestion (Airbyte, Fivetran), warehouse (Snowflake, BigQuery, MotherDuck), dbt project, BI tool, or orchestrator — `tycoon init` asks before it assumes.
+
+---
+
+## Install
+
+Requires Python >= 3.12.
+
+```bash
+pip install database-tycoon
+# or
+uv add database-tycoon
+```
+
+Optional extras:
+
+```bash
+pip install "database-tycoon[dagster]"   # Dagster orchestration
+pip install "database-tycoon[ask]"       # AI natural language queries (Ollama supported)
+```
+
+---
+
+## Quickstart
+
+The fastest path to a working dashboard uses the PokéAPI — no credentials, no signup.
+
+```bash
+# 1. Create a project
+mkdir my-project && cd my-project
+tycoon init --template csv-import
+
+# 2. Add the PokéAPI as a source (press Enter twice for defaults)
+tycoon data sources add rest_api
+
+# 3. Ingest into DuckDB
+tycoon data sources run pokeapi
+
+# 4. Scaffold dbt models and generate Rill dashboards
+tycoon data analyze pokeapi --rill
+
+# 5. Open Rill
+tycoon start --only rill
+```
+
+Rill opens at `http://localhost:9009` with `pokemon`, `berry`, and `type` tables ready to explore.
+
+Already have a pipeline? `tycoon init` will ask about your ingestion tool, warehouse, dbt project, BI tool, and orchestrator — and configure itself around what you already have.
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---|---|
+| `tycoon init` | Scaffold a new project |
+| `tycoon data sources catalog` | Browse available source integrations |
+| `tycoon data sources add <type>` | Register a new data source |
+| `tycoon data sources list` | List sources configured in this project |
+| `tycoon data sources list show <name>` | Show detailed config for a source |
+| `tycoon data sources run <name>` | Run ingestion for a named source |
+| `tycoon data sources run-all` | Run ingestion for all sources |
+| `tycoon data transform run` | Run dbt transformations |
+| `tycoon data analyze <source>` | Scaffold dbt staging models; add `--rill` to also generate dashboards |
+| `tycoon data db query <sql>` | Run a SQL query against the warehouse |
+| `tycoon data run-all` | Ingest all sources then run dbt build |
+| `tycoon data status` | Show freshness and row counts for each source |
+| `tycoon start` | Start Rill, Dagster, Nao, and the web UI |
+| `tycoon stop` | Stop all services |
+| `tycoon ask chat` | Query your data in natural language (Nao) |
+| `tycoon run <tool>` | Passthrough to dbt, dlt, rill, dagster |
+
+---
+
+## tycoon.yml Reference
+
+```yaml
+name: my-project
+version: 0.1.0
+
+database:
+  raw: data/raw.duckdb              # dlt output (or md: URI for MotherDuck)
+  warehouse: data/warehouse.duckdb  # dbt output — read by Rill and Nao
+
+dbt_project_dir: dbt_project   # path to dbt project (yours or tycoon-scaffolded)
+rill_dir: rill                 # path to Rill dashboard definitions
+
+stack:                         # generated by tycoon init — edit as needed
+  ingestion: dlt               # dlt | airbyte | fivetran | meltano | none
+  ingestion_managed: true      # false = tycoon won't run `data sources run`
+  warehouse: duckdb            # duckdb | motherduck | snowflake | bigquery | other
+  transformation_managed: true # false = tycoon won't scaffold or overwrite dbt
+  bi: rill                     # rill | metabase | looker | tableau | other | none
+  bi_managed: true             # false = tycoon won't start Rill
+  orchestrator: dagster        # dagster | airflow | prefect | other | none
+  orchestrator_managed: true   # false = tycoon won't start Dagster
+
+sources:
+  my-github:
+    type: github               # matches a catalog source name
+    schema: raw_github         # schema name in the raw DuckDB file
+    config:
+      access_token: ${GITHUB_TOKEN}   # env vars are interpolated
+      owner: my-org
+      repo: my-repo
+
+ask:                           # optional — requires tycoon[ask]
+  llm:
+    provider: ollama           # fully local, no API key required
+  port: 5005
+```
+
+Each source produces its own raw DuckDB file: `data/raw_<source>.duckdb`. All sources write into `data/warehouse.duckdb` after transformation.
+
+---
+
+## Catalog Sources
+
+These sources are available via `tycoon data sources add <name>`. They are downloaded on demand via `dlt init` and not bundled in the package.
+
+| Source | Category | Key Tables |
+|---|---|---|
+| `github` | Developer | commits, issues, pull_requests, repositories |
+| `slack` | Communication | channels, messages, users |
+| `stripe` | Finance | customers, invoices, products, subscriptions |
+| `hubspot` | CRM | companies, contacts, deals, tickets |
+| `notion` | Knowledge | databases, pages, users |
+
+---
+
+## Data Directory
+
+Raw DuckDB files follow the naming convention `raw_<source>.duckdb` (written by ingestion) while `warehouse.duckdb` is the single transformed database read by Rill and Nao. See `data/README.md` for details.
+
+---
+
+## Rill Dashboards
+
+Rill is a local-first BI tool. Dashboard definitions are YAML files in the `rill/` directory.
+Launch Rill via `tycoon start` or `tycoon start --only rill`.
+
+Auto-generate dashboards for a source after ingestion:
+
+```bash
+tycoon data analyze my-source --rill
+```
+
+This exports each raw table to Parquet, then generates Rill source, metrics view, and explore
+files — one dashboard per table. The `--rill` flag is opt-in; dashboard generation is skipped
+by default since it requires a Rill project directory (`rill/`) to already exist.
+
+**Architecture**: sources read from Parquet via Rill's `local_file` connector into its
+built-in in-memory OLAP. Dashboards are immediately usable without a dbt run.
+
+---
+
+## Optional Extras
+
+### Dagster orchestration (`tycoon[dagster]`)
+
+Installs Dagster, dagster-dbt, and dagster-dlt. Provides a full asset graph covering ingestion and transformation. Run the Dagster UI with:
+
+```bash
+dagster dev
+```
+
+The workspace is defined in `workspace.yaml` at the project root.
+
+### AI queries (`tycoon[ask]`)
+
+Installs Nao and Ibis for natural language querying of the warehouse. Requires a running LLM — Ollama (local) is supported out of the box with no API key.
+
+```bash
+tycoon ask init
+tycoon ask sync
+tycoon ask chat
+```

database_tycoon-0.1.0.dist-info/RECORD

@@ -0,0 +1,67 @@
+tycoon/__init__.py,sha256=ImDNYku37x5ujYY6mb7SEOmfdmbSn9ZtIRlihPw1xxY,102
+tycoon/__main__.py,sha256=yMmh1cCz2ClH8Trwestkn8OgbQOa8Fe_NgFGeOfXc8k,69
+tycoon/cli.py,sha256=O2JdFR76pdt1QltdWAGQXIr_-5nNme8KLWdGqdFc1ls,2497
+tycoon/config.py,sha256=9z1BRFtcxpwwX3K0ODSpmpNQ7pu1GcM-Z9EkKebQnRw,2886
+tycoon/constants.py,sha256=AODZ-rshuX65i5CkmNybIzeM8TQ397YjU3STVmaoCyo,440
+tycoon/dbt.py,sha256=JtrIFCENzzu5SUNfdoX_LDXN8EUfUPYRlVX_Mi7ACSA,689
+tycoon/nao.py,sha256=KDq_YOAKbCXP7bW7IPLVZRKO2OhkFEZjFChY7iAJ-uo,3717
+tycoon/project.py,sha256=tJtgJI-Yt8V6nBVGDZT4kKO-TOhuLsc8kMGkb5NYG9s,5474
+tycoon/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/commands/ask.py,sha256=vSP2yy7_5MMvyuYikhHy0jElH-jsAoI1NorZmBRElvQ,9637
+tycoon/commands/data.py,sha256=GsfxqQr3Hy0SwlWCya-PVn-a3BMVszOZq-PfCQCR2dc,789
+tycoon/commands/db.py,sha256=AIixLnqlYZjsw-uAs5NhPWP-l5L_c-Oeo2zo52dddTY,5192
+tycoon/commands/doctor.py,sha256=mAwuzAd-qiv8-tXVCPYM9k1g40dMKkdUH8RcFEB3qa0,5057
+tycoon/commands/explore.py,sha256=lg-UISHtJnweyCijVe0EnRkgeMbZqFHBwFsdCqt8DH0,6515
+tycoon/commands/init.py,sha256=p9VgjYUBY_l5NhiGeJ98bSIDvWCmuM8MISGzTVla7ME,12793
+tycoon/commands/run.py,sha256=WvtDFfghkp80IuKmc7YgpJJB-UP45XRwLHPyeWK-8uQ,909
+tycoon/commands/run_all.py,sha256=NYUCKeaNfEosOwLHnXutqCfHjF4pUn_md-vThIlVN8M,3711
+tycoon/commands/sources.py,sha256=csRlJ9cA_xmyZ-SsKyjc_RPHQKHhw3CtKS8ytoSjnXo,16962
+tycoon/commands/start.py,sha256=VOkCwRDQN3ZUvD8LI-aLBj_hjT5zqluth6Bz9hZ4FuU,4188
+tycoon/commands/status.py,sha256=RdlQLZGZf1NWzNmiHPzdDJB5L0eKj1r4hG8bPrC49v8,4003
+tycoon/commands/stop.py,sha256=Ewgemz0CktKhJ_hKbbPoLQkcSA3L2PassR9cmgPS5b4,3474
+tycoon/commands/transform.py,sha256=Jj3Cl3TJKEi-VGTeBG_M6rCiuAPQkzSg2Atgby1bcy4,5437
+tycoon/ingestion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/ingestion/catalog.py,sha256=98i9t2y8XYtDpAgvTckBd20YzgK79KzkBg2WUmMsTdU,7094
+tycoon/ingestion/ducklake_config.py,sha256=B17VjUMKzeQIyBc_QPvyPvsU6mjnNjc2hVwSgMmmEzo,2266
+tycoon/ingestion/mta_bus_speeds_pipeline.py,sha256=MnOUEweC9zsDHRF8aeZgtOQEKxtT5DykuMTIC01O5Vg,3021
+tycoon/ingestion/mta_pipeline.py,sha256=abuZUxWsA_jaq4Wg7XBQi-lJw3otxjHPu5BbilFYtfE,3331
+tycoon/ingestion/nyc_dot_pipeline.py,sha256=8thZhKQAV8iWey-mkU0ohlBeDbmCtCwJXni7vt9z0v0,3237
+tycoon/ingestion/runner.py,sha256=gHD3rYR6M3_hyKFUdbNBqjNgZFH-Af6d68NEKj6_EeI,8599
+tycoon/ingestion/source_installer.py,sha256=hAI5z68mr8f1Uu29OwNdcT4XIqwy1mEoZ0l8CBpBywI,2137
+tycoon/ingestion/source_manager.py,sha256=h2TgoltfdOzQpR-R4A2aZI6QxZOGGEwuJfbNW9Bwag8,8991
+tycoon/ingestion/sources/__init__.py,sha256=w1Nz20sFyDPHN8ZGXBx8PW-rRHcWz7RMock0TwIco9Q,58
+tycoon/orchestration/__init__.py,sha256=jxZUgJFa4PKYUOObgbYWlNDdtAuAxxrywW2zbN6DHDE,50
+tycoon/orchestration/definitions.py,sha256=RiCj-rrlGV4gm1DsXEwBvJLBGI6bhMZfw3V97ki9xx0,1831
+tycoon/orchestration/resources.py,sha256=NrGb3G55UdXAuNyRY0m9D8LJNGpZxK7xnp7W3TSJlEk,700
+tycoon/orchestration/assets/__init__.py,sha256=DQrCCN6LW0Nxbo068JLzV1KWqX9qz43650may8fh8PM,44
+tycoon/orchestration/assets/ingestion.py,sha256=XK1qgO-gypNkCm9A8DCNySlFdgQGzuOJV9fQDDf7Kx8,2036
+tycoon/orchestration/assets/rill.py,sha256=rtcnhSH5DzGJFR8lS_LdoMZlAlCKH3k4xVKqmDPmX7c,906
+tycoon/orchestration/assets/transforms.py,sha256=K_klTtUyzibA7-8yKWWLrmQp6P0OkaELKSLV_7IIhMg,577
+tycoon/scaffolding/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/scaffolding/dbt_generator.py,sha256=J_0IZioWfBH1k2Wt94Bkv2x1_WHR4mqHraI3YJWBd7o,6369
+tycoon/scaffolding/rill_generator.py,sha256=0V79Bxsq9TLvvYOwmlYcPeMzgjdjL2TkIUGx6758mZQ,11028
+tycoon/scaffolding/templates.py,sha256=mj_Fh-_s_hSYMjQOzJxQBoIOauSyeCCDJKB-7CXenhY,10010
+tycoon/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/server/app.py,sha256=OSNxqfdPJftYa5iZeAURTI4jOD56pNlNRiFqS4jIfG0,1337
+tycoon/server/routes.py,sha256=P5YN__SsvwxseniX699efRQWixyHaJjqZ53irTYLo3A,4177
+tycoon/server/spa.py,sha256=bAcL4Fbu3glCGvzuywMmL1NvjP_QBG9EJcSnFQNUEXU,9478
+tycoon/server/subprocess_manager.py,sha256=LuuTe9zcPB_OIomyBL-4kGVcR-_wqNpFrsNagGrAIcI,2437
+tycoon/server/websocket.py,sha256=tYkOuDKJ2lFI4aq3uXbyjiwn1wY-wKTDhzANk2ABPxY,1729
+tycoon/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/services/definitions.py,sha256=m63dlq4sY0s353RBoDJ_QABRQ97mZgj0gQKUVLDih6s,3025
+tycoon/services/manager.py,sha256=NV6S7bQCDq47tjuM6fYH3ek6DrHl1LdBpPb9KZSv7b0,4944
+tycoon/templates/csv-import/README,sha256=1p3iLV4UGF-OOLqCxsVzsvrHPU2wi1dLa6IsGFyzgkw,1174
+tycoon/templates/csv-import/tycoon.yml,sha256=x2gF95ha1uan8WsdjZ5G5bZQ5S6GsmaGUgvF70jqd74,356
+tycoon/templates/github-analytics/tycoon.yml,sha256=AUvSHOnvSQqKrNB8xJB8-vJIUVwpl0ygXHwu5coxX9w,591
+tycoon/templates/nyc-transit/README,sha256=QxDEVburEOkn4vtON3BvKUVfnZPVFTMIjL9Yrpakua0,405
+tycoon/templates/nyc-transit/tycoon.yml,sha256=gRrTpv6M_EFvopRW3bekgcmWDQ8y3Su51Tg2IZ9kKQw,1052
+tycoon/templates/weather-station/tycoon.yml,sha256=6ERh6doxxyiR9as65skjMRwl4sKe5ZSdR5wlGNVySVE,481
+tycoon/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tycoon/utils/console.py,sha256=5JhuO5X9oAfvRUIMoVyxd1jEDyajL8QetrP34-THsuM,1722
+tycoon/utils/duckdb_utils.py,sha256=RB6ka1ORk11soo05jGHSCIiVlZALRFLC0NKhL0D2w74,1566
+tycoon/utils/process.py,sha256=Xa2IPugd4jmeoEEREczpE_WoCJGYp7eTcwjsxTMVARk,996
+database_tycoon-0.1.0.dist-info/METADATA,sha256=tzS_28TYeR_qR9ow1GTuhkQi3ik5shxFMIZAtCGpfIc,7895
+database_tycoon-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+database_tycoon-0.1.0.dist-info/entry_points.txt,sha256=iFuXxzrq4hM3YUaXQt8mR5R-yUKQRuMAEDcWY2uVfzU,42
+database_tycoon-0.1.0.dist-info/licenses/LICENSE,sha256=z3CJiQFLI-klCa7KVfEplGwnivEbRBpG7kF6TIiTNno,1077
+database_tycoon-0.1.0.dist-info/RECORD,,

database_tycoon-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

database_tycoon-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tycoon = tycoon.cli:app

database_tycoon-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Database Tycoon Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tycoon/__init__.py

@@ -0,0 +1,3 @@
+"""Database Tycoon — local-first analytics CLI for exploring any dataset."""
+
+__version__ = "0.1.0"

tycoon/__main__.py

@@ -0,0 +1,5 @@
+"""Support `python -m tycoon`."""
+
+from tycoon.cli import app
+
+app()

tycoon/cli.py

@@ -0,0 +1,89 @@
+"""Top-level Typer app — entry point for the `tycoon` CLI."""
+
+from __future__ import annotations
+
+import typer
+from typer.core import TyperGroup
+
+import tycoon
+
+_COMMAND_ORDER = ["init", "ask", "data", "start", "stop", "run", "doctor"]
+
+_SECTIONS = {
+    "init":  "Project",
+    "ask": "AI Analytics",
+    "data":  "Data Pipeline",
+    "start": "Services",
+    "stop":  "Services",
+    "run":   "Tools",
+    "doctor": "Utilities",
+}
+
+
+class _OrderedGroup(TyperGroup):
+    def list_commands(self, ctx: object) -> list[str]:
+        commands = super().list_commands(ctx)
+        return sorted(commands, key=lambda c: _COMMAND_ORDER.index(c) if c in _COMMAND_ORDER else 99)
+
+    def format_commands(self, ctx: object, formatter: object) -> None:
+        seen: dict[str, list[tuple[str, str]]] = {}
+        for name in self.list_commands(ctx):
+            cmd = self.commands.get(name)
+            if cmd is None or getattr(cmd, "hidden", False):
+                continue
+            section = _SECTIONS.get(name, "Commands")
+            seen.setdefault(section, []).append(
+                (name, cmd.get_short_help_str(limit=formatter.width))
+            )
+        for section, rows in seen.items():
+            with formatter.section(section):
+                formatter.write_dl(rows)
+
+
+app = typer.Typer(
+    name="tycoon",
+    help="Database Tycoon — local-first analytics CLI for exploring any dataset.",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+    rich_markup_mode=None,
+    cls=_OrderedGroup,
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"tycoon {tycoon.__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def _root(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        help="Print version and exit.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    pass
+
+
+from tycoon.commands import ask, data
+from tycoon.commands.doctor import doctor_cmd
+from tycoon.commands.init import init_cmd
+from tycoon.commands.run import run_cmd
+from tycoon.commands.start import start_cmd
+from tycoon.commands.stop import stop_cmd
+
+app.command(name="init")(init_cmd)
+app.add_typer(ask.app, name="ask")
+app.add_typer(data.app, name="data")
+app.command(name="start")(start_cmd)
+app.command(name="stop")(stop_cmd)
+app.command(
+    name="run",
+    context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
+)(run_cmd)
+app.command(name="doctor")(doctor_cmd)