Thinxai 1.0.2__tar.gz

thinxai-1.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thinxai
+
+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.

thinxai-1.0.2/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include thinxai *.py

thinxai-1.0.2/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: Thinxai
+Version: 1.0.2
+Summary: AI Model Explainability and Interpretability Tool
+Author: Thinxai Team
+Author-email: Thinxai Team <fyp9446@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: matplotlib>=3.4.0
+Requires-Dist: seaborn>=0.11.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: torch>=2.0.0
+Requires-Dist: transformers>=4.30.0
+Requires-Dist: shap>=0.42.0
+Requires-Dist: captum>=0.6.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: tqdm>=4.62.0
+Requires-Dist: psutil>=5.8.0
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow>=2.12.0; extra == "tensorflow"
+Provides-Extra: gpu
+Requires-Dist: torch[cuda]; extra == "gpu"
+Provides-Extra: all
+Requires-Dist: tensorflow>=2.12.0; extra == "all"
+Requires-Dist: torch[cuda]; extra == "all"
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# Thinxai
+
+A CLI tool for explaining deep learning models. Provide it with a trained model + training dataset with target and it generates a PDF report telling what drives predictions and why.
+
+## Install
+
+```bash
+pip install thinxai
+```
+
+With extras:
+
+```bash
+pip install thinxai[tensorflow]   # TensorFlow/Keras models
+pip install thinxai[gpu]           # GPU acceleration
+pip install thinxai[all]           # all extras
+```
+
+## Quick Start
+
+1. Place your model file and CSV dataset in the same folder
+2. Run:
+
+```bash
+thinxai
+```
+
+Or:
+
+```bash
+python -m thinxai
+```
+
+3. Select your model and dataset from the interactive menu
+4. Find the PDF report in the same folder
+
+## Supported Inputs
+
+**Deep Learning Models:** PyTorch (.pth, .pt, .pkl), TensorFlow/Keras (.h5, .hdf5, .keras, SavedModel), Transformers (BERT, GPT, etc.), ONNX (.onnx)
+
+**Also Supported:** Scikit-learn (.pkl, .joblib)
+
+**Data:** CSV, tab-delimited, pipe-delimited
+
+## What It Does
+
+Thinxai runs multiple explainability methods on your model and combines the results into a single ranked list. It then generates plain English explanations for the top features and packages everything into a PDF report.
+
+### Analysis Pipeline
+
+- **Permutation Importance**: shuffles each feature and measures accuracy drop 
+- **SHAP Values**: game-theoretic attribution per prediction 
+- **Integrated Gradients**: gradient-based attribution along the input path 
+- **Statistical Tests**: mutual information and F-scores
+- **Built-in Importance**: model native scores when available
+
+These are merged into a **consensus score**. Features that rank highly across multiple methods get higher confidence.
+
+### Explanations
+
+Top features are explained by a **cascade LLM system**:
+
+- **Groq API**: Primary 
+- **HuggingFace fallback**: Secondary
+- **Rule-based fallback**: Always works
+
+Each explanation includes a **business insight**
+
+### PDF Report Contents
+
+- Cover page with model validation metrics and trust indicator
+- Feature importance distribution pie chart
+- Each feature gets explanation cards with business insights
+- Executive summary with the top 3 features
+- Technical glossary automatically generated from terms found in the report
+
+### Trust Indicators
+
+The tool flags suspicious results:
+
+- **Accuracy >99%**: warns about possible data leakage
+- **Accuracy near random**: warns model may not have learned patterns
+- **Raw state_dict models**: skips validation, runs statistical analysis only
+
+## Requirements
+
+- Python 3.8+
+- See `setup.py` for full dependency list
+
+## Documentation
+
+- `README.md` — this file
+- `QUICKREF.md` — how to run this 
+- `LICENSE` — MIT License

thinxai-1.0.2/README.md

