Metadata-Version: 2.4
Name: hermes-memori
Version: 0.1.0
Summary: Official Memori Labs long-term memory provider for Hermes Agent
Author-email: Memori Labs Team <noc@memorilabs.ai>
License-Expression: Apache-2.0
Project-URL: Homepage, https://memorilabs.ai
Project-URL: Documentation, https://memorilabs.ai/docs/
Project-URL: Repository, https://github.com/MemoriLabs/Memori
Project-URL: Bug Tracker, https://github.com/MemoriLabs/Memori/issues
Keywords: hermes-agent,memory,memori,ai-agents,long-term-memory
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: memori>=3.3.3

# Memori for Hermes Agent

Memori gives Hermes Agent structured long-term memory. It captures completed user/assistant exchanges after each turn and exposes explicit tools for memory search, summaries, quota checks, signup, and feedback.

## Requirements

- Hermes Agent with memory provider plugins
- A Memori API key
- Python 3.10+

## Install

From this repository:

```bash
pip install -e .
pip install -e integrations/hermes
```

Or install the published package when available:

```bash
pip install hermes-memori
```

## Configure

Use Hermes' memory setup flow and select `memori`:

```bash
hermes memory setup
```

If `memori` is not listed yet, install `hermes-memori` in the same Python environment Hermes uses, then set the provider manually.

Manual configuration also works:

```bash
hermes config set memory.provider memori
HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
mkdir -p "$HERMES_HOME"
echo "MEMORI_API_KEY=your-key" >> "$HERMES_HOME/.env"
```

Then add `$HERMES_HOME/memori.json`:

```json
{
  "entityId": "your-user-or-workspace-id",
  "projectId": "hermes"
}
```

Environment variables override file config:

- `MEMORI_API_KEY`
- `MEMORI_ENTITY_ID`
- `MEMORI_PROJECT_ID`
- `MEMORI_PROCESS_ID`

## Tools

- `memori_recall`
- `memori_recall_summary`
- `memori_quota`
- `memori_signup`
- `memori_feedback`

## Behavior

The provider is intentionally fail-soft. Memori network failures are logged but do not stop Hermes from answering the user.
