Metadata-Version: 2.4
Name: vexray
Version: 0.2.1
Summary: Interactive ML/DL concept explorer — learn with live graphs, code, and playgrounds
Home-page: https://github.com/vexray/vexray
Author: VexRay
Keywords: machine-learning deep-learning visualization education interactive
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Education
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: flask>=3.0
Requires-Dist: numpy>=1.24
Requires-Dist: scikit-learn>=1.3
Requires-Dist: scipy>=1.11
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ⚡ VexRay

**Interactive ML/DL Concept Explorer** — learn machine learning and deep learning concepts with rich visuals, live graphs, code examples, and interactive playgrounds.

## Install

```bash
pip install vexray
```

## Quick Start

### 📚 Learn a Topic
```python
import vexray

vexray.start("linear regression")
```
Opens a beautiful page with explanations, math, graphs, and code.

### 🧪 Interactive Playground
```python
import vexray

vexray.playground("svm")
```
Tweak parameters with sliders and see ML algorithms update in real-time.

## Available Topics (23)

| Category | Topics |
|----------|--------|
| **Regression** | Linear Regression, Logistic Regression |
| **Classification** | KNN, SVM, Naive Bayes, Decision Trees |
| **Ensemble** | Random Forest, Gradient Boosting |
| **Unsupervised** | K-Means, PCA |
| **Concepts** | Regularization, Bias-Variance, Cross-Validation |
| **Deep Learning** | Neural Networks, Backpropagation, CNNs, RNNs/LSTMs, Transformers |
| **Generative** | GANs, Autoencoders |
| **Building Blocks** | Activation Functions, Loss Functions, Optimizers |

## Interactive Playgrounds (13)

| Playground | Command |
|------------|---------|
| Linear Regression | `vexray.playground("linear regression")` |
| KNN | `vexray.playground("knn")` |
| K-Means | `vexray.playground("kmeans")` |
| Decision Tree | `vexray.playground("decision tree")` |
| SVM | `vexray.playground("svm")` |
| Logistic Regression | `vexray.playground("logistic")` |
| Random Forest | `vexray.playground("random forest")` |
| Gradient Boosting | `vexray.playground("gradient boosting")` |
| PCA | `vexray.playground("pca")` |
| Regularization | `vexray.playground("regularization")` |
| Bias-Variance | `vexray.playground("bias variance")` |
| Naive Bayes | `vexray.playground("naive bayes")` |
| Activation Functions | `vexray.playground("activations")` |

## Features

- 📈 **Interactive Plotly.js Graphs** — scatter plots, 3D surfaces, contour maps
- 🧪 **Live Playgrounds** — tweak parameters with sliders, see results instantly
- 🧮 **KaTeX Math Rendering** — publication-quality formulas
- 💻 **Syntax-Highlighted Code** — copy-paste-ready Python examples
- 🌙 **Dark / Light Theme** — toggle with one click
- ⚡ **Zero Config** — just `import vexray` and go
