giva-databricks 0.1.0__tar.gz

giva_databricks-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anuj Lathi
+
+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.

giva_databricks-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md LICENSE
+recursive-include giva/conf *.json
+recursive-include giva/sql *.sql
+recursive-include giva/genie *.md
+recursive-include giva/dashboards *.json
+recursive-include giva/jobs *.json
+recursive-include giva/data *.parquet *.gz
+recursive-include giva/notebooks *.py
+recursive-include giva/app *.yaml *.txt *.json *.py
+recursive-include giva/app/backend/static *

giva_databricks-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: giva-databricks
+Version: 0.1.0
+Summary: One-line installer for the GIVA Databricks demo (AI jewelry commerce: data + Vector Search + Genie + AI/BI dashboard + Lakebase + FastAPI app + paused background jobs).
+Author: Anuj Lathi
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/anuj1303/giva-databricks
+Keywords: databricks,genie,ai-bi,vector-search,lakebase,apps,retail,demo,dbdemos
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: databricks-sdk>=0.33.0
+Requires-Dist: psycopg2-binary>=2.9.9
+Dynamic: license-file
+
+# 💎 GIVA — one-line Databricks demo installer
+
+`giva` packages the entire **GIVA** AI jewelry-commerce demo into a
+single `pip`-installable package, à la [dbdemos](https://www.dbdemos.ai/). One call
+provisions the whole stack into your workspace from pre-baked real data.
+
+```python
+%pip install giva-databricks
+dbutils.library.restartPython()
+
+import giva
+giva.install('giva', catalog='my_catalog')
+```
+
+Locally with a CLI profile:
+
+```bash
+pip install giva-databricks
+python -c "import giva; giva.install('giva', profile='AnujLathi', catalog='anuj_vm_workspace_catalog')"
+```
+
+## What gets installed
+
+| # | Asset | Detail |
+|---|-------|--------|
+| 1 | **UC data layer** | schema + volume, `enriched_jewelry_products` (~236 LLM-enriched products) + `jewelry_embeddings` + ~236 product images |
+| 2 | **Vector Search** | `giva-vs` endpoint + `jewelry_embeddings_index` (DELTA_SYNC, 1024-dim) for semantic & image search |
+| 3 | **Genie Space** | natural-language analytics over the product catalog |
+| 4 | **AI/BI dashboard** | catalog & sales analytics, published |
+| 5 | **Lakebase (Postgres)** | `giva-orders` instance + `giva` db: orders, users, nudges, live metal prices, dynamic product prices — **seeded with data** |
+| 6 | **App** | React + FastAPI storefront + admin analytics (Databricks App) |
+| 7 | **Background jobs** | **Metals Refresh** + **Nudge Emails** — created **PAUSED** (stopped, not triggered) |
+
+### ⏸ The two pipelines are installed PAUSED
+
+Per design, the **Metals Refresh Pipeline** and **Nudge Emails Pipeline** jobs are
+created with their schedule `pause_status = PAUSED`. They will **not** run on a
+trigger. The demo works out of the box because metal prices and product prices are
+**seeded** into Lakebase. When you want a live refresh, either:
+
+- trigger them manually from the **admin app** (Run now), or
+- unpause the schedule in the Jobs UI.
+
+> The two job notebooks read Service-Principal credentials and (for emails) Gmail
+> OAuth from a Databricks secret scope `giva`. These secrets are **not**
+> created by the installer — set them before unpausing if you want the jobs to run.
+
+## Options
+
+```python
+giva.install(
+    'giva',
+    catalog='my_catalog',          # required on non-Free-Edition workspaces
+    schema='giva',          # default
+    warehouse_id=None,             # default: first running/available
+    install_app=True,
+    install_lakebase=True,         # provision Lakebase + seed
+    install_jobs=True,             # create the two PAUSED jobs
+    install_vector_search=True,
+    profile='AnujLathi',           # only when running locally
+)
+```
+
+## Rebuilding the package data (maintainers)
+
+The packaged `data/`, `dashboards/` and Lakebase schema are exported from the live
+reference build. To refresh them:
+
+```bash
+python scripts/export_live_assets.py --profile AnujLathi \
+    --catalog anuj_vm_workspace_catalog --schema caratlane_jewelry
+python -m build           # produces dist/giva-*.whl
+```
+
+## Installing the package
+
+Until it's on PyPI, install the wheel straight from a GitHub Release:
+
+```bash
+pip install https://github.com/anuj1303/giva-demo/releases/download/v0.1.0/giva-0.1.0-py3-none-any.whl
+```
+
+or build-and-install from source:
+
+```bash
+pip install "git+https://github.com/anuj1303/giva-demo.git"
+```
+
+## Publishing to PyPI (maintainers)
+
+The `Publish giva-databricks to PyPI` GitHub Action publishes via **trusted publishing**
+(OIDC — no API tokens). One-time setup, then a one-click publish:
+
+1. On https://pypi.org → your account → **Publishing** → **Add a pending publisher**:
+   - PyPI Project Name: `giva`
+   - Owner: `anuj1303`
+   - Repository name: `giva-demo`
+   - Workflow name: `publish.yml`
+   - Environment: *(leave blank)*
+2. In the repo: **Actions → Publish giva-databricks to PyPI → Run workflow**.
+
+> Note: the wheel is ~88 MB (the 11.5M-row `nudge_emails` seed is most of it).
+> That's under PyPI's 100 MB per-file limit but large — the GitHub Release wheel
+> above is the recommended distribution for most users.
+
+## Reference build
+
+- Workspace: AWS FE VM (`fe-vm-anuj-vm-workspace`)
+- Source catalog/schema: `anuj_vm_workspace_catalog.caratlane_jewelry`
+- App: `tanishq-jewelry-demo` (UI name **GIVA**)

giva_databricks-0.1.0/README.md

@@ -0,0 +1,110 @@
+# 💎 GIVA — one-line Databricks demo installer
+
+`giva` packages the entire **GIVA** AI jewelry-commerce demo into a
+single `pip`-installable package, à la [dbdemos](https://www.dbdemos.ai/). One call
+provisions the whole stack into your workspace from pre-baked real data.
+
+```python
+%pip install giva-databricks
+dbutils.library.restartPython()
+
+import giva
+giva.install('giva', catalog='my_catalog')
+```
+
+Locally with a CLI profile:
+
+```bash
+pip install giva-databricks
+python -c "import giva; giva.install('giva', profile='AnujLathi', catalog='anuj_vm_workspace_catalog')"
+```
+
+## What gets installed
+
+| # | Asset | Detail |
+|---|-------|--------|
+| 1 | **UC data layer** | schema + volume, `enriched_jewelry_products` (~236 LLM-enriched products) + `jewelry_embeddings` + ~236 product images |
+| 2 | **Vector Search** | `giva-vs` endpoint + `jewelry_embeddings_index` (DELTA_SYNC, 1024-dim) for semantic & image search |
+| 3 | **Genie Space** | natural-language analytics over the product catalog |
+| 4 | **AI/BI dashboard** | catalog & sales analytics, published |
+| 5 | **Lakebase (Postgres)** | `giva-orders` instance + `giva` db: orders, users, nudges, live metal prices, dynamic product prices — **seeded with data** |
+| 6 | **App** | React + FastAPI storefront + admin analytics (Databricks App) |
+| 7 | **Background jobs** | **Metals Refresh** + **Nudge Emails** — created **PAUSED** (stopped, not triggered) |
+
+### ⏸ The two pipelines are installed PAUSED
+
+Per design, the **Metals Refresh Pipeline** and **Nudge Emails Pipeline** jobs are
+created with their schedule `pause_status = PAUSED`. They will **not** run on a
+trigger. The demo works out of the box because metal prices and product prices are
+**seeded** into Lakebase. When you want a live refresh, either:
+
+- trigger them manually from the **admin app** (Run now), or
+- unpause the schedule in the Jobs UI.
+
+> The two job notebooks read Service-Principal credentials and (for emails) Gmail
+> OAuth from a Databricks secret scope `giva`. These secrets are **not**
+> created by the installer — set them before unpausing if you want the jobs to run.
+
+## Options
+
+```python
+giva.install(
+    'giva',
+    catalog='my_catalog',          # required on non-Free-Edition workspaces
+    schema='giva',          # default
+    warehouse_id=None,             # default: first running/available
+    install_app=True,
+    install_lakebase=True,         # provision Lakebase + seed
+    install_jobs=True,             # create the two PAUSED jobs
+    install_vector_search=True,
+    profile='AnujLathi',           # only when running locally
+)
+```
+
+## Rebuilding the package data (maintainers)
+
+The packaged `data/`, `dashboards/` and Lakebase schema are exported from the live
+reference build. To refresh them:
+
+```bash
+python scripts/export_live_assets.py --profile AnujLathi \
+    --catalog anuj_vm_workspace_catalog --schema caratlane_jewelry
+python -m build           # produces dist/giva-*.whl
+```
+
+## Installing the package
+
+Until it's on PyPI, install the wheel straight from a GitHub Release:
+
+```bash
+pip install https://github.com/anuj1303/giva-demo/releases/download/v0.1.0/giva-0.1.0-py3-none-any.whl
+```
+
+or build-and-install from source:
+
+```bash
+pip install "git+https://github.com/anuj1303/giva-demo.git"
+```
+
+## Publishing to PyPI (maintainers)
+
+The `Publish giva-databricks to PyPI` GitHub Action publishes via **trusted publishing**
+(OIDC — no API tokens). One-time setup, then a one-click publish:
+
+1. On https://pypi.org → your account → **Publishing** → **Add a pending publisher**:
+   - PyPI Project Name: `giva`
+   - Owner: `anuj1303`
+   - Repository name: `giva-demo`
+   - Workflow name: `publish.yml`
+   - Environment: *(leave blank)*
+2. In the repo: **Actions → Publish giva-databricks to PyPI → Run workflow**.
+
+> Note: the wheel is ~88 MB (the 11.5M-row `nudge_emails` seed is most of it).
+> That's under PyPI's 100 MB per-file limit but large — the GitHub Release wheel
+> above is the recommended distribution for most users.
+
+## Reference build
+
+- Workspace: AWS FE VM (`fe-vm-anuj-vm-workspace`)
+- Source catalog/schema: `anuj_vm_workspace_catalog.caratlane_jewelry`
+- App: `tanishq-jewelry-demo` (UI name **GIVA**)

giva_databricks-0.1.0/giva/__init__.py

@@ -0,0 +1,61 @@
+"""
+giva — one-line installer for the GIVA Databricks demo.
+
+GIVA is an end-to-end AI jewelry-commerce demo. One call provisions:
+
+  1. Unity Catalog data layer   (catalog/schema/volume, ~236 enriched products + images)
+  2. Vector Search index        (semantic + image search, 1024-dim)
+  3. Genie Space                (NL -> SQL over the product catalog)
+  4. AI/BI dashboard            (sales / catalog analytics, published)
+  5. Lakebase (Postgres)        (orders, users, nudges, live metal prices, dynamic product prices) + seed data
+  6. FastAPI + React app        (storefront + admin analytics)
+  7. Two background jobs        (Metals Refresh + Nudge Emails) — installed PAUSED (stopped, not triggered)
+
+Usage (inside a Databricks notebook):
+
+    %pip install giva-databricks
+    dbutils.library.restartPython()
+
+    import giva
+    giva.help()
+    giva.install('giva', catalog='my_catalog')
+
+Locally (with a Databricks CLI profile):
+
+    giva.install('giva', profile='DEFAULT', catalog='main')
+"""
+import json
+from importlib import resources
+
+from .installer import install, Installer  # noqa: F401
+
+__version__ = "0.1.0"
+__all__ = ["install", "list_demos", "help", "Installer", "__version__"]
+
+
+def list_demos():
+    """Print the demos bundled in this package."""
+    conf_dir = resources.files("giva").joinpath("conf")
+    print("\n💎  Available GIVA demos:\n")
+    for entry in conf_dir.iterdir():
+        if entry.name.endswith(".json"):
+            c = json.loads(entry.read_text(encoding="utf-8"))
+            print(f"   • {c['name']:<14} {c['title']}")
+            print(f"     {c['description'][:120]}…\n")
+    print("Install with:  giva.install('giva', catalog='<your_catalog>')\n")
+
+
+def help():
+    """Print quick-start help."""
+    print(__doc__)
+    print("Options for install():")
+    print("  demo            demo name (default 'giva')")
+    print("  catalog         target UC catalog   (default 'main')")
+    print("  schema          target UC schema    (default 'giva')")
+    print("  warehouse_id    SQL warehouse to use (default: first running/available)")
+    print("  install_app     also deploy the FastAPI app          (default True)")
+    print("  install_lakebase provision Lakebase + seed data       (default True)")
+    print("  install_jobs    create the two PAUSED background jobs (default True)")
+    print("  profile         Databricks CLI profile (only needed when running locally)")
+    print("  overwrite       reinstall over existing assets        (default False)\n")
+    print("Note: the Metals Refresh and Nudge Emails jobs are always created PAUSED.\n")

giva_databricks-0.1.0/giva/app/admin_config.json

@@ -0,0 +1,16 @@
+{
+  "analysts": [
+    {
+      "email": "admin@giva.co",
+      "password": "Giva@2026",
+      "name": "GIVA Admin",
+      "role": "admin"
+    },
+    {
+      "email": "analyst@giva.co",
+      "password": "analyst123",
+      "name": "Anuj Lathi",
+      "role": "analyst"
+    }
+  ]
+}

giva_databricks-0.1.0/giva/app/app.yaml

@@ -0,0 +1,45 @@
+command: ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]
+
+env:
+  # --- data layer (provisioned by the installer) ---
+  - name: GIVA_CATALOG
+    value: "{{CATALOG}}"
+  - name: GIVA_SCHEMA
+    value: "{{SCHEMA}}"
+  - name: GIVA_PRODUCTS_TABLE
+    value: "{{CATALOG}}.{{SCHEMA}}.enriched_jewelry_products"
+  - name: GIVA_VS_ENDPOINT
+    value: "{{VS_ENDPOINT}}"
+  - name: GIVA_VS_INDEX
+    value: "{{CATALOG}}.{{SCHEMA}}.jewelry_embeddings_index"
+  - name: GIVA_IMAGE_VOLUME
+    value: "/Volumes/{{CATALOG}}/{{SCHEMA}}/{{VOLUME}}"
+  # --- warehouse ---
+  - name: DATABRICKS_WAREHOUSE_ID
+    valueFrom: "sql-warehouse"
+  # --- Lakebase (orders / users / nudges / prices) ---
+  - name: LAKEBASE_HOST
+    value: "{{LAKEBASE_HOST}}"
+  - name: LAKEBASE_DB
+    value: "{{LAKEBASE_DATABASE}}"
+  # --- embedded analytics ---
+  - name: LAKEVIEW_DASHBOARD_ID
+    value: "{{DASHBOARD_ID}}"
+  - name: GENIE_SPACE_ID
+    value: "{{GENIE_SPACE_ID}}"
+  # --- background jobs (created PAUSED by the installer) ---
+  - name: PRICE_REFRESH_JOB_ID
+    value: "{{PRICE_REFRESH_JOB_ID}}"
+  - name: NUDGE_EMAIL_JOB_ID
+    value: "{{NUDGE_EMAIL_JOB_ID}}"
+
+resources:
+  - name: sql-warehouse
+    sql_warehouse:
+      id: "{{WAREHOUSE_ID}}"
+      permission: "CAN_USE"
+  - name: giva-orders-db
+    database:
+      instance_name: "{{LAKEBASE_INSTANCE}}"
+      database_name: "{{LAKEBASE_DATABASE}}"
+      permission: "CAN_CONNECT_AND_CREATE"