Metadata-Version: 2.4
Name: simplegrade
Version: 0.1.5
Summary: A lightweight PyTorch-inspired autograd library built from scratch
Home-page: https://github.com/mohamedrxo/simplegrad
Author: Mohamed Rachoum
Author-email: YOUR_EMAIL@example.com
License: MIT
Project-URL: Source, https://github.com/mohamedrxo/simplegrad
Project-URL: Bug Tracker, https://github.com/mohamedrxo/simplegrad/issues
Project-URL: PyPI, https://pypi.org/project/simplegrade/
Keywords: python,deep-learning,machine-learning,autograd,neural-networks,pytorch,tensor,education,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# SimpleGrade

[![PyPI version](https://img.shields.io/pypi/v/simplegrade)](https://pypi.org/project/simplegrade/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/simplegrade)](https://pypi.org/project/simplegrade/)
[![GitHub stars](https://img.shields.io/github/stars/mohamedrxo/simplegrad?style=social)](https://github.com/mohamedrxo/simplegrad)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

SimpleGrade is a lightweight Python library inspired by PyTorch and Tinygrad. It provides automatic differentiation and the core components required to build and train neural networks from scratch, making it an educational framework for understanding how deep learning libraries work internally.

## Installation

Install the latest release from PyPI:

```bash
pip install simplegrade
```

Or install the latest development version from GitHub:

```bash
git clone https://github.com/mohamedrxo/simplegrad.git
cd simplegrad
pip install -e .
```

## Features

- Automatic differentiation (Autograd)
- Tensor operations
- Neural network building blocks
- Linear layers
- Loss functions
- SGD optimizer
- DataLoader
- NumPy-based implementation
- Lightweight and easy to understand

## Example

```python
from simplegrade import Tensor

a = Tensor([[1, 2, 3]], requires_grad=True)
b = Tensor([[2, 1, 0]], requires_grad=True)

c = a + b
d = a * b
loss = d.sum()

loss.backward()

print("Loss:", loss)
print("Gradient of a:", a.grad)
print("Gradient of b:", b.grad)
```

## Project Links

- **PyPI:** https://pypi.org/project/simplegrade/
- **GitHub:** https://github.com/mohamedrxo/simplegrad
- **Issues:** https://github.com/mohamedrxo/simplegrad/issues

## Contributing

Contributions, bug reports, feature requests, and suggestions are welcome. If you find this project useful, consider starring the repository on GitHub.
