zaturn 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{zaturn-0.1.0.dist-info → zaturn-0.1.2.dist-info}/METADATA

@@ -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.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+zaturn/__init__.py,sha256=v4t5fkRuIJFE-SBxCa5pBjZv0EoC0eWK75nU9iaa7Rg,267
+zaturn/config.py,sha256=gF5M6Agmixw2A4vpWqIF3ICVnClPeASA51dhp1bkk04,3221
+zaturn/core.py,sha256=sn2oliWVDqhYSAwSe5VbhNamaKAsnlrT3oc6uzffzs4,3267
+zaturn/query_utils.py,sha256=zyQjcRnPKGHZdf0XHzQeMxHw9vieZIwXhBbVGP87ml4,2801
+zaturn/visualizations.py,sha256=Dj08msgZ_DIMEVvJIlybT3cIA3GNkcXVOa9TJsHK2yo,4551
+zaturn/example_data/all_pokemon_data.csv,sha256=SUlGHHWbehuLg-ch1YUrQ6-xBtqHGw6rIkyn70fAgCk,130893
+zaturn-0.1.2.dist-info/licenses/LICENSE,sha256=mZSuFlbEBZGl0-8ULRMLdRDbhau5hrWRNQOjytYeaug,1070
+zaturn-0.1.2.dist-info/METADATA,sha256=fyeW0ljonWfL4krOO9Wfm_4etUXRRcl47JeZ_KphRI4,5731
+zaturn-0.1.2.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+zaturn-0.1.2.dist-info/entry_points.txt,sha256=N1UZC2zvod92_Brs4A2xZiAnt-iGLBNryglXfwhxfj4,43
+zaturn-0.1.2.dist-info/top_level.txt,sha256=KLUnwQwVZkfd5YCnnqR35MOOs8KLhanPGelvmRo2MVA,7
+zaturn-0.1.2.dist-info/RECORD,,

zaturn-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-zaturn/__init__.py,sha256=v4t5fkRuIJFE-SBxCa5pBjZv0EoC0eWK75nU9iaa7Rg,267
-zaturn/config.py,sha256=t11_sJxTsliTGpImveqmgjXWTDeijK8VMqqTPygEY7E,3154
-zaturn/core.py,sha256=sn2oliWVDqhYSAwSe5VbhNamaKAsnlrT3oc6uzffzs4,3267
-zaturn/query_utils.py,sha256=zyQjcRnPKGHZdf0XHzQeMxHw9vieZIwXhBbVGP87ml4,2801
-zaturn/visualizations.py,sha256=Dj08msgZ_DIMEVvJIlybT3cIA3GNkcXVOa9TJsHK2yo,4551
-zaturn-0.1.0.dist-info/licenses/LICENSE,sha256=mZSuFlbEBZGl0-8ULRMLdRDbhau5hrWRNQOjytYeaug,1070
-zaturn-0.1.0.dist-info/METADATA,sha256=_NI82YYMcGMc1Jz2OH6XmGwsoLUVpPB5zxvu0d1mCjM,5831
-zaturn-0.1.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-zaturn-0.1.0.dist-info/entry_points.txt,sha256=N1UZC2zvod92_Brs4A2xZiAnt-iGLBNryglXfwhxfj4,43
-zaturn-0.1.0.dist-info/top_level.txt,sha256=KLUnwQwVZkfd5YCnnqR35MOOs8KLhanPGelvmRo2MVA,7
-zaturn-0.1.0.dist-info/RECORD,,