Matheel

Matheel is a Python package and CLI for source-code similarity. It combines semantic embeddings, lexical similarity, chunking, preprocessing, and code evaluation metrics in one workflow.

Installation

Matheel supports Python 3.10 to 3.13.

Recommended install:

pip install "matheel[all]"

For a lightweight install without optional semantic, chunking, metrics, and Gradio dependencies:

pip install matheel

Installation options are covered in the usage guide.

Quick Start

Create a tiny archive and compare it with the CLI:

python - <<'PY'
from zipfile import ZipFile

with ZipFile("sample_pairs.zip", "w") as archive:
    archive.writestr("a.py", "def add(a, b):\n    return a + b\n")
    archive.writestr("b.py", "def add(x, y):\n    return x + y\n")
    archive.writestr("c.py", "def sub(a, b):\n    return a - b\n")
PY

matheel compare sample_pairs.zip \
  --feature-weight levenshtein=1.0 \
  --num 10

Or score a pair directly from Python:

from matheel.similarity import calculate_similarity

score = calculate_similarity(
    "def add(a, b):\n    return a + b\n",
    "def add(x, y):\n    return x + y\n",
    feature_weights={"levenshtein": 1.0},
)
print(round(score, 4))

See the usage guide for semantic models, archives, comparison suites, custom algorithms, chunking, preprocessing, visualization, leaderboards, and code metrics.

Development

Contributor setup, tests, linting, package checks, and release preparation are documented in the development docs.

License

This project is licensed under the MIT License.

Download files

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

Source Distribution

matheel-0.5.8.tar.gz (314.6 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

matheel-0.5.8-py3-none-any.whl (148.4 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file matheel-0.5.8.tar.gz.

File metadata

Download URL: matheel-0.5.8.tar.gz
Upload date: Aug 11, 2026
Size: 314.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for matheel-0.5.8.tar.gz
Algorithm	Hash digest
SHA256	`ec7ec3b15b724ab94d33d62054df76bd0d8f1bfaa30c6a6c01127f793dd01b7e`
MD5	`683b7b608d843f603ab2de61c9963496`
BLAKE2b-256	`f699d848d59f65bf4a717db04c7a33fbe258223e1deec23b7cd913070e4e4cdb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for matheel-0.5.8.tar.gz:

Publisher: publish.yml on FahadEbrahim/matheel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: matheel-0.5.8.tar.gz
- Subject digest: ec7ec3b15b724ab94d33d62054df76bd0d8f1bfaa30c6a6c01127f793dd01b7e
- Sigstore transparency entry: 2426195368
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: FahadEbrahim/matheel@5b3cea5162000ce98c41f71efa4efa0427e4466d
- Branch / Tag: refs/tags/v0.5.8
- Owner: https://github.com/FahadEbrahim
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@5b3cea5162000ce98c41f71efa4efa0427e4466d
- Trigger Event: release