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

MIT License.

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.11.tar.gz (104.7 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.11-py3-none-any.whl (150.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mllm_shap-0.1.11.tar.gz
  • Upload date:
  • Size: 104.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","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.11.tar.gz
Algorithm Hash digest
SHA256 79c1c7455b9d78e9401994d1e990da65ad5cda2a4bdc824dc114491d73ee4e19
MD5 01cc5e4efc7a4a44a66b947f0421ac2e
BLAKE2b-256 a20de6dd88391758d94617cb47929743e93b8dc7c72adb5fd20cb2cbb732f6f9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mllm_shap-0.1.11-py3-none-any.whl
  • Upload date:
  • Size: 150.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","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.11-py3-none-any.whl
Algorithm Hash digest
SHA256 201dc68809b53cb6023e86bd51433683f3ca56524d92ee1cbd659b50beb23b5c
MD5 9590a51ab9da8c8fed2f36157781f5d9
BLAKE2b-256 db5c40b72374dcb19c04ec025affbbde8e333000c1f6392a80bc54dd33b1020d

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