prismnote 0.4.0__tar.gz → 0.4.1__tar.gz

{prismnote-0.4.0/python/prismnote.egg-info → prismnote-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prismnote
-Version: 0.4.0
+Version: 0.4.1
 Summary: Modern, open-source Jupyter-compatible data science notebook with Rust performance
 Author-email: Georgi Mammen Mullassery <mullassery@gmail.com>
 License: MIT
@@ -59,7 +59,7 @@ Dynamic: license-file
 **A fast, modern, open-source data-science notebook.**
 Rust engine · React UI · local-first · AI-native.
 
-**License:** MIT · **Status:** Beta (v0.4)
+**License:** MIT · **Status:** Beta (v0.4) · **PyPI:** [`prismnote`](https://pypi.org/project/prismnote/)
 
 </div>
 
@@ -68,72 +68,106 @@ Rust engine · React UI · local-first · AI-native.
 ## Overview
 
 PrismNote is a local-first alternative to Jupyter, Zeppelin, and Databricks notebooks.
-It pairs a **Rust + Axum** backend and a **persistent Python kernel** with a modern,
-**VS Code-style React** interface. Write Python and SQL, get rich output and live
-charts, ask a local AI for help, schedule notebooks as jobs, manage git, and ship to
-the cloud — all from one app that runs entirely on your machine.
+A **Rust + Axum** backend drives a **persistent Python kernel**, and a modern,
+**VS Code-style React** UI gives you Python + SQL, rich output and live charts, local
+AI assistance, scheduled jobs, git, and generated cloud-deploy files — all on your machine.
 
-- **Local-first & private** — runs on your machine; local AI via Ollama, no account required.
-- **Jupyter-compatible** — native `.ipynb` format.
+- **Local-first & private** — runs locally; local AI via Ollama, no account required.
+- **Jupyter-compatible** — native `.ipynb` import/export.
 - **Batteries included** — kernel, SQL, charts, AI, jobs, git, deploy, search, terminal.
 
+> **Status note:** PrismNote is **beta**. The notebook, kernel, AI, jobs, git, and
+> charts are functional. Cloud-warehouse connectors are **scaffolding** (query results
+> are currently stubbed), and deployment files are **generated templates** you review
+> before shipping. See the [roadmap](#roadmap).
+
+---
+
+## Install & run
+
+### From source (recommended today)
+Requires **Rust** (stable), **Node 18+**, and **Python 3.8+** on `PATH`:
+
+```bash
+# Python runtime deps for the kernel (ipykernel is required; the rest enable
+# rich output, %sql, and charts)
+pip install ipykernel pandas matplotlib rich duckdb
+
+# 1) backend — http://localhost:8000
+cargo run
+
+# 2) frontend — http://localhost:5173 (proxies /api and /ws to the backend)
+cd frontend && npm install && npm run dev
+```
+Open http://localhost:5173.
+
+### From PyPI
+```bash
+pip install prismnote
+prismnote
+```
+The PyPI package is a thin launcher: on first run it downloads the prebuilt server
+binary for your platform from the matching **GitHub Release** (`vX.Y.Z`). If a release
+binary isn't published for your platform/version yet, use the from-source steps above.
+(`pip install prismnote` succeeds regardless; only the prebuilt launch depends on a release.)
+
+### Enable AI (optional)
+- **Local, free, private — Ollama:** install from https://ollama.com, then
+  `ollama pull qwen2.5-coder`. The UI talks to Ollama from the browser, so allow the
+  dev origin once:
+  ```bash
+  OLLAMA_ORIGINS=http://localhost:5173 ollama serve
+  ```
+- **Claude / OpenAI:** set it in AI settings, or via env (persisted to
+  `~/.prismnote/ai_config.json`):
+  ```bash
+  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
+  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
+  ```
+
 ---
 
 ## Features
 
 ### Notebook & execution
-- **Persistent shared kernel** — variables, imports, and functions defined in one cell
-  are available in every later cell (true notebook semantics).
-- **Per-cell interpreters (magics)**:
-  - `%python` (default) — runs in the shared kernel.
-  - `%sql` — in-process **DuckDB**; can query pandas DataFrames defined in other cells.
-  - `%sh` / `%bash` / `!cmd` — shell commands.
-  - `%md` / `%markdown` — rendered markdown.
-- **Rich output** — text, HTML, matplotlib figures (`image/png`), and pandas DataFrames.
-- **Chart switcher** — view any DataFrame as a **Table, Bar, or Line** chart.
+- **Persistent shared kernel** — variables/imports/functions from one cell are
+  available in later cells.
+- **Per-cell interpreters (magics):** `%python` (default), `%sql` (in-process DuckDB;
+  can query DataFrames from other cells — needs `pip install duckdb`), `%sh` / `!cmd`
+  (shell), `%md` (rendered markdown).
+- **Rich output** — text, HTML, matplotlib figures, and pandas DataFrames.
+- **Chart switcher** — view any DataFrame as **Table / Bar / Line**.
 - **Live streamed output** over WebSocket while a cell runs.
-- **Interrupt** a running cell (Stop) and **restart** the kernel from the toolbar/menu.
-- **Dynamic input widgets** — `prism.input / slider / select / checkbox` render controls
-  that re-run the cell when changed (Databricks `dbutils.widgets`-style).
-- Pretty-printing enabled by default via `rich`.
+- **Interrupt** a running cell and **restart** the kernel.
+- **Dynamic input widgets** — `prism.input / slider / select / checkbox` re-run the
+  cell when changed.
 
 ### AI assistance
-Works with **local models via Ollama** (free, private, offline) or **Claude / OpenAI**.
-- **⌘K in-cell edit** — describe a change, review a diff, accept or reject.
-- **Fix with AI** — one click on an errored cell.
-- **Explain** — a teaching-oriented explanation with a contextual tip.
-- **Inline autocomplete** — ghost-text completions when Ollama is connected.
-- **Teacher persona** — any model explains the "why" and suggests tips/tricks.
-- **Agent panel** — Plan/Act assistant that can propose and apply cell edits.
+Local models via **Ollama**, or **Claude / OpenAI**.
+- **In-cell AI edit** (diff accept/reject), **Fix with AI** on errors, **Explain**.
+- **Inline autocomplete** (ghost text) when Ollama is connected.
+- **Teacher persona** — explanations of the "why" plus a contextual tip.
+- **Agent panel** — Plan/Act assistant that proposes and applies cell edits.
 
 ### Errors that help
-- **Natural-language explanations** for common Python errors (NameError, KeyError,
-  ModuleNotFoundError, TypeError, ZeroDivisionError, SyntaxError, …).
-- **In-editor markers** highlighting the offending **line and column**.
-- Collapsible full traceback when you want the details.
-
-### Workflow: Jobs, Airflow, Git, Deploy
-- **Jobs** — save a whole notebook and run it as a unit, **manual / interval / daily**,
-  with status and run history (Airflow-style).
-- **Airflow** — a stable `run-by-name` trigger plus a **generated, ready-to-use DAG**.
+- **Natural-language explanations** for common Python errors.
+- **In-editor markers** on the offending line/column, with a collapsible traceback.
+
+### Workflow
+- **Jobs** — save a whole notebook and run it as a unit: **manual / interval / daily**,
+  with status + run history.
+- **Airflow** — a stable `run-by-name` trigger and a **generated DAG**.
 - **Source control** — `init`, `clone`, `commit`, `push`, `pull`, `status` from the UI.
-- **Cloud deploy** — generated `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
-  `fly.toml`, each with its one-line deploy command.
+- **Cloud deploy** — generates `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
+  `fly.toml` (review before deploying).
 
 ### Workspace & UX
-- VS Code-style layout: activity rail, collapsible panels, status bar.
-- **All panels collapsible**, each with **independent font +/-** controls.
+- VS Code-style layout; **all panels collapsible**, each with **independent font +/-**.
 - **Responsive** — side panels auto-collapse on narrow windows.
-- **Global search (⌘K)**, **command palette (⇧⌘P)**, working top menus.
-- Integrated **Terminal**, a **Python Console** (shares the kernel), and a **file browser**
-  (works in any browser via a server-side browser).
+- Global **search**, **command palette**, integrated **terminal**, a **Python console**
+  (shares the kernel), and a **file browser** that works in any browser.
 - Dark/light themes; `.ipynb` import/export.
 
-### Data connectivity
-- DuckDB in-process SQL engine.
-- Connection scaffolding for 8 cloud warehouses (Snowflake, BigQuery, Redshift,
-  Azure Synapse, Databricks, Athena, Presto, Trino) — see [CLOUD_WAREHOUSES.md](CLOUD_WAREHOUSES.md).
-
 ---
 
 ## Architecture
@@ -152,76 +186,49 @@ Works with **local models via Ollama** (free, private, offline) or **Claude / Op
                                                 └─────────────────┘
 ```
 
-- **Backend**: Rust (Axum + Tokio). Spawns one long-lived Python process and talks to
-  it over a line-framed JSON protocol; outputs are Jupyter-style MIME bundles.
-- **Frontend**: React 18 + TypeScript + Vite, Monaco editor, Tailwind CSS.
-- **Kernel**: a single `python` process with a shared namespace; SIGINT-interruptible,
-  restartable, with matplotlib (Agg) and rich preloaded.
+- **Backend** spawns one long-lived `python` process and talks to it over a
+  line-framed JSON protocol; outputs are Jupyter-style MIME bundles, streamed live.
+- **Kernel** has a shared namespace, is SIGINT-interruptible and restartable, with
+  matplotlib (Agg) and `rich` preloaded.
 
 ---
 
-## Getting started
-
-### Prerequisites
-- **Rust** (stable) and **Node.js 18+**
-- **Python 3.8+** on your `PATH` with `ipykernel`:
-  ```bash
-  pip install ipykernel pandas matplotlib rich duckdb
-  ```
-- *(optional)* **Ollama** for local AI: https://ollama.com — then `ollama pull qwen2.5-coder`
+## Keyboard shortcuts
 
-### Run in development
-```bash
-# 1) backend (port 8000)
-cargo run
+All of these are wired:
 
-# 2) frontend (port 5173, proxies /api and /ws to the backend)
-cd frontend && npm install && npm run dev
-```
-Open http://localhost:5173.
+| Shortcut | Action |
+|---|---|
+| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
+| `⌘K` | Global search *(in a focused cell, `⌘K` is AI edit instead)* |
+| `⇧⌘P` | Command palette |
+| `⌘,` | Settings |
+| `⌘⇧↵` | Run all cells |
+| `⇧↵` | Run the focused cell |
 
-### Configure AI (optional)
-- **Local (Ollama)**: start Ollama and pick a model in the AI panel.
-- **Claude/OpenAI**: set in the AI settings, or via env:
-  ```bash
-  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
-  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
-  ```
-  Settings saved in the UI persist to `~/.prismnote/ai_config.json`.
+*(`⌘`/`Ctrl` depending on platform.)*
 
 ---
 
 ## Deploy
 
-Open **Deploy to Cloud** (rocket icon) to copy/download ready-to-use artifacts:
+Open **Deploy to Cloud** to copy/download the generated artifacts, then:
 
 ```bash
-docker compose up -d          # Docker
-kubectl apply -f k8s.yaml     # Kubernetes
-fly launch --copy-config --now# Fly.io
+docker compose up -d            # Docker
+kubectl apply -f k8s.yaml       # Kubernetes
+fly launch --copy-config --now  # Fly.io
 ```
 
 ---
 
-## Keyboard shortcuts
-
-| Shortcut | Action |
-|---|---|
-| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
-| `⌘K` | Global search |
-| `⇧⌘P` | Command palette |
-| `⌘K` *(in a cell)* | AI edit |
-| `⌘⇧⏎` | Run all cells |
-| `⇧⏎` | Run cell |
-
----
-
 ## Repository layout
 
 ```
-crates/server/      Rust backend (api, kernel, jobs, db, ws, …)
-frontend/           React app (components, hooks, api clients)
-*.md                Architecture & comparison docs
+crates/server/   Rust backend (api, kernel, jobs, db, ws, deploy, git…)
+frontend/        React app (components, hooks, api clients)
+python/          PyPI launcher package (prismnote)
+*.md             Architecture & comparison docs
 ```
 
 Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
@@ -232,8 +239,10 @@ Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
 
 ## Roadmap
 
+- Functional cloud-warehouse query execution (currently scaffolded/stubbed).
+- Prebuilt release binaries for all platforms (so `pip install` runs out of the box).
 - Distributed compute (Spark) and a catalog/data browser.
-- Real-time collaboration (live cursors/co-editing).
+- Real-time collaboration (live cursors / co-editing).
 - Notebook parameters and multi-notebook job composition.
 
 ---

prismnote-0.4.1/README.md

@@ -0,0 +1,198 @@
+<div align="center">
+
+# ◆ PrismNote
+
+**A fast, modern, open-source data-science notebook.**
+Rust engine · React UI · local-first · AI-native.
+
+**License:** MIT · **Status:** Beta (v0.4) · **PyPI:** [`prismnote`](https://pypi.org/project/prismnote/)
+
+</div>
+
+---
+
+## Overview
+
+PrismNote is a local-first alternative to Jupyter, Zeppelin, and Databricks notebooks.
+A **Rust + Axum** backend drives a **persistent Python kernel**, and a modern,
+**VS Code-style React** UI gives you Python + SQL, rich output and live charts, local
+AI assistance, scheduled jobs, git, and generated cloud-deploy files — all on your machine.
+
+- **Local-first & private** — runs locally; local AI via Ollama, no account required.
+- **Jupyter-compatible** — native `.ipynb` import/export.
+- **Batteries included** — kernel, SQL, charts, AI, jobs, git, deploy, search, terminal.
+
+> **Status note:** PrismNote is **beta**. The notebook, kernel, AI, jobs, git, and
+> charts are functional. Cloud-warehouse connectors are **scaffolding** (query results
+> are currently stubbed), and deployment files are **generated templates** you review
+> before shipping. See the [roadmap](#roadmap).
+
+---
+
+## Install & run
+
+### From source (recommended today)
+Requires **Rust** (stable), **Node 18+**, and **Python 3.8+** on `PATH`:
+
+```bash
+# Python runtime deps for the kernel (ipykernel is required; the rest enable
+# rich output, %sql, and charts)
+pip install ipykernel pandas matplotlib rich duckdb
+
+# 1) backend — http://localhost:8000
+cargo run
+
+# 2) frontend — http://localhost:5173 (proxies /api and /ws to the backend)
+cd frontend && npm install && npm run dev
+```
+Open http://localhost:5173.
+
+### From PyPI
+```bash
+pip install prismnote
+prismnote
+```
+The PyPI package is a thin launcher: on first run it downloads the prebuilt server
+binary for your platform from the matching **GitHub Release** (`vX.Y.Z`). If a release
+binary isn't published for your platform/version yet, use the from-source steps above.
+(`pip install prismnote` succeeds regardless; only the prebuilt launch depends on a release.)
+
+### Enable AI (optional)
+- **Local, free, private — Ollama:** install from https://ollama.com, then
+  `ollama pull qwen2.5-coder`. The UI talks to Ollama from the browser, so allow the
+  dev origin once:
+  ```bash
+  OLLAMA_ORIGINS=http://localhost:5173 ollama serve
+  ```
+- **Claude / OpenAI:** set it in AI settings, or via env (persisted to
+  `~/.prismnote/ai_config.json`):
+  ```bash
+  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
+  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
+  ```
+
+---
+
+## Features
+
+### Notebook & execution
+- **Persistent shared kernel** — variables/imports/functions from one cell are
+  available in later cells.
+- **Per-cell interpreters (magics):** `%python` (default), `%sql` (in-process DuckDB;
+  can query DataFrames from other cells — needs `pip install duckdb`), `%sh` / `!cmd`
+  (shell), `%md` (rendered markdown).
+- **Rich output** — text, HTML, matplotlib figures, and pandas DataFrames.
+- **Chart switcher** — view any DataFrame as **Table / Bar / Line**.
+- **Live streamed output** over WebSocket while a cell runs.
+- **Interrupt** a running cell and **restart** the kernel.
+- **Dynamic input widgets** — `prism.input / slider / select / checkbox` re-run the
+  cell when changed.
+
+### AI assistance
+Local models via **Ollama**, or **Claude / OpenAI**.
+- **In-cell AI edit** (diff accept/reject), **Fix with AI** on errors, **Explain**.
+- **Inline autocomplete** (ghost text) when Ollama is connected.
+- **Teacher persona** — explanations of the "why" plus a contextual tip.
+- **Agent panel** — Plan/Act assistant that proposes and applies cell edits.
+
+### Errors that help
+- **Natural-language explanations** for common Python errors.
+- **In-editor markers** on the offending line/column, with a collapsible traceback.
+
+### Workflow
+- **Jobs** — save a whole notebook and run it as a unit: **manual / interval / daily**,
+  with status + run history.
+- **Airflow** — a stable `run-by-name` trigger and a **generated DAG**.
+- **Source control** — `init`, `clone`, `commit`, `push`, `pull`, `status` from the UI.
+- **Cloud deploy** — generates `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
+  `fly.toml` (review before deploying).
+
+### Workspace & UX
+- VS Code-style layout; **all panels collapsible**, each with **independent font +/-**.
+- **Responsive** — side panels auto-collapse on narrow windows.
+- Global **search**, **command palette**, integrated **terminal**, a **Python console**
+  (shares the kernel), and a **file browser** that works in any browser.
+- Dark/light themes; `.ipynb` import/export.
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────┐        ┌─────────────────────────────┐
+│  React + TypeScript (Vite)   │  HTTP  │      Rust backend (Axum)    │
+│  Monaco · Tailwind · zustand │ ─────▶ │  REST API + WebSocket       │
+│  cells · panels · AI · jobs  │ ◀───── │  routing, jobs, git, deploy │
+└──────────────────────────────┘   WS   └──────────────┬──────────────┘
+                                                        │ stdin/stdout (JSON)
+                                                ┌───────▼────────┐
+                                                │ Persistent      │
+                                                │ Python kernel   │
+                                                │ (shared globals)│
+                                                └─────────────────┘
+```
+
+- **Backend** spawns one long-lived `python` process and talks to it over a
+  line-framed JSON protocol; outputs are Jupyter-style MIME bundles, streamed live.
+- **Kernel** has a shared namespace, is SIGINT-interruptible and restartable, with
+  matplotlib (Agg) and `rich` preloaded.
+
+---
+
+## Keyboard shortcuts
+
+All of these are wired:
+
+| Shortcut | Action |
+|---|---|
+| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
+| `⌘K` | Global search *(in a focused cell, `⌘K` is AI edit instead)* |
+| `⇧⌘P` | Command palette |
+| `⌘,` | Settings |
+| `⌘⇧↵` | Run all cells |
+| `⇧↵` | Run the focused cell |
+
+*(`⌘`/`Ctrl` depending on platform.)*
+
+---
+
+## Deploy
+
+Open **Deploy to Cloud** to copy/download the generated artifacts, then:
+
+```bash
+docker compose up -d            # Docker
+kubectl apply -f k8s.yaml       # Kubernetes
+fly launch --copy-config --now  # Fly.io
+```
+
+---
+
+## Repository layout
+
+```
+crates/server/   Rust backend (api, kernel, jobs, db, ws, deploy, git…)
+frontend/        React app (components, hooks, api clients)
+python/          PyPI launcher package (prismnote)
+*.md             Architecture & comparison docs
+```
+
+Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
+[DATABRICKS_COMPARISON.md](DATABRICKS_COMPARISON.md) ·
+[NOTEBOOK_COMPARISON_MATRIX.md](NOTEBOOK_COMPARISON_MATRIX.md)
+
+---
+
+## Roadmap
+
+- Functional cloud-warehouse query execution (currently scaffolded/stubbed).
+- Prebuilt release binaries for all platforms (so `pip install` runs out of the box).
+- Distributed compute (Spark) and a catalog/data browser.
+- Real-time collaboration (live cursors / co-editing).
+- Notebook parameters and multi-notebook job composition.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{prismnote-0.4.0 → prismnote-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "prismnote"
-version = "0.4.0"
+version = "0.4.1"
 description = "Modern, open-source Jupyter-compatible data science notebook with Rust performance"
 readme = "README.md"
 license = { text = "MIT" }

{prismnote-0.4.0 → prismnote-0.4.1}/python/prismnote/__init__.py

@@ -1,3 +1,3 @@
 """PrismNote - A modern data science notebook."""
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

{prismnote-0.4.0 → prismnote-0.4.1}/python/prismnote/_cli.py

@@ -15,7 +15,7 @@ import platform
 import urllib.request
 from pathlib import Path
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
 GITHUB_REPO = "Mullassery/prismnote"
 CACHE_DIR = Path.home() / ".prismnote" / "bin"

{prismnote-0.4.0 → prismnote-0.4.1/python/prismnote.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prismnote
-Version: 0.4.0
+Version: 0.4.1
 Summary: Modern, open-source Jupyter-compatible data science notebook with Rust performance
 Author-email: Georgi Mammen Mullassery <mullassery@gmail.com>
 License: MIT
@@ -59,7 +59,7 @@ Dynamic: license-file
 **A fast, modern, open-source data-science notebook.**
 Rust engine · React UI · local-first · AI-native.
 
-**License:** MIT · **Status:** Beta (v0.4)
+**License:** MIT · **Status:** Beta (v0.4) · **PyPI:** [`prismnote`](https://pypi.org/project/prismnote/)
 
 </div>
 
@@ -68,72 +68,106 @@ Rust engine · React UI · local-first · AI-native.
 ## Overview
 
 PrismNote is a local-first alternative to Jupyter, Zeppelin, and Databricks notebooks.
-It pairs a **Rust + Axum** backend and a **persistent Python kernel** with a modern,
-**VS Code-style React** interface. Write Python and SQL, get rich output and live
-charts, ask a local AI for help, schedule notebooks as jobs, manage git, and ship to
-the cloud — all from one app that runs entirely on your machine.
+A **Rust + Axum** backend drives a **persistent Python kernel**, and a modern,
+**VS Code-style React** UI gives you Python + SQL, rich output and live charts, local
+AI assistance, scheduled jobs, git, and generated cloud-deploy files — all on your machine.
 
-- **Local-first & private** — runs on your machine; local AI via Ollama, no account required.
-- **Jupyter-compatible** — native `.ipynb` format.
+- **Local-first & private** — runs locally; local AI via Ollama, no account required.
+- **Jupyter-compatible** — native `.ipynb` import/export.
 - **Batteries included** — kernel, SQL, charts, AI, jobs, git, deploy, search, terminal.
 
+> **Status note:** PrismNote is **beta**. The notebook, kernel, AI, jobs, git, and
+> charts are functional. Cloud-warehouse connectors are **scaffolding** (query results
+> are currently stubbed), and deployment files are **generated templates** you review
+> before shipping. See the [roadmap](#roadmap).
+
+---
+
+## Install & run
+
+### From source (recommended today)
+Requires **Rust** (stable), **Node 18+**, and **Python 3.8+** on `PATH`:
+
+```bash
+# Python runtime deps for the kernel (ipykernel is required; the rest enable
+# rich output, %sql, and charts)
+pip install ipykernel pandas matplotlib rich duckdb
+
+# 1) backend — http://localhost:8000
+cargo run
+
+# 2) frontend — http://localhost:5173 (proxies /api and /ws to the backend)
+cd frontend && npm install && npm run dev
+```
+Open http://localhost:5173.
+
+### From PyPI
+```bash
+pip install prismnote
+prismnote
+```
+The PyPI package is a thin launcher: on first run it downloads the prebuilt server
+binary for your platform from the matching **GitHub Release** (`vX.Y.Z`). If a release
+binary isn't published for your platform/version yet, use the from-source steps above.
+(`pip install prismnote` succeeds regardless; only the prebuilt launch depends on a release.)
+
+### Enable AI (optional)
+- **Local, free, private — Ollama:** install from https://ollama.com, then
+  `ollama pull qwen2.5-coder`. The UI talks to Ollama from the browser, so allow the
+  dev origin once:
+  ```bash
+  OLLAMA_ORIGINS=http://localhost:5173 ollama serve
+  ```
+- **Claude / OpenAI:** set it in AI settings, or via env (persisted to
+  `~/.prismnote/ai_config.json`):
+  ```bash
+  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
+  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
+  ```
+
 ---
 
 ## Features
 
 ### Notebook & execution
-- **Persistent shared kernel** — variables, imports, and functions defined in one cell
-  are available in every later cell (true notebook semantics).
-- **Per-cell interpreters (magics)**:
-  - `%python` (default) — runs in the shared kernel.
-  - `%sql` — in-process **DuckDB**; can query pandas DataFrames defined in other cells.
-  - `%sh` / `%bash` / `!cmd` — shell commands.
-  - `%md` / `%markdown` — rendered markdown.
-- **Rich output** — text, HTML, matplotlib figures (`image/png`), and pandas DataFrames.
-- **Chart switcher** — view any DataFrame as a **Table, Bar, or Line** chart.
+- **Persistent shared kernel** — variables/imports/functions from one cell are
+  available in later cells.
+- **Per-cell interpreters (magics):** `%python` (default), `%sql` (in-process DuckDB;
+  can query DataFrames from other cells — needs `pip install duckdb`), `%sh` / `!cmd`
+  (shell), `%md` (rendered markdown).
+- **Rich output** — text, HTML, matplotlib figures, and pandas DataFrames.
+- **Chart switcher** — view any DataFrame as **Table / Bar / Line**.
 - **Live streamed output** over WebSocket while a cell runs.
-- **Interrupt** a running cell (Stop) and **restart** the kernel from the toolbar/menu.
-- **Dynamic input widgets** — `prism.input / slider / select / checkbox` render controls
-  that re-run the cell when changed (Databricks `dbutils.widgets`-style).
-- Pretty-printing enabled by default via `rich`.
+- **Interrupt** a running cell and **restart** the kernel.
+- **Dynamic input widgets** — `prism.input / slider / select / checkbox` re-run the
+  cell when changed.
 
 ### AI assistance
-Works with **local models via Ollama** (free, private, offline) or **Claude / OpenAI**.
-- **⌘K in-cell edit** — describe a change, review a diff, accept or reject.
-- **Fix with AI** — one click on an errored cell.
-- **Explain** — a teaching-oriented explanation with a contextual tip.
-- **Inline autocomplete** — ghost-text completions when Ollama is connected.
-- **Teacher persona** — any model explains the "why" and suggests tips/tricks.
-- **Agent panel** — Plan/Act assistant that can propose and apply cell edits.
+Local models via **Ollama**, or **Claude / OpenAI**.
+- **In-cell AI edit** (diff accept/reject), **Fix with AI** on errors, **Explain**.
+- **Inline autocomplete** (ghost text) when Ollama is connected.
+- **Teacher persona** — explanations of the "why" plus a contextual tip.
+- **Agent panel** — Plan/Act assistant that proposes and applies cell edits.
 
 ### Errors that help
-- **Natural-language explanations** for common Python errors (NameError, KeyError,
-  ModuleNotFoundError, TypeError, ZeroDivisionError, SyntaxError, …).
-- **In-editor markers** highlighting the offending **line and column**.
-- Collapsible full traceback when you want the details.
-
-### Workflow: Jobs, Airflow, Git, Deploy
-- **Jobs** — save a whole notebook and run it as a unit, **manual / interval / daily**,
-  with status and run history (Airflow-style).
-- **Airflow** — a stable `run-by-name` trigger plus a **generated, ready-to-use DAG**.
+- **Natural-language explanations** for common Python errors.
+- **In-editor markers** on the offending line/column, with a collapsible traceback.
+
+### Workflow
+- **Jobs** — save a whole notebook and run it as a unit: **manual / interval / daily**,
+  with status + run history.
+- **Airflow** — a stable `run-by-name` trigger and a **generated DAG**.
 - **Source control** — `init`, `clone`, `commit`, `push`, `pull`, `status` from the UI.
-- **Cloud deploy** — generated `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
-  `fly.toml`, each with its one-line deploy command.
+- **Cloud deploy** — generates `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
+  `fly.toml` (review before deploying).
 
 ### Workspace & UX
-- VS Code-style layout: activity rail, collapsible panels, status bar.
-- **All panels collapsible**, each with **independent font +/-** controls.
+- VS Code-style layout; **all panels collapsible**, each with **independent font +/-**.
 - **Responsive** — side panels auto-collapse on narrow windows.
-- **Global search (⌘K)**, **command palette (⇧⌘P)**, working top menus.
-- Integrated **Terminal**, a **Python Console** (shares the kernel), and a **file browser**
-  (works in any browser via a server-side browser).
+- Global **search**, **command palette**, integrated **terminal**, a **Python console**
+  (shares the kernel), and a **file browser** that works in any browser.
 - Dark/light themes; `.ipynb` import/export.
 
-### Data connectivity
-- DuckDB in-process SQL engine.
-- Connection scaffolding for 8 cloud warehouses (Snowflake, BigQuery, Redshift,
-  Azure Synapse, Databricks, Athena, Presto, Trino) — see [CLOUD_WAREHOUSES.md](CLOUD_WAREHOUSES.md).
-
 ---
 
 ## Architecture
@@ -152,76 +186,49 @@ Works with **local models via Ollama** (free, private, offline) or **Claude / Op
                                                 └─────────────────┘
 ```
 
-- **Backend**: Rust (Axum + Tokio). Spawns one long-lived Python process and talks to
-  it over a line-framed JSON protocol; outputs are Jupyter-style MIME bundles.
-- **Frontend**: React 18 + TypeScript + Vite, Monaco editor, Tailwind CSS.
-- **Kernel**: a single `python` process with a shared namespace; SIGINT-interruptible,
-  restartable, with matplotlib (Agg) and rich preloaded.
+- **Backend** spawns one long-lived `python` process and talks to it over a
+  line-framed JSON protocol; outputs are Jupyter-style MIME bundles, streamed live.
+- **Kernel** has a shared namespace, is SIGINT-interruptible and restartable, with
+  matplotlib (Agg) and `rich` preloaded.
 
 ---
 
-## Getting started
-
-### Prerequisites
-- **Rust** (stable) and **Node.js 18+**
-- **Python 3.8+** on your `PATH` with `ipykernel`:
-  ```bash
-  pip install ipykernel pandas matplotlib rich duckdb
-  ```
-- *(optional)* **Ollama** for local AI: https://ollama.com — then `ollama pull qwen2.5-coder`
+## Keyboard shortcuts
 
-### Run in development
-```bash
-# 1) backend (port 8000)
-cargo run
+All of these are wired:
 
-# 2) frontend (port 5173, proxies /api and /ws to the backend)
-cd frontend && npm install && npm run dev
-```
-Open http://localhost:5173.
+| Shortcut | Action |
+|---|---|
+| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
+| `⌘K` | Global search *(in a focused cell, `⌘K` is AI edit instead)* |
+| `⇧⌘P` | Command palette |
+| `⌘,` | Settings |
+| `⌘⇧↵` | Run all cells |
+| `⇧↵` | Run the focused cell |
 
-### Configure AI (optional)
-- **Local (Ollama)**: start Ollama and pick a model in the AI panel.
-- **Claude/OpenAI**: set in the AI settings, or via env:
-  ```bash
-  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
-  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
-  ```
-  Settings saved in the UI persist to `~/.prismnote/ai_config.json`.
+*(`⌘`/`Ctrl` depending on platform.)*
 
 ---
 
 ## Deploy
 
-Open **Deploy to Cloud** (rocket icon) to copy/download ready-to-use artifacts:
+Open **Deploy to Cloud** to copy/download the generated artifacts, then:
 
 ```bash
-docker compose up -d          # Docker
-kubectl apply -f k8s.yaml     # Kubernetes
-fly launch --copy-config --now# Fly.io
+docker compose up -d            # Docker
+kubectl apply -f k8s.yaml       # Kubernetes
+fly launch --copy-config --now  # Fly.io
 ```
 
 ---
 
-## Keyboard shortcuts
-
-| Shortcut | Action |
-|---|---|
-| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
-| `⌘K` | Global search |
-| `⇧⌘P` | Command palette |
-| `⌘K` *(in a cell)* | AI edit |
-| `⌘⇧⏎` | Run all cells |
-| `⇧⏎` | Run cell |
-
----
-
 ## Repository layout
 
 ```
-crates/server/      Rust backend (api, kernel, jobs, db, ws, …)
-frontend/           React app (components, hooks, api clients)
-*.md                Architecture & comparison docs
+crates/server/   Rust backend (api, kernel, jobs, db, ws, deploy, git…)
+frontend/        React app (components, hooks, api clients)
+python/          PyPI launcher package (prismnote)
+*.md             Architecture & comparison docs
 ```
 
 Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
@@ -232,8 +239,10 @@ Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
 
 ## Roadmap
 
+- Functional cloud-warehouse query execution (currently scaffolded/stubbed).
+- Prebuilt release binaries for all platforms (so `pip install` runs out of the box).
 - Distributed compute (Spark) and a catalog/data browser.
-- Real-time collaboration (live cursors/co-editing).
+- Real-time collaboration (live cursors / co-editing).
 - Notebook parameters and multi-notebook job composition.
 
 ---

prismnote-0.4.0/README.md

@@ -1,189 +0,0 @@
-<div align="center">
-
-# ◆ PrismNote
-
-**A fast, modern, open-source data-science notebook.**
-Rust engine · React UI · local-first · AI-native.
-
-**License:** MIT · **Status:** Beta (v0.4)
-
-</div>
-
----
-
-## Overview
-
-PrismNote is a local-first alternative to Jupyter, Zeppelin, and Databricks notebooks.
-It pairs a **Rust + Axum** backend and a **persistent Python kernel** with a modern,
-**VS Code-style React** interface. Write Python and SQL, get rich output and live
-charts, ask a local AI for help, schedule notebooks as jobs, manage git, and ship to
-the cloud — all from one app that runs entirely on your machine.
-
-- **Local-first & private** — runs on your machine; local AI via Ollama, no account required.
-- **Jupyter-compatible** — native `.ipynb` format.
-- **Batteries included** — kernel, SQL, charts, AI, jobs, git, deploy, search, terminal.
-
----
-
-## Features
-
-### Notebook & execution
-- **Persistent shared kernel** — variables, imports, and functions defined in one cell
-  are available in every later cell (true notebook semantics).
-- **Per-cell interpreters (magics)**:
-  - `%python` (default) — runs in the shared kernel.
-  - `%sql` — in-process **DuckDB**; can query pandas DataFrames defined in other cells.
-  - `%sh` / `%bash` / `!cmd` — shell commands.
-  - `%md` / `%markdown` — rendered markdown.
-- **Rich output** — text, HTML, matplotlib figures (`image/png`), and pandas DataFrames.
-- **Chart switcher** — view any DataFrame as a **Table, Bar, or Line** chart.
-- **Live streamed output** over WebSocket while a cell runs.
-- **Interrupt** a running cell (Stop) and **restart** the kernel from the toolbar/menu.
-- **Dynamic input widgets** — `prism.input / slider / select / checkbox` render controls
-  that re-run the cell when changed (Databricks `dbutils.widgets`-style).
-- Pretty-printing enabled by default via `rich`.
-
-### AI assistance
-Works with **local models via Ollama** (free, private, offline) or **Claude / OpenAI**.
-- **⌘K in-cell edit** — describe a change, review a diff, accept or reject.
-- **Fix with AI** — one click on an errored cell.
-- **Explain** — a teaching-oriented explanation with a contextual tip.
-- **Inline autocomplete** — ghost-text completions when Ollama is connected.
-- **Teacher persona** — any model explains the "why" and suggests tips/tricks.
-- **Agent panel** — Plan/Act assistant that can propose and apply cell edits.
-
-### Errors that help
-- **Natural-language explanations** for common Python errors (NameError, KeyError,
-  ModuleNotFoundError, TypeError, ZeroDivisionError, SyntaxError, …).
-- **In-editor markers** highlighting the offending **line and column**.
-- Collapsible full traceback when you want the details.
-
-### Workflow: Jobs, Airflow, Git, Deploy
-- **Jobs** — save a whole notebook and run it as a unit, **manual / interval / daily**,
-  with status and run history (Airflow-style).
-- **Airflow** — a stable `run-by-name` trigger plus a **generated, ready-to-use DAG**.
-- **Source control** — `init`, `clone`, `commit`, `push`, `pull`, `status` from the UI.
-- **Cloud deploy** — generated `Dockerfile`, `docker-compose.yml`, `k8s.yaml`, and
-  `fly.toml`, each with its one-line deploy command.
-
-### Workspace & UX
-- VS Code-style layout: activity rail, collapsible panels, status bar.
-- **All panels collapsible**, each with **independent font +/-** controls.
-- **Responsive** — side panels auto-collapse on narrow windows.
-- **Global search (⌘K)**, **command palette (⇧⌘P)**, working top menus.
-- Integrated **Terminal**, a **Python Console** (shares the kernel), and a **file browser**
-  (works in any browser via a server-side browser).
-- Dark/light themes; `.ipynb` import/export.
-
-### Data connectivity
-- DuckDB in-process SQL engine.
-- Connection scaffolding for 8 cloud warehouses (Snowflake, BigQuery, Redshift,
-  Azure Synapse, Databricks, Athena, Presto, Trino) — see [CLOUD_WAREHOUSES.md](CLOUD_WAREHOUSES.md).
-
----
-
-## Architecture
-
-```
-┌──────────────────────────────┐        ┌─────────────────────────────┐
-│  React + TypeScript (Vite)   │  HTTP  │      Rust backend (Axum)    │
-│  Monaco · Tailwind · zustand │ ─────▶ │  REST API + WebSocket       │
-│  cells · panels · AI · jobs  │ ◀───── │  routing, jobs, git, deploy │
-└──────────────────────────────┘   WS   └──────────────┬──────────────┘
-                                                        │ stdin/stdout (JSON)
-                                                ┌───────▼────────┐
-                                                │ Persistent      │
-                                                │ Python kernel   │
-                                                │ (shared globals)│
-                                                └─────────────────┘
-```
-
-- **Backend**: Rust (Axum + Tokio). Spawns one long-lived Python process and talks to
-  it over a line-framed JSON protocol; outputs are Jupyter-style MIME bundles.
-- **Frontend**: React 18 + TypeScript + Vite, Monaco editor, Tailwind CSS.
-- **Kernel**: a single `python` process with a shared namespace; SIGINT-interruptible,
-  restartable, with matplotlib (Agg) and rich preloaded.
-
----
-
-## Getting started
-
-### Prerequisites
-- **Rust** (stable) and **Node.js 18+**
-- **Python 3.8+** on your `PATH` with `ipykernel`:
-  ```bash
-  pip install ipykernel pandas matplotlib rich duckdb
-  ```
-- *(optional)* **Ollama** for local AI: https://ollama.com — then `ollama pull qwen2.5-coder`
-
-### Run in development
-```bash
-# 1) backend (port 8000)
-cargo run
-
-# 2) frontend (port 5173, proxies /api and /ws to the backend)
-cd frontend && npm install && npm run dev
-```
-Open http://localhost:5173.
-
-### Configure AI (optional)
-- **Local (Ollama)**: start Ollama and pick a model in the AI panel.
-- **Claude/OpenAI**: set in the AI settings, or via env:
-  ```bash
-  export PRISMNOTE_AI_PROVIDER=claude   # or openai / ollama
-  export ANTHROPIC_API_KEY=...          # or OPENAI_API_KEY
-  ```
-  Settings saved in the UI persist to `~/.prismnote/ai_config.json`.
-
----
-
-## Deploy
-
-Open **Deploy to Cloud** (rocket icon) to copy/download ready-to-use artifacts:
-
-```bash
-docker compose up -d          # Docker
-kubectl apply -f k8s.yaml     # Kubernetes
-fly launch --copy-config --now# Fly.io
-```
-
----
-
-## Keyboard shortcuts
-
-| Shortcut | Action |
-|---|---|
-| `⌘N` / `⌘O` / `⌘S` | New / Open / Save notebook |
-| `⌘K` | Global search |
-| `⇧⌘P` | Command palette |
-| `⌘K` *(in a cell)* | AI edit |
-| `⌘⇧⏎` | Run all cells |
-| `⇧⏎` | Run cell |
-
----
-
-## Repository layout
-
-```
-crates/server/      Rust backend (api, kernel, jobs, db, ws, …)
-frontend/           React app (components, hooks, api clients)
-*.md                Architecture & comparison docs
-```
-
-Comparisons: [ZEPPELIN_COMPARISON.md](ZEPPELIN_COMPARISON.md) ·
-[DATABRICKS_COMPARISON.md](DATABRICKS_COMPARISON.md) ·
-[NOTEBOOK_COMPARISON_MATRIX.md](NOTEBOOK_COMPARISON_MATRIX.md)
-
----
-
-## Roadmap
-
-- Distributed compute (Spark) and a catalog/data browser.
-- Real-time collaboration (live cursors/co-editing).
-- Notebook parameters and multi-notebook job composition.
-
----
-
-## License
-
-MIT — see [LICENSE](LICENSE).