# ⚡ 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
