==================
👨‍🎓 Tutorials
==================

**Puncc** offers hands-on notebooks to help you go from 
*"hello conformal prediction"* to more advanced workflows 
(NLP, object detection, and time series). 
Pick a tutorial below and run it either on GitHub or in Google Colab.

.. list-table:: 
   :widths: 26 26 26
   :header-rows: 1

   * - Tutorial
     - Description
     - Link
   * - **Introduction Tutorial**
     - Get started with the basics of *puncc*.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_intro.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_intro.ipynb>`__
   * - **API Tutorial**
     - Learn about *puncc*'s API.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/api_intro.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/api_intro.ipynb>`__
   * - **Tutorial on CP with PyTorch**
     - Learn how to use *puncc* with PyTorch.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_pytorch.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_pytorch.ipynb>`__
   * - **Conformal Object Detection**
     - Learn to conformalize an object detector.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_cod.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_cod.ipynb>`__
   * - **Conformal Text Classification**
     - Learn to conformalize a pretrained NLP model.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_nlp.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_nlp.ipynb>`__
   * - **Conformal Time Series Forecasting**
     - Learn to conformalize time series models.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_timeseries.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_timeseries.ipynb>`__
   * - **Architecture Overview**
     - Detailed overview of *puncc*'s architecture.
     - `Github <https://github.com/deel-ai/puncc/blob/main/docs/puncc_architecture.ipynb>`__ or `colab <https://githubtocolab.com/deel-ai/puncc/blob/main/docs/puncc_architecture.ipynb>`__

How to use these notebooks
--------------------------

- **Run on Colab** if you want a zero-install experience (recommended for a quick start).
- **Run locally** if you want full control over your environment and dependency versions.