https://github.com/kempnerinstitute/lueur
👋 A quiet light in the black box, Lueur is a lightweight framework for Neuro Interpretability.
https://github.com/kempnerinstitute/lueur
computer-vision interpretability neuroscience
Last synced: 11 months ago
JSON representation
👋 A quiet light in the black box, Lueur is a lightweight framework for Neuro Interpretability.
- Host: GitHub
- URL: https://github.com/kempnerinstitute/lueur
- Owner: KempnerInstitute
- License: mit
- Created: 2025-07-28T03:28:35.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-28T07:01:38.000Z (11 months ago)
- Last Synced: 2025-07-28T08:12:54.890Z (11 months ago)
- Topics: computer-vision, interpretability, neuroscience
- Language: Python
- Homepage: https://KempnerInstitute.github.io/lueur/
- Size: 2.61 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
# Lueur
**Lueur** (pronounced *ly.œʁ*) means "faint glow" in French. It is a minimal, modular toolbox for NeuroInterpretability.
Lueur is intended for researchers interested in understanding representations in artificial neural networks, particularly in contexts inspired by neuroscience. It collects a set of lightweight tools for attribution, feature visualization and concept extraction.
While deep networks are not biological systems, their internal structures often raise questions that intersect with those asked in cognitive science and neuroscience. As such models become more capable, it is increasingly important to study not only what they achieve, but how they structure information, and what kinds of functions they implicitly compute.
Lueur provides a small, hackable set of tools to aid in that investigation.
## Scope
Lueur is built around PyTorch and provides tools for:
- Attribution methods (saliency, integrated gradients, smoothgrads, rise, ...)
- Feature visualization (fourier, maco, ...)
- Sparse dictionary learning (SAE variants for concept extraction)
- Visualization and analysis utilities
- Tutorials and reproducible interpretability workflows
## Notebooks and Tutorials
The main companion notebooks and reports are hosted in the following repository:
[serre-lab/ExplainableNeuro](https://github.com/serre-lab/ExplainableNeuro)
## Installation
```bash
pip install lueur-torch
```
# 👏 Credits
This work has been made possible in part by the generous support provided by the Kempner Institute at Harvard University. The institute, established through a gift from the Chan Zuckerberg Initiative Foundation, is dedicated to advancing research in natural and artificial intelligence. The resources and commitment of the Kempner Institute have been instrumental in the development and completion of this project.
# Authors
- [Thomas Fel](https://thomasfel.me) - tfel@g.harvard.edu, Kempner Research Fellow, Harvard University.