zaturn 0.1.6__tar.gz → 0.2.0__tar.gz

zaturn-0.2.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+### v0.2.0 (2025-07-01)
+- The Studio Interface: Now use Zaturn with an inbuilt UI, with your own LLM API.
+- Refactored MCP Code.
+- Removed `show_query_result` tool. Query results will now be returned directly.
+
+#### v0.1.7 (2025-05-06)
+- Ensured Read-Only For SQLite and MySQL
+
+#### v0.1.6 (2025-04-25)
+- Added Clickhouse Support
+
+#### v0.1.5 (2025-04-22)
+- Changed plotting library to plotly instead of seaborn
+- Fixed labeling issues in visualizations

zaturn-0.2.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: zaturn
+Version: 0.2.0
+Summary: AI Data Analysis MCP & Studio
+Author-email: Karthik Devan <krtdvn@gmail.com>
+Maintainer-email: Karthik Devan <krtdvn@gmail.com>
+Project-URL: Homepage, https://github.com/kdqed/zaturn
+Project-URL: Issues, https://github.com/kdqed/zaturn/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: clickhouse-connect>=0.8.17
+Requires-Dist: cryptography>=44.0.2
+Requires-Dist: duckdb>=1.2.1
+Requires-Dist: fastmcp>=0.4.1
+Requires-Dist: flask[async]>=3.1.1
+Requires-Dist: function-schema>=0.4.5
+Requires-Dist: kaleido==0.2.1
+Requires-Dist: mistune>=3.1.3
+Requires-Dist: openai>=1.82.1
+Requires-Dist: openai-agents>=0.0.16
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: platformdirs>=4.3.7
+Requires-Dist: plotly[express]>=6.0.1
+Requires-Dist: psycopg2-binary>=2.9.10
+Requires-Dist: pyarrow>=19.0.1
+Requires-Dist: pymysql>=1.1.1
+Requires-Dist: python-lsp-server>=1.12.2
+Requires-Dist: python-slugify>=8.0.4
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: setuptools>=78.1.0
+Requires-Dist: sqlalchemy>=2.0.40
+Requires-Dist: tabulate>=0.9.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: werkzeug>=3.1.3
+Dynamic: license-file
+
+<h1>
+  <img src="https://github.com/kdqed/zaturn/raw/main/zaturn/studio/static/logo.png" width="24" height="24">
+  <span>Zaturn: Your Co-Pilot For Data Analytics & Business Insights</span>
+</h1>
+
+<a href="https://discord.gg/K8mECeVzpQ">
+  <img src="https://zaturn.pro/assets/discord-full.png" height="20" width="133" alt="Discord Logo">
+</a>
+
+## Just Chat With Your Data! No SQL, No Python.
+
+Zaturn provides tools that enable AI models to run SQL, so you don't have to. It can be used as an MCP or as a web interface similar to Jupyter Notebook.
+
+## Zaturn in Action
+
+https://github.com/user-attachments/assets/d42dc433-e5ec-4b3e-bef0-5cfc097396ab
+
+## Features:
+
+### Multiple Data Sources 
+
+Zaturn can currently connect to the following data sources: 
+- SQL Databases: PostgreSQL, SQLite, DuckDB, MySQL, ClickHouse
+- Files: CSV, Parquet
+
+Connectors for more data sources are being added.
+
+### Visualizations
+
+In addition to providing tabular and textual summaries, Zaturn can also generate the following image visualizations
+
+- Scatter and Line Plots
+- Histograms
+- Strip and Box Plots
+- Bar Plots
+
+More visualization capabilities are being added.
+
+
+## Installation & Setup
+
+See [https://zaturn.pro/install](https://zaturn.pro/install)
+
+
+## Roadmap
+
+- Support for more data source types
+- More data visualizations
+- Predictive analysis and forecasting, e.g.:
+```
+Based on the revenue of the last 3 months, forecast next month's revenue.
+```
+- Generate Presentations & PDFs
+```
+Manager: 
+  I need a presentation to show the boss. Can you do it by EOD?
+Analyst: 
+  EOD?! Are you still in the 2010s? 
+  I can get it done right now. Actually, you can do it right now.
+  You know what? The boss can do it right now.
+```
+- A native notebook interface 
+
+## Help And Feedback
+
+[Raise an issue](https://github.com/kdqed/zaturn/issues) or [join the Discord](https://discord.gg/K8mECeVzpQ).
+
+
+## Support The Project
+
+If you find Zaturn useful, please support this project by:
+- Starring the Project
+- Spreading the word
+
+Your support will enable me to dedicate more of my time to Zaturn.
+
+## 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 for demonstration purposes.
+
+## Featured on glama.ai
+
+<a href="https://glama.ai/mcp/servers/@kdqed/zaturn">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kdqed/zaturn/badge" alt="Zaturn MCP server" />
+</a>
+
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=kdqed/zaturn&type=Date)](https://www.star-history.com/#kdqed/zaturn&Date)

zaturn-0.2.0/README.md

@@ -0,0 +1,90 @@
+<h1>
+  <img src="https://github.com/kdqed/zaturn/raw/main/zaturn/studio/static/logo.png" width="24" height="24">
+  <span>Zaturn: Your Co-Pilot For Data Analytics & Business Insights</span>
+</h1>
+
+<a href="https://discord.gg/K8mECeVzpQ">
+  <img src="https://zaturn.pro/assets/discord-full.png" height="20" width="133" alt="Discord Logo">
+</a>
+
+## Just Chat With Your Data! No SQL, No Python.
+
+Zaturn provides tools that enable AI models to run SQL, so you don't have to. It can be used as an MCP or as a web interface similar to Jupyter Notebook.
+
+## Zaturn in Action
+
+https://github.com/user-attachments/assets/d42dc433-e5ec-4b3e-bef0-5cfc097396ab
+
+## Features:
+
+### Multiple Data Sources 
+
+Zaturn can currently connect to the following data sources: 
+- SQL Databases: PostgreSQL, SQLite, DuckDB, MySQL, ClickHouse
+- Files: CSV, Parquet
+
+Connectors for more data sources are being added.
+
+### Visualizations
+
+In addition to providing tabular and textual summaries, Zaturn can also generate the following image visualizations
+
+- Scatter and Line Plots
+- Histograms
+- Strip and Box Plots
+- Bar Plots
+
+More visualization capabilities are being added.
+
+
+## Installation & Setup
+
+See [https://zaturn.pro/install](https://zaturn.pro/install)
+
+
+## Roadmap
+
+- Support for more data source types
+- More data visualizations
+- Predictive analysis and forecasting, e.g.:
+```
+Based on the revenue of the last 3 months, forecast next month's revenue.
+```
+- Generate Presentations & PDFs
+```
+Manager: 
+  I need a presentation to show the boss. Can you do it by EOD?
+Analyst: 
+  EOD?! Are you still in the 2010s? 
+  I can get it done right now. Actually, you can do it right now.
+  You know what? The boss can do it right now.
+```
+- A native notebook interface 
+
+## Help And Feedback
+
+[Raise an issue](https://github.com/kdqed/zaturn/issues) or [join the Discord](https://discord.gg/K8mECeVzpQ).
+
+
+## Support The Project
+
+If you find Zaturn useful, please support this project by:
+- Starring the Project
+- Spreading the word
+
+Your support will enable me to dedicate more of my time to Zaturn.
+
+## 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 for demonstration purposes.
+
+## Featured on glama.ai
+
+<a href="https://glama.ai/mcp/servers/@kdqed/zaturn">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kdqed/zaturn/badge" alt="Zaturn MCP server" />
+</a>
+
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=kdqed/zaturn&type=Date)](https://www.star-history.com/#kdqed/zaturn&Date)

{zaturn-0.1.6 → zaturn-0.2.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "zaturn"
-version = "0.1.6"
-description = "AI Data Analysis MCP"
+version = "0.2.0"
+description = "AI Data Analysis MCP & Studio"
 authors = [
   {name = "Karthik Devan", email = "krtdvn@gmail.com"},
 ]
@@ -15,22 +15,32 @@ dependencies = [
     "cryptography>=44.0.2",
     "duckdb>=1.2.1",
     "fastmcp>=0.4.1",
+    "flask[async]>=3.1.1",
+    "function-schema>=0.4.5",
     "kaleido==0.2.1",
+    "mistune>=3.1.3",
+    "openai>=1.82.1",
+    "openai-agents>=0.0.16",
     "pandas>=2.2.3",
+    "pillow>=11.2.1",
     "platformdirs>=4.3.7",
     "plotly[express]>=6.0.1",
     "psycopg2-binary>=2.9.10",
     "pyarrow>=19.0.1",
     "pymysql>=1.1.1",
     "python-lsp-server>=1.12.2",
+    "python-slugify>=8.0.4",
     "seaborn>=0.13.2",
     "setuptools>=78.1.0",
     "sqlalchemy>=2.0.40",
     "tabulate>=0.9.0",
+    "tomli-w>=1.2.0",
+    "werkzeug>=3.1.3",
 ]
 
 [project.scripts]
-zaturn_mcp = "zaturn:main"
+zaturn_mcp = "zaturn.mcp:main"
+zaturn_studio = "zaturn.studio:main"
 
 [project.urls]
 Homepage = "https://github.com/kdqed/zaturn"