pychartai 0.5.0__tar.gz

pychartai-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cem Akpolat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pychartai-0.5.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: pychartai
+Version: 0.5.0
+Summary: AI-powered data analysis and chart generation with 20 chart types, 3 backends, 8 LLM providers, conversation memory, auto-EDA profiling, chart themes, and RestrictedSandbox. Works standalone.
+Author-email: Cem Akpolat <cem.akpolat@eficode.com>
+License: MIT
+Project-URL: Repository, https://github.com/cemakpolat/pychartai
+Project-URL: Homepage, https://github.com/cemakpolat/pychartai
+Project-URL: Bug Tracker, https://github.com/cemakpolat/pychartai/issues
+Project-URL: Changelog, https://github.com/cemakpolat/pychartai/blob/main/CHANGELOG.md
+Keywords: pandas,llm,charts,visualization,ai,data-analysis,seaborn,plotly,matplotlib,ollama,openai,skills,schema,pipeline,sandbox
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: seaborn>=0.12.0
+Requires-Dist: scipy>=1.10.0
+Requires-Dist: RestrictedPython<9,>=7.0
+Requires-Dist: litellm<2,>=1.35.0
+Requires-Dist: tenacity>=8.0.0
+Provides-Extra: viz-plotly
+Requires-Dist: plotly>=5.0.0; extra == "viz-plotly"
+Requires-Dist: kaleido>=0.2.1; extra == "viz-plotly"
+Provides-Extra: db-postgres
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "db-postgres"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "db-postgres"
+Provides-Extra: db-mysql
+Requires-Dist: pymysql>=1.1.0; extra == "db-mysql"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "db-mysql"
+Provides-Extra: db-snowflake
+Requires-Dist: snowflake-sqlalchemy>=1.5.0; extra == "db-snowflake"
+Provides-Extra: db-bigquery
+Requires-Dist: google-cloud-bigquery>=3.0.0; extra == "db-bigquery"
+Requires-Dist: sqlalchemy-bigquery>=1.6.0; extra == "db-bigquery"
+Provides-Extra: db-redshift
+Requires-Dist: redshift-connector>=2.0.0; extra == "db-redshift"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "db-redshift"
+Provides-Extra: db-all
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "db-all"
+Requires-Dist: pymysql>=1.1.0; extra == "db-all"
+Requires-Dist: snowflake-sqlalchemy>=1.5.0; extra == "db-all"
+Requires-Dist: google-cloud-bigquery>=3.0.0; extra == "db-all"
+Requires-Dist: sqlalchemy-bigquery>=1.6.0; extra == "db-all"
+Requires-Dist: redshift-connector>=2.0.0; extra == "db-all"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "db-all"
+Provides-Extra: cloud-s3
+Requires-Dist: boto3>=1.26.0; extra == "cloud-s3"
+Provides-Extra: cloud-gcs
+Requires-Dist: google-cloud-storage>=2.10.0; extra == "cloud-gcs"
+Provides-Extra: cloud-azure
+Requires-Dist: azure-storage-blob>=12.14.0; extra == "cloud-azure"
+Provides-Extra: cloud-gsheets
+Requires-Dist: google-api-python-client>=2.80.0; extra == "cloud-gsheets"
+Requires-Dist: google-auth>=2.16.0; extra == "cloud-gsheets"
+Provides-Extra: cloud-all
+Requires-Dist: boto3>=1.26.0; extra == "cloud-all"
+Requires-Dist: google-cloud-storage>=2.10.0; extra == "cloud-all"
+Requires-Dist: azure-storage-blob>=12.14.0; extra == "cloud-all"
+Requires-Dist: google-api-python-client>=2.80.0; extra == "cloud-all"
+Requires-Dist: google-auth>=2.16.0; extra == "cloud-all"
+Provides-Extra: api
+Requires-Dist: fastapi>=0.100.0; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.20.0; extra == "api"
+Requires-Dist: python-multipart>=0.0.6; extra == "api"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: mcp>=1.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: openpyxl>=3.1.0; extra == "dev"
+Requires-Dist: pyarrow>=14.0.0; extra == "dev"
+Requires-Dist: plotly>=5.0.0; extra == "dev"
+Requires-Dist: kaleido>=0.2.1; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Dynamic: license-file
+
+# pychartai
+
+> Natural-language data analysis and chart generation.
+> Use it as a Python library, a CLI, or an MCP server for Claude/Copilot/Cursor.
+
+---
+
+## Quick Start
+
+```bash
+pip install pychartai
+```
+
+```python
+import pychartai as pai
+
+# Set DEEPSEEK_API_KEY in .env, then:
+pai.init(provider="deepseek", model="deepseek-chat")
+
+df = pai.read_csv("data.csv")
+print(df.chat("What is revenue by region?"))
+path = df.chat("Bar chart of revenue by region")  # interactive HTML
+print(df.profile().summary)                        # auto-EDA, no LLM
+```
+
+## Three Ways to Use It
+
+### 1. MCP Server (for Claude Desktop / Copilot / Cursor)
+
+```bash
+make mcp-server
+# or: pychartai-mcp
+```
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pychartai": {
+      "command": "python",
+      "args": ["-m", "pychartai_mcp.server"],
+      "env": {"DEEPSEEK_API_KEY": "sk-..."}
+    }
+  }
+}
+```
+
+Then in Claude: *"Load sales.csv and show revenue by region as a chart"*
+
+**Available MCP tools:** `analyze_data`, `create_chart`, `profile_data`
+
+### 2. Python Library
+
+```python
+import pychartai as pai
+
+pai.init(provider="deepseek", model="deepseek-chat")
+
+sdf = pai.read_csv("sales.csv")
+print(sdf.chat("Top 3 products by revenue?"))
+path = sdf.chat("Bar chart of revenue by region")
+
+# Streaming, memory, profiling
+for event in sdf.chat_stream("Summarize this"):
+    if event.type == "token": print(event.value, end="")
+sdf.enable_memory()
+sdf.chat("Follow-up question")
+```
+
+### 3. CLI
+
+```bash
+pychartai data.csv "Revenue by region?"
+pychartai data.csv --profile          # auto-EDA, no LLM
+pychartai data.csv "Bar chart" --backend plotly
+```
+
+## Features
+
+| Category | What you get |
+|---|---|
+| **Chart backends** | Seaborn (PNG) · Matplotlib (PNG) · Plotly (interactive HTML) |
+| **Chart types** | 20: area · bar · box · bubble · count · ecdf · funnel · heatmap · histogram · kde · line · pairplot · pie · regression · scatter · stacked_bar · step · strip · swarm · violin |
+| **LLM Providers** | DeepSeek · OpenAI · GitHub · Gemini · Anthropic · Qwen · Ollama |
+| **Sandbox** | RestrictedPython (default) · Docker (optional) |
+| **Data connectors** | CSV · Excel · JSON · Parquet · PostgreSQL · MySQL · Snowflake · BigQuery · Redshift · S3 · GCS · Azure Blob · Google Sheets |
+| **Memory** | Sliding-window conversation memory for follow-up queries |
+| **Profiling** | `df.profile()` — stats, missing values, correlations (no LLM) |
+| **MCP Server** | Expose data analysis as tools for Claude/Copilot/Cursor |
+
+## Installation
+
+```bash
+pip install pychartai
+
+# Optional extras:
+pip install pychartai[viz-plotly]   # interactive Plotly charts
+pip install pychartai[db-postgres]  # PostgreSQL connector
+```
+
+Set your API key in `.env`:
+
+```bash
+DEEPSEEK_API_KEY=sk-...
+OPENAI_API_KEY=sk-...
+```
+
+## Configuration
+
+### models.yml (auto-discovered)
+
+```yaml
+default_model: deepseek-v4-flash
+models:
+  deepseek-v4-flash:
+    provider: deepseek
+    model: deepseek-chat
+    api_key_env: DEEPSEEK_API_KEY
+settings:
+  chart_backend: plotly
+```
+
+```python
+pai.init()                              # auto-discover + default_model
+pai.init(model="deepseek-v4-flash")     # by name
+pai.init(provider="deepseek", model="deepseek-chat")  # inline
+```
+
+## Makefile Reference
+
+```
+Setup:     make install    make venv    make prepare-data
+Offline:   make test       make demo    make gallery
+With LLM:  make demo-advanced [PROVIDER=deepseek]
+MCP:       make mcp-server
+```
+
+---
+
+## License
+
+MIT

pychartai-0.5.0/README.md

@@ -0,0 +1,143 @@
+# pychartai
+
+> Natural-language data analysis and chart generation.
+> Use it as a Python library, a CLI, or an MCP server for Claude/Copilot/Cursor.
+
+---
+
+## Quick Start
+
+```bash
+pip install pychartai
+```
+
+```python
+import pychartai as pai
+
+# Set DEEPSEEK_API_KEY in .env, then:
+pai.init(provider="deepseek", model="deepseek-chat")
+
+df = pai.read_csv("data.csv")
+print(df.chat("What is revenue by region?"))
+path = df.chat("Bar chart of revenue by region")  # interactive HTML
+print(df.profile().summary)                        # auto-EDA, no LLM
+```
+
+## Three Ways to Use It
+
+### 1. MCP Server (for Claude Desktop / Copilot / Cursor)
+
+```bash
+make mcp-server
+# or: pychartai-mcp
+```
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pychartai": {
+      "command": "python",
+      "args": ["-m", "pychartai_mcp.server"],
+      "env": {"DEEPSEEK_API_KEY": "sk-..."}
+    }
+  }
+}
+```
+
+Then in Claude: *"Load sales.csv and show revenue by region as a chart"*
+
+**Available MCP tools:** `analyze_data`, `create_chart`, `profile_data`
+
+### 2. Python Library
+
+```python
+import pychartai as pai
+
+pai.init(provider="deepseek", model="deepseek-chat")
+
+sdf = pai.read_csv("sales.csv")
+print(sdf.chat("Top 3 products by revenue?"))
+path = sdf.chat("Bar chart of revenue by region")
+
+# Streaming, memory, profiling
+for event in sdf.chat_stream("Summarize this"):
+    if event.type == "token": print(event.value, end="")
+sdf.enable_memory()
+sdf.chat("Follow-up question")
+```
+
+### 3. CLI
+
+```bash
+pychartai data.csv "Revenue by region?"
+pychartai data.csv --profile          # auto-EDA, no LLM
+pychartai data.csv "Bar chart" --backend plotly
+```
+
+## Features
+
+| Category | What you get |
+|---|---|
+| **Chart backends** | Seaborn (PNG) · Matplotlib (PNG) · Plotly (interactive HTML) |
+| **Chart types** | 20: area · bar · box · bubble · count · ecdf · funnel · heatmap · histogram · kde · line · pairplot · pie · regression · scatter · stacked_bar · step · strip · swarm · violin |
+| **LLM Providers** | DeepSeek · OpenAI · GitHub · Gemini · Anthropic · Qwen · Ollama |
+| **Sandbox** | RestrictedPython (default) · Docker (optional) |
+| **Data connectors** | CSV · Excel · JSON · Parquet · PostgreSQL · MySQL · Snowflake · BigQuery · Redshift · S3 · GCS · Azure Blob · Google Sheets |
+| **Memory** | Sliding-window conversation memory for follow-up queries |
+| **Profiling** | `df.profile()` — stats, missing values, correlations (no LLM) |
+| **MCP Server** | Expose data analysis as tools for Claude/Copilot/Cursor |
+
+## Installation
+
+```bash
+pip install pychartai
+
+# Optional extras:
+pip install pychartai[viz-plotly]   # interactive Plotly charts
+pip install pychartai[db-postgres]  # PostgreSQL connector
+```
+
+Set your API key in `.env`:
+
+```bash
+DEEPSEEK_API_KEY=sk-...
+OPENAI_API_KEY=sk-...
+```
+
+## Configuration
+
+### models.yml (auto-discovered)
+
+```yaml
+default_model: deepseek-v4-flash
+models:
+  deepseek-v4-flash:
+    provider: deepseek
+    model: deepseek-chat
+    api_key_env: DEEPSEEK_API_KEY
+settings:
+  chart_backend: plotly
+```
+
+```python
+pai.init()                              # auto-discover + default_model
+pai.init(model="deepseek-v4-flash")     # by name
+pai.init(provider="deepseek", model="deepseek-chat")  # inline
+```
+
+## Makefile Reference
+
+```
+Setup:     make install    make venv    make prepare-data
+Offline:   make test       make demo    make gallery
+With LLM:  make demo-advanced [PROVIDER=deepseek]
+MCP:       make mcp-server
+```
+
+---
+
+## License
+
+MIT

