zaturn 0.1.0__tar.gz → 0.1.2__tar.gz

zaturn-0.1.2/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Project Related
+sample_dbs/
+localtests.py

{zaturn-0.1.0/zaturn.egg-info → zaturn-0.1.2}/PKG-INFO

@@ -1,11 +1,10 @@
 Metadata-Version: 2.4
 Name: zaturn
-Version: 0.1.0
+Version: 0.1.2
 Summary: AI Data Analysis MCP
 Author-email: Karthik Devan <krtdvn@gmail.com>
 Maintainer-email: Karthik Devan <krtdvn@gmail.com>
 Project-URL: Homepage, https://github.com/kdqed/zaturn
-Project-URL: Changelog, https://github.com/kdqed/zaturn/releases
 Project-URL: Issues, https://github.com/kdqed/zaturn/issues
 Project-URL: CI, https://github.com/kdqed/zaturn/actions
 Requires-Python: >=3.11
@@ -21,12 +20,13 @@ Requires-Dist: pyarrow>=19.0.1
 Requires-Dist: pymysql>=1.1.1
 Requires-Dist: python-lsp-server>=1.12.2
 Requires-Dist: seaborn>=0.13.2
+Requires-Dist: setuptools>=78.1.0
 Requires-Dist: sqlalchemy>=2.0.40
 Requires-Dist: tabulate>=0.9.0
 Dynamic: license-file
 
 <p align="center">
-  <img src="brand/logo.png" width="128" height="128">
+  <img src="https://github.com/kdqed/zaturn/raw/main/brand/logo.png" width="128" height="128">
 </p>
 
 # Zaturn: Your Co-Pilot For Data Analytics & BI
@@ -68,23 +68,19 @@ Using an MCP like Zaturn will keep your data where it is, and enable AI to draft
 ## Installation & Setup
 1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/#installation-methods)
 
