eidet-sdk 0.2.0

Python client SDK for Eidet — long-term memory for AI coding agents

eidet-sdk

Python client SDK for Eidet — long-term memory for AI coding agents.

Install

pip install eidet-sdk

Usage

from eidet_sdk import EidetClient, StoreRequest, MemoryType

client = EidetClient()  # defaults to http://localhost:19380

# Store a memory
result = client.store(StoreRequest(
    repo="/path/to/project",
    content="The auth module uses JWT with RS256 signing",
    type=MemoryType.OBSERVATION,
    tags=["auth", "jwt"],
))

# Search memories
results = client.recall("/path/to/project", "authentication")

# Get session context (L0 identity + L1 top memories, < 600 tokens)
context = client.context("/path/to/project")

# Browse all memories
page = client.browse("/path/to/project", skip=0, take=50)

# Feedback loop
client.feedback("memories/...", was_used=True)   # echo (useful)
client.feedback("memories/...", was_used=False)  # fizzle (irrelevant)

Context Manager

with EidetClient(url="http://localhost:19380") as client:
    results = client.recall("/path/to/project", "deployment")

API Key Authentication

client = EidetClient(url="http://localhost:19380", api_key="your-api-key")

All Methods

Method	Description
store(request)	Store a memory (observation, insight, procedure, heuristic)
recall(repo, query, **kwargs)	Search memories by meaning and keywords
context(repo)	Get compact session context (< 600 tokens)
get_memory(id)	Get a specific memory by ID
forget(id, reason?)	Soft-delete a memory
feedback(memory_id, was_used)	Echo (useful) or fizzle (irrelevant) feedback
history(id)	Get version chain for a memory
browse(repo, **kwargs)	Paginated memory listing
graph(repo, limit?)	Graph data for visualization
repos()	List all known repositories
intake(repo)	Ingest project files as seed memories
consolidate(repo)	Merge related observations into insights
maintenance(repo)	Run maintenance pipeline
export_markdown(repo)	Export memories as markdown
health()	Health check
status()	Service status and stats

Requirements

• Eidet service running locally (eidet serve or installed as system service)
• Python 3.10+
• httpx

License

MIT