Metadata-Version: 2.4
Name: hipcortex
Version: 0.2.0
Summary: Persistent causal memory for AI agents — LangChain, LlamaIndex, AutoGen, CrewAI
Author: HipCortex Contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/farmountain/HipCortex
Project-URL: Repository, https://github.com/farmountain/HipCortex
Project-URL: Issues, https://github.com/farmountain/HipCortex/issues
Project-URL: Benchmark, https://github.com/farmountain/HipCortex/blob/main/BENCHMARK.md
Keywords: ai,memory,langchain,autogen,crewai,llm,agents,rag
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Intended Audience :: Developers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Requires-Dist: httpx>=0.27
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1; extra == "langchain"
Provides-Extra: llamaindex
Requires-Dist: llama-index-core>=0.10; extra == "llamaindex"
Provides-Extra: crewai
Requires-Dist: crewai>=0.28; extra == "crewai"
Requires-Dist: crewai-tools>=0.1; extra == "crewai"
Provides-Extra: autogen
Requires-Dist: pyautogen>=0.2; extra == "autogen"
Provides-Extra: benchmark
Requires-Dist: mem0ai>=0.1; extra == "benchmark"
Requires-Dist: tabulate>=0.9; extra == "benchmark"
Provides-Extra: all
Requires-Dist: langchain-core>=0.1; extra == "all"
Requires-Dist: llama-index-core>=0.10; extra == "all"
Requires-Dist: crewai>=0.28; extra == "all"
Requires-Dist: crewai-tools>=0.1; extra == "all"
Requires-Dist: pyautogen>=0.2; extra == "all"
Requires-Dist: mem0ai>=0.1; extra == "all"
Requires-Dist: tabulate>=0.9; extra == "all"
Dynamic: requires-python

# hipcortex

**Persistent causal memory for AI agents — LangChain, LlamaIndex, AutoGen, CrewAI.**

1.74ms p50 write latency. Temporal decay. Causal world model. Merkle-chained audit log. GDPR right-to-forget.

## Install

```bash
pip install hipcortex
```

## Quick start

```python
from hipcortex import HipCortexClient

client = HipCortexClient("http://localhost:3030")

# Store memory
client.add_memory(actor="alice", action="said", target="The meeting is at 3pm")

# Search (keyword or cosine similarity)
results = client.search("meeting time", limit=5)

# Stats
print(client.stats())

# GDPR forget
client.forget("alice")
```

## Framework integrations

```python
# LangChain — drop-in for ConversationBufferMemory
from hipcortex.langchain_memory import HipCortexMemory
memory = HipCortexMemory(session_id="user-42", url="http://localhost:3030")

# LlamaIndex
from hipcortex.llamaindex_storage import HipCortexChatStore
store = HipCortexChatStore(client=client)

# AutoGen
from hipcortex.adapters.autogen import HipCortexAutoGenMemory
mem = HipCortexAutoGenMemory(client=client, agent_id="researcher")
agent.register_hook("process_message_before_send", mem.on_message_sent)

# CrewAI
from hipcortex.adapters.crewai import HipCortexRememberTool, HipCortexRecallTool
tools = [HipCortexRememberTool(client=client), HipCortexRecallTool(client=client)]
```

## Start the server

```bash
# Self-hosted (single binary, zero deps)
cargo run --bin webserver --no-default-features --features "web-server,petgraph_backend"

# Fly.io
fly deploy

# Live demo
https://hipcortex.fly.dev
```

**Full docs:** https://github.com/farmountain/HipCortex