-2. Clone/Download this repository:
+2. Install [Zaturn](https://pypi.org/project/zaturn/) with uv:
 ```bash
-$ git clone https://github.com/kdqed/zaturn.git
+uv tool install zaturn
 ```
 
 3. Add to MCP config, with data sources:
 ```json
 "mcpServers": {
   "zaturn": {
-    "command": "uv",
+    "command": "zaturn_mcp",
     "args": [
-      "run",
-      "--directory",
-      "/path/to/downloaded/folder",
-      "mcp_server.py",
-      "mysql+pymysql://username:password@host:3306/dbname",
       "postgresql://username:password@host:port/dbname",
+      "mysql+pymysql://username:password@host:3306/dbname",
       "sqlite:////full/path/to/sample_dbs/northwind.db",
       "/full/path/to/sample_dbs/titanic.parquet",
       "/full/path/to/sample_dbs/ny_aq.csv",
@@ -94,10 +90,22 @@ $ git clone https://github.com/kdqed/zaturn.git
 }
 ```
 
-If your MCP client does not support images, add the `--noimg` flag after `mcp_server.py`:
+OR add a `sources.txt` to the Zaturn config directory:
+```
+postgresql://username:password@host:port/dbname
+mysql+pymysql://username:password@host:3306/dbname
+sqlite:////full/path/to/sample_dbs/northwind.db
+/full/path/to/sample_dbs/titanic.parquet
+/full/path/to/sample_dbs/ny_aq.csv
+/full/path/to/sample_dbs/duckdb_sample.duckdb
+```
+
+This file needs to be at `~/.config/zaturn/sources.txt` on Linux/MacOS and at `%APPDATA%\zaturn\sources.txt` on Windows.
+
+If your MCP client does not support image rendering, add the `--noimg` argument:
 ```json
 ...
-      "mcp_server.py",
+    "args": [
       "--noimg",
       "mysql+pymysql://username:password@host:3306/dbname",
 ...
@@ -113,10 +121,6 @@ You are a helpful data analysis assistant. Use only the tool provided data sourc
 ```
 User: List the top 5 customers by revenue for Northwind
 AI: 
-[04/08/25 15:16:47] INFO     Processing request of type ListToolsRequest                                     server.py:534
-[04/08/25 15:16:51] INFO     Processing request of type CallToolRequest                                      server.py:534
-[04/08/25 15:16:53] INFO     Processing request of type CallToolRequest                                      server.py:534
-[04/08/25 15:16:55] INFO     Processing request of type CallToolRequest                                      server.py:534
 The top 5 customers by revenue for Northwind are:
 
 1. B's Beverages with a revenue of $6,154,115.34
@@ -150,4 +154,4 @@ If you have any specific requirements please feel free to raise an issue.
 
 ## Example Dataset Credits
 
-THe [pokemon dataset compiled by Sarah Taha and PokéAPI](https://www.kaggle.com/datasets/sarahtaha/1025-pokemon) has been included under the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license.
+The [pokemon dataset compiled by Sarah Taha and PokéAPI](https://www.kaggle.com/datasets/sarahtaha/1025-pokemon) has been included under the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license for demonstration purposes.

{zaturn-0.1.0 → zaturn-0.1.2}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="brand/logo.png" width="128" height="128">
+  <img src="https://github.com/kdqed/zaturn/raw/main/brand/logo.png" width="128" height="128">
 </p>
 
 # Zaturn: Your Co-Pilot For Data Analytics & BI
@@ -41,23 +41,19 @@ Using an MCP like Zaturn will keep your data where it is, and enable AI to draft
 ## Installation & Setup
 1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/#installation-methods)
 
-2. Clone/Download this repository:
+2. Install [Zaturn](https://pypi.org/project/zaturn/) with uv:
 ```bash
-$ git clone https://github.com/kdqed/zaturn.git
+uv tool install zaturn
 ```
 
 3. Add to MCP config, with data sources:
 ```json
 "mcpServers": {
   "zaturn": {
-    "command": "uv",
+    "command": "zaturn_mcp",
     "args": [
-      "run",
-      "--directory",
-      "/path/to/downloaded/folder",
-      "mcp_server.py",
-      "mysql+pymysql://username:password@host:3306/dbname",
       "postgresql://username:password@host:port/dbname",
+      "mysql+pymysql://username:password@host:3306/dbname",
       "sqlite:////full/path/to/sample_dbs/northwind.db",
       "/full/path/to/sample_dbs/titanic.parquet",
       "/full/path/to/sample_dbs/ny_aq.csv",
@@ -67,10 +63,22 @@ $ git clone https://github.com/kdqed/zaturn.git
 }
 ```
 
-If your MCP client does not support images, add the `--noimg` flag after `mcp_server.py`:
+OR add a `sources.txt` to the Zaturn config directory:
+```
+postgresql://username:password@host:port/dbname
+mysql+pymysql://username:password@host:3306/dbname
+sqlite:////full/path/to/sample_dbs/northwind.db
+/full/path/to/sample_dbs/titanic.parquet
+/full/path/to/sample_dbs/ny_aq.csv
+/full/path/to/sample_dbs/duckdb_sample.duckdb
+```
+
+This file needs to be at `~/.config/zaturn/sources.txt` on Linux/MacOS and at `%APPDATA%\zaturn\sources.txt` on Windows.
+
+If your MCP client does not support image rendering, add the `--noimg` argument:
 ```json
 ...
-      "mcp_server.py",
+    "args": [
       "--noimg",
       "mysql+pymysql://username:password@host:3306/dbname",
 ...
@@ -86,10 +94,6 @@ You are a helpful data analysis assistant. Use only the tool provided data sourc
 ```
 User: List the top 5 customers by revenue for Northwind
 AI: 
-[04/08/25 15:16:47] INFO     Processing request of type ListToolsRequest                                     server.py:534
-[04/08/25 15:16:51] INFO     Processing request of type CallToolRequest                                      server.py:534
-[04/08/25 15:16:53] INFO     Processing request of type CallToolRequest                                      server.py:534
-[04/08/25 15:16:55] INFO     Processing request of type CallToolRequest                                      server.py:534
 The top 5 customers by revenue for Northwind are:
 
 1. B's Beverages with a revenue of $6,154,115.34
@@ -123,4 +127,4 @@ If you have any specific requirements please feel free to raise an issue.
 
 ## Example Dataset Credits
 
-THe [pokemon dataset compiled by Sarah Taha and PokéAPI](https://www.kaggle.com/datasets/sarahtaha/1025-pokemon) has been included under the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license.
+The [pokemon dataset compiled by Sarah Taha and PokéAPI](https://www.kaggle.com/datasets/sarahtaha/1025-pokemon) has been included under the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license for demonstration purposes.

zaturn-0.1.2/brand/logo.svg

@@ -0,0 +1,10 @@
+<svg width="512" height="512" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg">
+  <rect x="32" y="32" width="448" height="448" rx="32" ry="32"
+    style="fill: #182030;"/>
+  <path d="M128 128 A 181 60 45 0 1 384 384"
+    style="stroke: #ffffff; stroke-width: 32; fill: none; stroke-linecap: round;"/>
+  <circle cx="256" cy="256" r="120"
+    style="stroke: #ffffff; stroke-width: 32; fill: #182030;"/>
+  <path d="M128 128 Q192 256 288 224 L224 288 Q320 256 384 384"
+    style="stroke: #ffffff; stroke-width: 32; fill: none; stroke-linecap: round; stroke-linejoin: round;"/>
+</svg>

{zaturn-0.1.0 → zaturn-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "zaturn"
-version = "0.1.0"
+version = "0.1.2"
 description = "AI Data Analysis MCP"
 authors = [
   {name = "Karthik Devan", email = "krtdvn@gmail.com"},
@@ -21,6 +21,7 @@ dependencies = [
     "pymysql>=1.1.1",
     "python-lsp-server>=1.12.2",
     "seaborn>=0.13.2",
+    "setuptools>=78.1.0",
     "sqlalchemy>=2.0.40",
     "tabulate>=0.9.0",
 ]
@@ -30,19 +31,25 @@ zaturn_mcp = "zaturn:main"
 
 [project.urls]
 Homepage = "https://github.com/kdqed/zaturn"
-Changelog = "https://github.com/kdqed/zaturn/releases"
 Issues = "https://github.com/kdqed/zaturn/issues"
 CI = "https://github.com/kdqed/zaturn/actions"
 
 [build-system]
-requires = ["setuptools"]
+requires = [
+    "setuptools>=60",
+    "setuptools-scm>=8.0"
+]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools]
 include-package-data = false
 
 [tool.setuptools.packages.find]
-exclude = ["docs*", "example_data*", "brand*"]
+exclude = ["docs*", "brand*"]
+include = ["zaturn*"]
+
+[tool.setuptools.package-data]
+"*" = ["*.*"]
 
 [dependency-groups]
 dev = []