Metadata-Version: 2.4
Name: maton
Version: 0.1.0
Summary: Self-improving personal agent with git-native memory
Keywords: agent,autonomous,git,llm,local
Author: Ellis Low
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: openai>=1.0.0
Requires-Dist: typer
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/Lifto/Maton
Project-URL: Repository, https://github.com/Lifto/Maton
Project-URL: Changelog, https://github.com/Lifto/Maton/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

# Maton

Self-improving personal agent with git-native memory and human-auditable reasoning.

## Install

```bash
uv tool install maton
```

Or with pip:

```bash
pip install maton
```

## Quick Start

```bash
# Create a maton
maton init my-maton

# Ask it something
maton ask my-maton "what's your name?"
```

## How It Works

A maton is a git repository. Its state is its files. Every change is a commit.
Point an LLM at it and it can read itself, understand itself, and act.

## Requirements

- Python 3.12+
- An OpenAI-compatible LLM endpoint (e.g., [oMLX](https://github.com/jundot/omlx) for local inference)
