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

zaturn/config.py

@@ -47,7 +47,7 @@ if not source_list:
     print("No data sources provided. Loading example dataset for demonstration.")
     print(f"\nTo load your datasets, add them to {SOURCES_FILE} (one source URL or full file path per line)")
     print("\nOr use command line args to specify data sources:")
-    print("uv run --directory /path/to/zaturn mcp_server.py sqlite:///path/to/mydata.db")
+    print("zaturn_mcp sqlite:///path/to/mydata.db /path/to/my_file.csv")
     print(f"\nNOTE: Sources in command line args will be ignored if sources are found in {SOURCES_FILE}")
     
 SOURCES = {}
@@ -88,7 +88,6 @@ for s in source_list:
 
 # Other Settings
 RETURN_IMAGES = not args.noimg
-print(SOURCES)
 
 
 

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

@@ -1,11 +1,10 @@
 Metadata-Version: 2.4
 Name: zaturn
-Version: 0.1.1
+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
@@ -27,7 +26,7 @@ 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
@@ -69,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. Install Zaturn with uv:
+2. Install [Zaturn](https://pypi.org/project/zaturn/) with uv:
 ```bash
-$ uv tool install zaturn
+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",
@@ -95,10 +90,22 @@ $ uv tool install zaturn
 }
 ```
 
-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",
 ...
@@ -114,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
@@ -151,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.1.dist-info → zaturn-0.1.2.dist-info}/RECORD

@@ -1,12 +1,12 @@
 zaturn/__init__.py,sha256=v4t5fkRuIJFE-SBxCa5pBjZv0EoC0eWK75nU9iaa7Rg,267
-zaturn/config.py,sha256=Pq7mNScRnQ4PycDv3cqFVSK9Y9N9V9k3bdGgVo-P4Ns,3253
+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.1.dist-info/licenses/LICENSE,sha256=mZSuFlbEBZGl0-8ULRMLdRDbhau5hrWRNQOjytYeaug,1070
-zaturn-0.1.1.dist-info/METADATA,sha256=etCpT5a2AxDSP_hc7_ic6ecEd_aZYGsQNdvzTWtbQbU,5834
-zaturn-0.1.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-zaturn-0.1.1.dist-info/entry_points.txt,sha256=N1UZC2zvod92_Brs4A2xZiAnt-iGLBNryglXfwhxfj4,43
-zaturn-0.1.1.dist-info/top_level.txt,sha256=KLUnwQwVZkfd5YCnnqR35MOOs8KLhanPGelvmRo2MVA,7
-zaturn-0.1.1.dist-info/RECORD,,
+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,,