@@ -0,0 +1,94 @@
+# Thinxai
+
+A CLI tool for explaining deep learning models. Provide it with a trained model + training dataset with target and it generates a PDF report telling what drives predictions and why.
+
+## Install
+
+```bash
+pip install thinxai
+```
+
+With extras:
+
+```bash
+pip install thinxai[tensorflow]   # TensorFlow/Keras models
+pip install thinxai[gpu]           # GPU acceleration
+pip install thinxai[all]           # all extras
+```
+
+## Quick Start
+
+1. Place your model file and CSV dataset in the same folder
+2. Run:
+
+```bash
+thinxai
+```
+
+Or:
+
+```bash
+python -m thinxai
+```
+
+3. Select your model and dataset from the interactive menu
+4. Find the PDF report in the same folder
+
+## Supported Inputs
+
+**Deep Learning Models:** PyTorch (.pth, .pt, .pkl), TensorFlow/Keras (.h5, .hdf5, .keras, SavedModel), Transformers (BERT, GPT, etc.), ONNX (.onnx)
+
+**Also Supported:** Scikit-learn (.pkl, .joblib)
+
+**Data:** CSV, tab-delimited, pipe-delimited
+
+## What It Does
+
+Thinxai runs multiple explainability methods on your model and combines the results into a single ranked list. It then generates plain English explanations for the top features and packages everything into a PDF report.
+
+### Analysis Pipeline
+
+- **Permutation Importance**: shuffles each feature and measures accuracy drop 
+- **SHAP Values**: game-theoretic attribution per prediction 
+- **Integrated Gradients**: gradient-based attribution along the input path 
+- **Statistical Tests**: mutual information and F-scores
+- **Built-in Importance**: model native scores when available
+
+These are merged into a **consensus score**. Features that rank highly across multiple methods get higher confidence.
+
+### Explanations
+
+Top features are explained by a **cascade LLM system**:
+
+- **Groq API**: Primary 
+- **HuggingFace fallback**: Secondary
+- **Rule-based fallback**: Always works
+
+Each explanation includes a **business insight**
+
+### PDF Report Contents
+
+- Cover page with model validation metrics and trust indicator
+- Feature importance distribution pie chart
+- Each feature gets explanation cards with business insights
+- Executive summary with the top 3 features
+- Technical glossary automatically generated from terms found in the report
+
+### Trust Indicators
+
+The tool flags suspicious results:
+
+- **Accuracy >99%**: warns about possible data leakage
+- **Accuracy near random**: warns model may not have learned patterns
+- **Raw state_dict models**: skips validation, runs statistical analysis only
+
+## Requirements
+
+- Python 3.8+
+- See `setup.py` for full dependency list
+
+## Documentation
+
+- `README.md` — this file
+- `QUICKREF.md` — how to run this 
+- `LICENSE` — MIT License

thinxai-1.0.2/Thinxai.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: Thinxai
+Version: 1.0.2
+Summary: AI Model Explainability and Interpretability Tool
+Author: Thinxai Team
+Author-email: Thinxai Team <fyp9446@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: matplotlib>=3.4.0
+Requires-Dist: seaborn>=0.11.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: torch>=2.0.0
+Requires-Dist: transformers>=4.30.0
+Requires-Dist: shap>=0.42.0
+Requires-Dist: captum>=0.6.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: tqdm>=4.62.0
+Requires-Dist: psutil>=5.8.0
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow>=2.12.0; extra == "tensorflow"
+Provides-Extra: gpu
+Requires-Dist: torch[cuda]; extra == "gpu"
+Provides-Extra: all
+Requires-Dist: tensorflow>=2.12.0; extra == "all"
+Requires-Dist: torch[cuda]; extra == "all"
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# Thinxai
+
+A CLI tool for explaining deep learning models. Provide it with a trained model + training dataset with target and it generates a PDF report telling what drives predictions and why.
+
+## Install
+
+```bash
+pip install thinxai
+```
+
+With extras:
+
+```bash
+pip install thinxai[tensorflow]   # TensorFlow/Keras models
+pip install thinxai[gpu]           # GPU acceleration
+pip install thinxai[all]           # all extras
+```
+
+## Quick Start
+
+1. Place your model file and CSV dataset in the same folder
+2. Run:
+
+```bash
+thinxai
+```
+
+Or:
+
+```bash
+python -m thinxai
+```
+
+3. Select your model and dataset from the interactive menu
+4. Find the PDF report in the same folder
+
+## Supported Inputs
+
+**Deep Learning Models:** PyTorch (.pth, .pt, .pkl), TensorFlow/Keras (.h5, .hdf5, .keras, SavedModel), Transformers (BERT, GPT, etc.), ONNX (.onnx)
+
+**Also Supported:** Scikit-learn (.pkl, .joblib)
+
+**Data:** CSV, tab-delimited, pipe-delimited
+
+## What It Does
+
+Thinxai runs multiple explainability methods on your model and combines the results into a single ranked list. It then generates plain English explanations for the top features and packages everything into a PDF report.
+
+### Analysis Pipeline
+
+- **Permutation Importance**: shuffles each feature and measures accuracy drop 
+- **SHAP Values**: game-theoretic attribution per prediction 
+- **Integrated Gradients**: gradient-based attribution along the input path 
+- **Statistical Tests**: mutual information and F-scores
+- **Built-in Importance**: model native scores when available
+
+These are merged into a **consensus score**. Features that rank highly across multiple methods get higher confidence.
+
+### Explanations
+
+Top features are explained by a **cascade LLM system**:
+
+- **Groq API**: Primary 
+- **HuggingFace fallback**: Secondary
+- **Rule-based fallback**: Always works
+
+Each explanation includes a **business insight**
+
+### PDF Report Contents
+
+- Cover page with model validation metrics and trust indicator
+- Feature importance distribution pie chart
+- Each feature gets explanation cards with business insights
+- Executive summary with the top 3 features
+- Technical glossary automatically generated from terms found in the report
+
+### Trust Indicators
+
+The tool flags suspicious results:
+
+- **Accuracy >99%**: warns about possible data leakage
+- **Accuracy near random**: warns model may not have learned patterns
+- **Raw state_dict models**: skips validation, runs statistical analysis only
+
+## Requirements
+
+- Python 3.8+
+- See `setup.py` for full dependency list
+
+## Documentation
+
+- `README.md` — this file
+- `QUICKREF.md` — how to run this 
+- `LICENSE` — MIT License

