matheel 0.4.1

Matheel: A CLI and Python package for source-code similarity detection.

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.

pip install matheel

Optional semantic, chunking, metrics, and Gradio extras are covered in the usage guide.

Quick Start

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

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, and code metrics.

Links

• Documentation: fahadebrahim.github.io/matheel
• Hugging Face Space demo: buelfhood/matheel-framework
• Gradio Colab notebook: Open in Colab
• Examples Colab notebook: Open in Colab
• Examples folder: examples/
• Development: development docs

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.