Metadata-Version: 2.4
Name: nexgml
Version: 1.4.0
Summary: NexGML — Next Generation Machine Learning (educational ML utilities)
Author: Nexo-kun
Author-email: nexokun.contact@gmail.com
License: MIT
Project-URL: Homepage, https://github.com/Next-Aura/Nexarians
Project-URL: Documentation, https://github.com/Next-Aura/Nexarians#documentation
Project-URL: Source, https://github.com/Next-Aura/Nexarians
Project-URL: Tracker, https://github.com/Next-Aura/Nexarians/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.23
Requires-Dist: scipy>=1.10
Requires-Dist: typing_extensions
Dynamic: author-email
Dynamic: license-file
Dynamic: requires-python

# Nexarians - The NexGML Core Repository

[![PyPI version](https://badge.fury.io/py/nexgml.svg)](https://pypi.org/project/nexgml/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Next-Aura/Nexarians/blob/main/LICENSE) 

## Installation
```bash
pip install nexgml
```

## 🔬 Core Philosophy: Transparent, Fast, and Modular

NexGML is a custom Machine Learning utility built for educational and research purposes, emphasizing **code transparency** and **high performance**.

### Key Features & Technology Stack
  * **Modular Helpers:** Separates complex logic into focused helper modules (`ForLinear`, `ForTree`, `Indexing`, `Metrics`, `Guardians`) for easy customization.
  * **Sparse Data Ready:** Full support for `scipy.sparse` matrices (CSR/CSC) for memory efficiency.

-----

## 💻 Available Modules & Quick Start

### 1\. Classifiers (The Models)

The primary model is the **Gradient Supported Intense Classifier (GSIC)**.

```python
from nexgml.gradient_supported import IntenseClassifier
import numpy as np

# Load data X, y...

model = IntenseClassifier(
    optimizer='adamw', 
    lr_scheduler='plateau', 
    batch_size=32, 
    penalty='elasticnet'
)
model.fit(X_train, y_train)

print(f"Final Training Loss: {model.loss_history[-1]:.6f}")
```

### 2\. Regressors (The Models)

The primary model is the **Gradient Supported Intense Regressor (GSIR)**.

```python
from nexgml.gradient_supported import IntenseRegressor
import numpy as np

# Load data X, y...

model = IntenseClassifier(
    optimizer='adamw', 
    lr_scheduler='plateau', 
    batch_size=32, 
    penalty='elasticnet'
)
model.fit(X_train, y_train)

print(f"Final Training Loss: {model.loss_history[-1]:.6f}")
```

### 2\. Helper Modules (Performance Backbone)

These modules contain the high-speed math used internally.

| Module | Purpose | Example Usage |
| :--- | :--- | :--- |
| `nexgml.amo.forlinear` | **Linear Criteria.** Activation/Loss functions (Softmax, CCE, RMSE). | `forlinear.softmax(logits)` |
| `nexgml.amo.fortree` | **Tree Criteria.** Impurity measures (Gini, Entropy, Friedman MSE). | `fortree.gini_impurity(labels)` |
| `nexgml.indexing` | **Data Utilities.** One-hot encoding, smart feature slicing (`standard_indexing`). | `indexing.standard_indexing(n_features, 'sqrt')` |
| `nexgml.metrics` | **Model Metrics.** Regressor and classifier models metrics computation (R^2, F1, Accuracy Score) | `accuracy_score(y_true, pred)` |
| `nexgml.guardians` | **Numerical stability**. Value clipping, invalid value detecting (safe_array, hasinf, hasnan) | `safe_array(array)` |

## 📝 Documentation & Exploration

This repository is dedicated to experimentation, learning, and personal research, primarily in the following fields:

- 🤖 Artificial Intelligence and Machine Learning
- 💻 Python development and performance optimization
- 📖 Technical documentation and concept notes

> ⚠️ This project is intended for exploration and learning purposes only.

> If you find this repo helpful or interesting, feel free to fork, star, or open a pull request.  
This is a learning space—no pressure, just passion! 😄