pychartai-0.5.0/pyproject.toml

@@ -0,0 +1,149 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pychartai"
+version = "0.5.0"
+description = "AI-powered data analysis and chart generation with 20 chart types, 3 backends, 8 LLM providers, conversation memory, auto-EDA profiling, chart themes, and RestrictedSandbox. Works standalone."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "Cem Akpolat", email = "cem.akpolat@eficode.com" }]
+keywords = ["pandas", "llm", "charts", "visualization", "ai", "data-analysis", "seaborn", "plotly", "matplotlib", "ollama", "openai", "skills", "schema", "pipeline", "sandbox"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pandas>=2.0.0",
+    "numpy>=1.24.0",
+    "requests>=2.31.0",
+    "python-dotenv>=1.0.0",
+    "matplotlib>=3.7.0",
+    "seaborn>=0.12.0",
+    "scipy>=1.10.0",
+    "RestrictedPython>=7.0,<9",
+    "litellm>=1.35.0,<2",
+    "tenacity>=8.0.0",
+]
+
+[project.scripts]
+pychartai = "pychartai.cli:main"
+pychartai-mcp = "pychartai_mcp.server:main"
+pychartai-mcp-agent = "pychartai_mcp.agent_server:main"
+
+[project.optional-dependencies]
+# Interactive HTML charts + static image export via Plotly (adds ~80 MB for kaleido)
+viz-plotly = [
+    "plotly>=5.0.0",
+    "kaleido>=0.2.1",
+]
+# Database connectors (install as needed)
+db-postgres = [
+    "psycopg2-binary>=2.9.0",
+    "sqlalchemy>=2.0.0",
+]
+db-mysql = [
+    "pymysql>=1.1.0",
+    "sqlalchemy>=2.0.0",
+]
+db-snowflake = [
+    "snowflake-sqlalchemy>=1.5.0",
+]
+db-bigquery = [
+    "google-cloud-bigquery>=3.0.0",
+    "sqlalchemy-bigquery>=1.6.0",
+]
+db-redshift = [
+    "redshift-connector>=2.0.0",
+    "sqlalchemy>=2.0.0",
+]
+db-all = [
+    "psycopg2-binary>=2.9.0",
+    "pymysql>=1.1.0",
+    "snowflake-sqlalchemy>=1.5.0",
+    "google-cloud-bigquery>=3.0.0",
+    "sqlalchemy-bigquery>=1.6.0",
+    "redshift-connector>=2.0.0",
+    "sqlalchemy>=2.0.0",
+]
+# Cloud storage / SaaS connectors (install as needed)
+cloud-s3 = [
+    "boto3>=1.26.0",
+]
+cloud-gcs = [
+    "google-cloud-storage>=2.10.0",
+]
+cloud-azure = [
+    "azure-storage-blob>=12.14.0",
+]
+cloud-gsheets = [
+    "google-api-python-client>=2.80.0",
+    "google-auth>=2.16.0",
+]
+cloud-all = [
+    "boto3>=1.26.0",
+    "google-cloud-storage>=2.10.0",
+    "azure-storage-blob>=12.14.0",
+    "google-api-python-client>=2.80.0",
+    "google-auth>=2.16.0",
+]
+api = [
+    "fastapi>=0.100.0",
+    "uvicorn[standard]>=0.20.0",
+    "python-multipart>=0.0.6",
+]
+mcp = [
+    "mcp>=1.0.0",
+]
+dev = [
+    "pytest>=7.4.3",
+    "mcp>=1.0.0",
+    "pytest-cov>=4.1.0",
+    "openpyxl>=3.1.0",
+    "pyarrow>=14.0.0",
+    "plotly>=5.0.0",
+    "kaleido>=0.2.1",
+]
+docs = [
+    "mkdocs>=1.5.0",
+    "mkdocs-material>=9.0.0",
+    "mkdocstrings[python]>=0.24.0",
+]
+
+[project.urls]
+Repository = "https://github.com/cemakpolat/pychartai"
+Homepage = "https://github.com/cemakpolat/pychartai"
+"Bug Tracker" = "https://github.com/cemakpolat/pychartai/issues"
+Changelog = "https://github.com/cemakpolat/pychartai/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["pychartai*"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false

pychartai-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pychartai-0.5.0/setup.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Minimal setup.py for pychartai.
+
+Build configuration lives in ``pyproject.toml``.
+This file exists for backward compatibility with older pip/setuptools
+workflows that expect a ``setup.py``, such as:
+
+    pip install -e .                     # editable install
+    python setup.py sdist                # source distribution
+    python setup.py bdist_wheel          # wheel distribution
+
+All project metadata, dependencies, and entry points are defined in
+``pyproject.toml`` under the ``[project]`` section. This file delegates
+to setuptools which reads that configuration automatically.
+"""
+
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()