thinxai-1.0.2/Thinxai.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+Thinxai.egg-info/PKG-INFO
+Thinxai.egg-info/SOURCES.txt
+Thinxai.egg-info/dependency_links.txt
+Thinxai.egg-info/entry_points.txt
+Thinxai.egg-info/not-zip-safe
+Thinxai.egg-info/requires.txt
+Thinxai.egg-info/top_level.txt
+thinxai/__init__.py
+thinxai/__main__.py
+thinxai/thinxai.py

thinxai-1.0.2/Thinxai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

thinxai-1.0.2/Thinxai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+thinxai = thinxai.__main__:main

thinxai-1.0.2/Thinxai.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

thinxai-1.0.2/Thinxai.egg-info/requires.txt

@@ -0,0 +1,22 @@
+numpy>=1.21.0
+pandas>=1.3.0
+matplotlib>=3.4.0
+seaborn>=0.11.0
+scikit-learn>=1.0.0
+torch>=2.0.0
+transformers>=4.30.0
+shap>=0.42.0
+captum>=0.6.0
+groq>=0.4.0
+tqdm>=4.62.0
+psutil>=5.8.0
+
+[all]
+tensorflow>=2.12.0
+torch[cuda]
+
+[gpu]
+torch[cuda]
+
+[tensorflow]
+tensorflow>=2.12.0

thinxai-1.0.2/Thinxai.egg-info/top_level.txt

@@ -0,0 +1 @@
+thinxai

thinxai-1.0.2/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "Thinxai"
+version = "1.0.2"
+description = "AI Model Explainability and Interpretability Tool"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "Thinxai Team", email = "fyp9446@gmail.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "numpy>=1.21.0",
+    "pandas>=1.3.0",
+    "matplotlib>=3.4.0",
+    "seaborn>=0.11.0",
+    "scikit-learn>=1.0.0",
+    "torch>=2.0.0",
+    "transformers>=4.30.0",
+    "shap>=0.42.0",
+    "captum>=0.6.0",
+    "groq>=0.4.0",
+    "tqdm>=4.62.0",
+    "psutil>=5.8.0",
+]
+
+[project.optional-dependencies]
+tensorflow = ["tensorflow>=2.12.0"]
+gpu = ["torch[cuda]"]
+all = ["tensorflow>=2.12.0", "torch[cuda]"]
+
+[project.scripts]
+thinxai = "thinxai.__main__:main"
+
+[tool.setuptools]
+packages = ["thinxai"]

thinxai-1.0.2/setup.cfg

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

thinxai-1.0.2/setup.py

@@ -0,0 +1,59 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="Thinxai",
+    version="1.0.2",
+    author="Thinxai Team",
+    author_email="fyp9446@gmail.com",
+    description="AI Model Explainability and Interpretability Tool",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Science/Research",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "numpy>=1.21.0",
+        "pandas>=1.3.0",
+        "matplotlib>=3.4.0",
+        "seaborn>=0.11.0",
+        "scikit-learn>=1.0.0",
+        "torch>=2.0.0",
+        "transformers>=4.30.0",
+        "shap>=0.42.0",
+        "captum>=0.6.0",
+        "groq>=0.4.0",
+        "tqdm>=4.62.0",
+        "psutil>=5.8.0",
+    ],
+    extras_require={
+        "tensorflow": ["tensorflow>=2.12.0"],
+        "gpu": ["torch[cuda]"],
+        "all": [
+            "tensorflow>=2.12.0",
+            "torch[cuda]",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "thinxai=thinxai.__main__:main",
+        ],
+    },
+    include_package_data=True,
+    zip_safe=False,
+)

thinxai-1.0.2/thinxai/__init__.py

@@ -0,0 +1,7 @@
+"""ThinXAI - AI Model Explainability Tool"""
+
+__version__ = "1.0.2"
+__author__ = "Thinxai"
+
+
+from .thinxai import main

thinxai-1.0.2/thinxai/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+"""Entry point for python -m thinxai"""
+
+from .thinxai import main
+
+if __name__ == "__main__":
+    main()