History

Nicolò Boschi 0ae0374dc8 Release v0.1.15 - Update version to 0.1.15 in all components - Python packages: hindsight-api, hindsight-dev, hindsight-all, hindsight-litellm - Python client: hindsight-clients/python - TypeScript client: hindsight-clients/typescript - Rust CLI: hindsight-cli - Control Plane: hindsight-control-plane - Helm chart		2025-12-23 13:54:14 +01:00
..
hindsight	fix: make sure openai provider works + docs updates (#23 )	2025-12-10 16:10:10 +01:00
tests	fix docs on clients	2025-12-11 14:23:56 +01:00
pyproject.toml	Release v0.1.15	2025-12-23 13:54:14 +01:00
README.md	ci: check compatibility with python 3.11, 3.12 and 3.13 (#35 )	2025-12-16 14:28:45 +01:00

README.md

hindsight-all

All-in-one package for Hindsight - Agent Memory That Works Like Human Memory

Quick Start

from hindsight import start_server, HindsightClient

# Start server with embedded PostgreSQL
server = start_server(
    llm_provider="groq",
    llm_api_key="your-api-key",
    llm_model="openai/gpt-oss-120b"
)

# Create client
client = HindsightClient(base_url=server.url)

# Store memories
client.put(agent_id="assistant", content="User prefers Python for data analysis")

# Search memories
results = client.search(agent_id="assistant", query="programming preferences")

# Generate contextual response
response = client.think(agent_id="assistant", query="What languages should I recommend?")

# Stop server when done
server.stop()

Using Context Manager

from hindsight import HindsightServer, HindsightClient

with HindsightServer(llm_provider="groq", llm_api_key="...") as server:
    client = HindsightClient(base_url=server.url)
    # ... use client ...
# Server automatically stops

Installation

pip install hindsight-all