Metadata-Version: 2.4
Name: flumes-ai
Version: 0.1.0
Summary: Flumes – unified memory infrastructure SDK for AI agents
Author-email: Flumes AI <alex@flumes.ai>
License: Apache-2.0
Requires-Python: >=3.9
Requires-Dist: httpx<1,>=0.27
Requires-Dist: openai>=1
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: hatchling; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# Flumes Python SDK

Flumes is the unified memory infrastructure for AI agents.

```bash
# Install the SDK (includes OpenAI client by default)
pip install flumes-ai
```

## Quickstart

```python
from flumes.agent import Agent

agent = Agent(agent_id="sales_assistant")

agent.remember("We're targeting $1 M ARR by Q4.")
print(agent.chat("What's our current goal?"))
```

## Low-level CRUD

```python
from flumes import MemoryClient

mc = MemoryClient()
mc.add(messages=[{"role": "user", "content": "buy milk"}], user_id="u_1")
results = mc.search(user_id="u_1", query="milk")
```

## API keys

| Service | Env var | Example |
|---------|---------|---------|
| Flumes  | `FLUMES_API_KEY` | `export FLUMES_API_KEY=sk_live_...` |
| OpenAI  | `OPENAI_API_KEY` | `export OPENAI_API_KEY=sk-...` |

Pass `api_key="..."` to `MemoryClient` if you prefer not to use environment variables.

---

*Built with ❤️ by the Flumes team – join us on the journey to make agents truly memory-aware.*
