Metadata-Version: 2.5
Name: lerev
Version: 2.6.0
Summary: Universal agent learning and memory system
Project-URL: Homepage, https://github.com/dkshs/lerev
Project-URL: Documentation, https://github.com/dkshs/lerev/tree/main/docs
Project-URL: Repository, https://github.com/dkshs/lerev
Project-URL: Issues, https://github.com/dkshs/lerev/issues
Author: Lerev Contributors
License-Expression: MIT
License-File: LICENSE
Keywords: ai,coding-agent,harness,learning,machine-learning,memory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: pydantic<3.0,>=2.0
Provides-Extra: all
Requires-Dist: beautifulsoup4>=4.12; extra == 'all'
Requires-Dist: fastembed>=0.8.0; extra == 'all'
Requires-Dist: httpx>=0.27; extra == 'all'
Requires-Dist: mypy>=1.10; extra == 'all'
Requires-Dist: pytest-asyncio>=0.23; extra == 'all'
Requires-Dist: pytest-cov>=5.0; extra == 'all'
Requires-Dist: pytest>=8.0; extra == 'all'
Requires-Dist: ruff>=0.5; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: semantic
Requires-Dist: fastembed>=0.8.0; extra == 'semantic'
Provides-Extra: web
Requires-Dist: beautifulsoup4>=4.12; extra == 'web'
Requires-Dist: httpx>=0.27; extra == 'web'
Description-Content-Type: text/markdown

# Lerev

Universal AI-agent learning and long-term memory system.

Lerev gives coding agents persistent, project-scoped memory that survives restarts.

## Install

```bash
pip install lerev
lerev install
```

Then start your coding agent in any project — Lerev connects automatically.

## What Lerev Does

- Long-term memory across sessions
- Project isolation (memories never leak between projects)
- Session and agent awareness
- Injection detection and security boundaries
- Works with OpenCode, Claude Code, Codex, and others

## How It Works

```
Your coding agent
    │
    ▼
Lerev plugin (auto-discovered)
    │
    ▼
Python bridge (JSON over stdin/stdout)
    │
    ▼
Lerev V2.6 memory engine
    ├── MemoryManager
    ├── Security
    ├── Persistence (project-scoped)
    └── MemoryStore
```

Memory is stored in `.lerev/memory/` per project.

## CLI

```bash
lerev --help        # Show commands
lerev version       # Print version
lerev status        # Show installation status
lerev doctor        # Run diagnostics
lerev install       # Register agent plugin
lerev uninstall     # Remove agent plugin
```

## Other Install Methods

- **Windows installer**: Download `Lerev-Setup.exe` from [releases](https://github.com/dex34132-web/lerev/releases)
- **Chocolatey**: `choco install lerev`
- **Homebrew**: `brew install lerev`
- **Linux**: `curl -fsSL https://lerev.dev/install.sh | sh`
- **Development**: `git clone https://github.com/dex34132-web/lerev.git && pip install -e .`

See [docs/installation.md](docs/installation.md) for details.

## Development

```bash
pip install -e ".[dev]"
pytest
ruff check .
mypy core/
```

## License

MIT — see [LICENSE](LICENSE).
