nlp-shap 0.1.5

Multimodal explainability tool for NLP based on Shapley value.

📦 nlp-shap

Multimodal explainability for NLP and multimodal models based on Shapley-style cooperative game theory.

Installation

pip install nlp-shap

From source:

git clone https://github.com/Pawlo77/nlp-shap
cd nlp-shap
make install

Requires Python 3.12 and uv.

Documentation

Full documentation: pawlo77.github.io/nlp-shap

• Getting started
• User guide — estimands
• User guide — masking
• User guide — runtime
• User guide — exact estimation
• Examples (notebooks)
• API reference

Examples

Runnable Jupyter notebooks in examples/:

Notebook	What it demonstrates
estimands_toy_game.ipynb	Shapley vs Banzhaf aggregators, coalition weights, labelled results, manifests, plugin entry points
masking_views.ipynb	Token partitioning, absence policies, masked views, mask codec, mask space, plugin registry
runtime_core.ipynb	Run archive, coalition dedup, hot LRU cache, async scheduler with bounded concurrency
exact_estimation.ipynb	Exact coalition enumeration, estimand delegation, budget guard, plugin resolution

Setup and details: examples/README.md. Embedded walkthroughs: docs/examples.

Development

make install
make check

Run make help for other targets.

License

Apache License 2.0. See LICENSE.

Copyright 2026 Paweł Pozorski.