prismnote 0.4.0__tar.gz → 0.4.2__tar.gz

prismnote-0.4.2/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: prismnote
+Version: 0.4.2
+Summary: Modern, open-source Jupyter-compatible data science notebook with Rust performance
+Author-email: Georgi Mammen Mullassery <mullassery@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Mullassery/prismnote
+Project-URL: Repository, https://github.com/Mullassery/prismnote
+Project-URL: Documentation, https://github.com/Mullassery/prismnote#readme
+Project-URL: Bug Tracker, https://github.com/Mullassery/prismnote/issues
+Keywords: notebook,jupyter,data-science,sql,python,rust
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Environment :: Web Environment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ipykernel>=6.0
+Requires-Dist: jupyter>=1.0
+Provides-Extra: sql
+Requires-Dist: duckdb>=0.9; extra == "sql"
+Requires-Dist: pg8000>=1.30; extra == "sql"
+Requires-Dist: pymysql>=1.0; extra == "sql"
+Provides-Extra: postgres
+Requires-Dist: pg8000>=1.30; extra == "postgres"
+Provides-Extra: mysql
+Requires-Dist: pymysql>=1.0; extra == "mysql"
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=0.9; extra == "duckdb"
+Provides-Extra: cloud
+Requires-Dist: snowflake-connector-python[pandas]>=3.0; extra == "cloud"
+Requires-Dist: google-cloud-bigquery>=3.0; extra == "cloud"
+Requires-Dist: db-dtypes>=1.0; extra == "cloud"
+Requires-Dist: redshift_connector>=2.0; extra == "cloud"
+Requires-Dist: databricks-sql-connector>=2.0; extra == "cloud"
+Requires-Dist: pyathena>=3.0; extra == "cloud"
+Requires-Dist: trino>=0.328; extra == "cloud"
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.7; extra == "ai"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+Provides-Extra: spark
+Requires-Dist: pyspark>=3.0; extra == "spark"
+Requires-Dist: pyarrow>=10; extra == "spark"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+<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.2/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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "prismnote"
-version = "0.4.0"
+version = "0.4.2"
 description = "Modern, open-source Jupyter-compatible data science notebook with Rust performance"
 readme = "README.md"
 license = { text = "MIT" }
@@ -32,17 +32,21 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-# Database support
-sql = ["psycopg2-binary>=2.9", "pymysql>=1.0"]
-postgres = ["psycopg2-binary>=2.9"]
-mysql = ["pymysql>=1.0"]
+# Database support — permissively-licensed (OSS) drivers only. See CONNECTORS.md.
+sql = ["duckdb>=0.9", "pg8000>=1.30", "pymysql>=1.0"]   # MIT / BSD / MIT
+postgres = ["pg8000>=1.30"]                              # BSD (pure-Python)
+mysql = ["pymysql>=1.0"]                                 # MIT
+duckdb = ["duckdb>=0.9"]                                 # MIT
 
-# Cloud warehouses
+# Cloud warehouses — official open-source clients (Apache-2.0 / MIT)
 cloud = [
-    "snowflake-connector-python>=3.0",
-    "google-cloud-bigquery>=3.0",
-    "amazon-redshift-python-driver>=1.0",
-    "databricks-sql-connector>=1.0",
+    "snowflake-connector-python[pandas]>=3.0",  # Apache-2.0
+    "google-cloud-bigquery>=3.0",               # Apache-2.0
+    "db-dtypes>=1.0",                            # Apache-2.0 (BigQuery -> pandas)
+    "redshift_connector>=2.0",                  # Apache-2.0
+    "databricks-sql-connector>=2.0",            # Apache-2.0
+    "pyathena>=3.0",                            # MIT
+    "trino>=0.328",                            # Apache-2.0
 ]
 
 # AI features

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

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

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

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