Metadata-Version: 2.4
Name: langchain-keep
Version: 0.1.0
Summary: LangChain integration for keep — reflective memory for AI agents
Project-URL: Homepage, https://keepnotes.ai
Project-URL: Repository, https://github.com/hughpyle/keep
Project-URL: Documentation, https://docs.keepnotes.ai
Author: Hugh Pyle
License-Expression: MIT
Keywords: agents,langchain,langgraph,memory,semantic-search
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: keep-skill[langchain]>=0.44.0
Description-Content-Type: text/markdown

# langchain-keep

LangChain integration for [keep](https://github.com/hughpyle/keep) — reflective memory for AI agents.

This is a convenience package that installs `keep-skill[langchain]` and re-exports the integration components.

## Installation

```bash
pip install langchain-keep
```

## Usage

```python
from langchain_keep import KeepStore, KeepNotesToolkit, KeepNotesRetriever

# LangGraph BaseStore
store = KeepStore()

# LangChain tools
from keep import Keeper
toolkit = KeepNotesToolkit(keeper=Keeper())
tools = toolkit.get_tools()

# RAG retriever
retriever = KeepNotesRetriever(keeper=Keeper(), k=5)
```

## What's included

| Component | Description |
|-----------|-------------|
| `KeepStore` | LangGraph `BaseStore` backed by Keep |
| `KeepNotesToolkit` | 4 LangChain tools (remember, recall, get/set context) |
| `KeepNotesRetriever` | `BaseRetriever` with optional now-context |
| `KeepNotesMiddleware` | LCEL runnable for auto-injecting memory context |

## Configuration

You need an embedding provider configured. Simplest:

```bash
export OPENAI_API_KEY=...    # or GEMINI_API_KEY
```

Or use the hosted service:

```bash
export KEEPNOTES_API_KEY=... # Sign up at https://keepnotes.ai
```

See the [full documentation](https://docs.keepnotes.ai) for all provider options.

## Links

- [Documentation](https://docs.keepnotes.ai)
- [GitHub](https://github.com/hughpyle/keep)
- [keep on PyPI](https://pypi.org/project/keep-skill/)
