Metadata-Version: 2.4
Name: elja
Version: 0.1.0
Summary: A relentless, fully-customizable LLM agent harness built on Pydantic AI. Under active development.
License: MIT
License-File: LICENSE
Author: Ben Ballintyn
Author-email: benballintyn@gmail.com
Requires-Python: >=3.11,<3.14
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Dist: loguru (>=0.7,<1)
Requires-Dist: pydantic-ai-slim[mcp,openai] (>=2.36,<3)
Requires-Dist: pydantic-settings (>=2.0,<3)
Project-URL: Repository, https://github.com/benballintyn/elja
Description-Content-Type: text/markdown

# elja

*Elja* (Icelandic): relentless drive — the quality of working at something without letting up.

A fully-customizable LLM agent harness built on [Pydantic AI](https://ai.pydantic.dev), designed
for local-first models (LM Studio / OpenAI-compatible endpoints) with first-class support for
tools, skills, sub-agents, MCP servers, and custom context management.

**Status: under active development.** The first usable version is coming.

## Installation

```bash
pip install elja
```

## Development

```bash
poetry install --with dev
poetry run pre-commit install
```

Run checks:

```bash
poetry run ruff check src tests
poetry run mypy
poetry run pytest -m "not integration"
```

Integration tests (`-m integration`) require a running LM Studio server at
`http://localhost:1234/v1`.

## License

MIT

