Metadata-Version: 2.4
Name: fasterai
Version: 0.3.2
Summary: A library to make neural networks lighter and faster with fastai
Author-email: Nathan Hubens <nathan.hubens@gmail.com>
License-Expression: Apache-2.0
Project-URL: Repository, https://github.com/FasterAI-Labs/fasterai
Project-URL: Documentation, https://FasterAI-Labs.github.io/fasterai/
Keywords: pruning,sparsification,knowledge-distillation,quantization,compression,deep-learning
Classifier: Natural Language :: English
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastai>=2.2
Requires-Dist: torch-pruning>=1.2
Requires-Dist: einops
Dynamic: license-file

![header](https://capsule-render.vercel.app/api?type=waving&color=f97315&height=300&section=header&text=FasterAI%20&fontSize=90&animation=fadeIn&fontAlignY=38&desc=A%20Library%20to%20make%20smaller%20and%20faster%20neural%20networks&descAlignY=51&descAlign=62)

<p align="center">
    <a href="https://pypi.org/project/fasterai/"><img src="https://img.shields.io/pypi/v/fasterai?color=black"></a>
    <a href="https://pypi.org/project/fasterai/"><img src="https://static.pepy.tech/personalized-badge/fasterai?color=black&period=total&units=international_system&left_color=grey&right_color=black&left_text=downloads"></a>
    <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/github/license/FasterAI-Labs/fasterai?color=black"></a>
    <a href="https://pypi.org/project/fasterai/"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.6469868-y?color=black"></a>
    <a href="https://github.com/FasterAI-Labs/fasterai/actions/workflows/test.yaml"><img src="https://img.shields.io/github/actions/workflow/status/FasterAI-Labs/fasterai/test.yaml?color=black"></a>
    <a href="https://github.com/FasterAI-Labs/fasterai"><img src="https://img.shields.io/github/stars/FasterAI-Labs/fasterai?color=black"></a>
</p>






<p align="center">
  <a href="#features">Features</a> •
  <a href="#installation">Installation</a> •
  <a href="#tutorials">Tutorials</a> •
  <a href="#join-the-community">Community</a> •
  <a href="#citing">Citing</a> •
  <a href="#license">License</a>
</p>

## Overview

fasterAI is a PyTorch-based library that makes neural networks **smaller**, **faster**, and **more efficient** through state-of-the-art compression techniques. The library provides simple but powerful implementations of pruning, knowledge distillation, quantization, and other network optimization methods that can be applied with just a few lines of code.

Why compress your models with fasterai?

* **Reduce model size** by up to 90% with minimal accuracy loss
* **Speed up inference** for deployment on edge devices
* **Lower energy consumption** for more sustainable AI
* **Simplify architectures** while maintaining performance


<div align="center">
  <img src="nbs/imgs/rm_benchmark.png" alt="Performance Improvements"/>
</div>



---

##  Features

### 1. Sparsification

<div align="center">
  <img src="nbs/imgs/rm_sparse.png" width="60%" alt="Sparsification"/>
</div>

Make your model sparse by replacing selected weights with zeros using `Sparsifier` or `SparsifyCallback`.

|Parameter|Description|Options|
|---|---|---|
|`sparsity`|Percentage of weights to zero out|0-100%|
|`granularity`|Level at which to apply sparsity|'weight', 'vector', 'kernel', 'filter'|
|`context`|Scope of sparsification|'local' (per layer), 'global' (whole model)|
|`criteria`|Method to select weights|'magnitude', 'movement', 'gradient', etc.|
|`schedule`|How sparsity evolves during training|'one_shot', 'iterative', 'gradual', etc.|

### 2. Pruning

<div align="center">
  <img src="nbs/imgs/rm_prune.png" width="60%" alt="Pruning"/>
</div>

Remove zero-weight nodes from your network structure using `Pruner` or `PruneCallback`.

|Parameter|Description|Options|
|---|---|---|
|`pruning_ratio`|Percentage of weights to remove|0-100%|
|`context`|Scope of sparsification|'local' (per layer), 'global' (whole model)|
|`criteria`|Method to select weights|'magnitude', 'movement', 'gradient', etc.|
|`schedule`|How sparsity evolves during training|'one_shot', 'iterative', 'gradual', etc.|

### 3. Knowledge Distillation

<div align="center">
  <img src="nbs/imgs/rm_distill.png" width="60%" alt="Distillation"/>
</div>

Transfer knowledge from a large teacher to a smaller student using `KnowledgeDistillationCallback`.

|Parameter|Description|Options|
|---|---|---|
|`teacher`|Teacher model|Any PyTorch model|
|`loss`|Distillation loss function|'SoftTarget', 'Logits', 'Attention', etc.|
|`activations_student`|Student layers to match|Layer names as strings|
|`activations_teacher`|Teacher layers to match|Layer names as strings|
|`weight`|Balancing weight for distillation|0.0-1.0|

### 4. Regularization

<div align="center">
  <img src="nbs/imgs/rm_regularize.png" width="60%" alt="Regularization"/>
</div>

Push weights toward zero during training using `RegularizeCallback`.

|Parameter|Description|Options|
|---|---|---|
|`criteria`|Regularization criteria|Same as sparsification criteria|
|`granularity`|Level of regularization|Same as sparsification granularity|
|`weight`|Regularization strength|Floating point value|
|`schedule`|How sparsity evolves during training|'one_shot', 'iterative', 'gradual', etc.|
|`layer_types`|Layer types to regularize|'nn.Conv2d', 'nn.Linear', etc.|

### 5. Quantization

<div align="center">
  <img src="nbs/imgs/rm_quant.png" width="60%" alt="Quantization"/>
</div>

Reduce the precision of weights and activations using `Quantizer` or `QuantizeCallback`.

| Parameter        | Description                   | Options                    |
| ---------------- | ----------------------------- | -------------------------- |
| `backend`        | Target backend                | 'x86', 'qnnpack'           |
| `method`         | Quantization method           | 'static', 'dynamic', 'qat' |
| `use_per_tensor` | Force per-tensor quantization | True/False                 |


---

##  Quick Start

This is how easy it is to induce Sparsification in your PyTorch model:

```python
from fasterai.sparse.all import *

learn = vision_learner(dls, model)
learn.fit_one_cycle(n_epochs, cbs=SparsifyCallback(sparsity, granularity, context, criteria, schedule))
```

---

##  Installation


```
pip install git+https://github.com/FasterAI-Labs/fasterai.git
```

or 

```
pip install fasterai
```

---

## Tutorials

- [Get Started with FasterAI](https://FasterAI-Labs.github.io/fasterai/quickstart.html)
- [Create your own pruning schedule](https://FasterAI-Labs.github.io/fasterai/tutorial.schedules.html)
- [Find winning tickets using the Lottery Ticket Hypothesis](https://FasterAI-Labs.github.io/fasterai/tutorial.lottery_ticket.html)
- [Use Knowledge Distillation to help a student model to reach higher performance](https://FasterAI-Labs.github.io/fasterai/tutorial.knowledge_distillation.html)
- [Sparsify Transformers](https://FasterAI-Labs.github.io/fasterai/tutorial.transformers.html)
- Many more !

---


## Join the community

Join [our discord server](https://discord.gg/32BwhJSB9u) to meet other FasterAI users and share your projects!

---

##  Citing
```
@software{Hubens,
  author       = {Nathan Hubens},
  title        = {fasterai},
  year         = 2022,
  publisher    = {Zenodo},
  version      = {v0.3.0},
  doi          = {10.5281/zenodo.6469868},
  url          = {https://doi.org/10.5281/zenodo.6469868}
}
```

---

## License

[Apache-2.0](https://www.apache.org/licenses/) License.

![footer](https://capsule-render.vercel.app/api?type=waving&color=f97315&height=100&section=footer)
