Skip to main content

SHAP implementation for multimodal large language models supporting audio and text input.

Project description

📦 mllm-shap Package

Core engine for multimodal SHAP attribution in text/audio LLM pipelines.

PyPI Python Docs License

✨ Product Highlights

  • exact and approximate SHAP explainers under single API surface
  • text/audio-ready connector model with typed abstractions
  • configurable normalizers, reducers, similarity backends
  • package-level test and docs structure for stable iteration

📊 Package Snapshot

  • Main modules: connectors, shap, utils
  • Explainability modes: precise + Monte Carlo families + advanced variants
  • Target runtime: Python 3.12

💾 Installation

Install from PyPI:

pip install mllm-shap

Install from source:

git clone https://github.com/Pawlo77/MLLM-Shap.git
cd MLLM-Shap/mllm_shap
pip install .

🧱 Package Layout

  • src/mllm_shap/connectors/ - model and chat connectors
  • src/mllm_shap/shap/ - explainers, attribution internals, result objects
  • src/mllm_shap/utils/ - utility helpers
  • tests/ - package verification suite
  • docs/ - documentation sources

🚀 Usage and Ecosystem

  • notebook workflows: ../examples/README.md
  • experiment runner integration: ../experiments/mllm_shapx/README.md
  • GUI companion for visualization: shap-mllm-explainer

📄 License

Apache License 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mllm_shap-0.1.12.tar.gz (104.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mllm_shap-0.1.12-py3-none-any.whl (150.5 kB view details)

Uploaded Python 3

File details

Details for the file mllm_shap-0.1.12.tar.gz.

File metadata

  • Download URL: mllm_shap-0.1.12.tar.gz
  • Upload date:
  • Size: 104.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mllm_shap-0.1.12.tar.gz
Algorithm Hash digest
SHA256 04dbc3d311a2248126a8dea5d244abe27693e0670571c6ba3c14b2f84bf66ee6
MD5 26ec8305b8017074fd067ec7ae5e2da9
BLAKE2b-256 d8ec29d8ed0c7163909647934adaadbe78e211a0501ce087ed7b534e6760ad3a

See more details on using hashes here.

File details

Details for the file mllm_shap-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: mllm_shap-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 150.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mllm_shap-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 3fe901ca56de3a40a350ce8ee5557544cbf39b50eda6f0534d499d3ad64d9f74
MD5 d396e63c9236c18cf1aef172f6b90541
BLAKE2b-256 3e90bcbf4720b1cf05fb11039356be5c34dde9fa064f47a83ca10b600ed235c7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page