Metadata-Version: 2.4
Name: alethe
Version: 0.1.0
Summary: AI-powered code explainer and semantic diff tool
Home-page: https://github.com/lilscolari/alethe
Author: Cameron Scolari
Author-email: cameronscolari@outlook.com
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: transformers
Requires-Dist: torch
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: isort; extra == "dev"
Dynamic: license-file

# Alethe

Alethe is an AI-powered code explainer and semantic diff tool. It generates human-readable markdown explanations for Python files and compares different versions to highlight semantic changes.

## Features

- Generate markdown explanations of Python code.
- Track file versions and compute semantic diffs between explanations.
- Works with local Hugging Face models or a stub mode for offline testing.
- CLI interface for easy usage.

## Installation

You can install Alethe from PyPI:

```bash
pip install alethe
```

## Usage

Basic CLI usage:

```bash
alethe explain path/to/file.py
alethe summary path/to/file.py
alethe diff path/to/file.py v1 v2
alethe list path/to/file.py
alethe rename old_file.py new_file.py
alethe getpath <file_id>
```

### Example

Generate an explanation for **example.py**:

```bash
alethe explain example.py
```
