Release v0.4.8

- Update version to 0.4.8 in all components
- Regenerate OpenAPI spec and client SDKs
- Python packages: hindsight-api, hindsight-dev, hindsight-all, hindsight-litellm, hindsight-embed
- Python client: hindsight-clients/python
- TypeScript client: hindsight-clients/typescript
- Rust CLI: hindsight-cli
- Control Plane: hindsight-control-plane
- OpenClaw integration: hindsight-integrations/openclaw
- Helm chart
- Sync documentation to version-0.4
This commit is contained in:
Nicolò Boschi 2026-02-03 13:51:30 +01:00
parent 794a7435a9
commit 21b25fe8fe
100 changed files with 346 additions and 125 deletions

View file

@ -2,8 +2,8 @@ apiVersion: v2
name: hindsight
description: Hindsight helm chart
type: application
version: 0.4.7
appVersion: "0.4.7"
version: 0.4.8
appVersion: "0.4.8"
keywords:
- ai
- memory

View file

@ -46,4 +46,4 @@ __all__ = [
"RemoteTEICrossEncoder",
"LLMConfig",
]
__version__ = "0.4.7"
__version__ = "0.4.8"

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-api"
version = "0.4.7"
version = "0.4.8"
description = "Hindsight: Agent Memory That Works Like Human Memory"
readme = "README.md"
requires-python = ">=3.11"

View file

@ -1,6 +1,6 @@
[package]
name = "hindsight-cli"
version = "0.4.7"
version = "0.4.8"
edition = "2021"
authors = ["Hindsight Team"]
description = "A beautiful CLI for Hindsight - semantic memory system"

View file

@ -7,7 +7,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.
@ -489,7 +489,7 @@ class Configuration:
return "Python SDK Debug Report:\n"\
"OS: {env}\n"\
"Python Version: {pyversion}\n"\
"Version of the API: 0.4.7\n"\
"Version of the API: 0.4.8\n"\
"SDK Package Version: 0.0.7".\
format(env=sys.platform, pyversion=sys.version)

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -6,7 +6,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.7
The version of the OpenAPI document: 0.4.8
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -1,6 +1,6 @@
[project]
name = "hindsight-client"
version = "0.4.7"
version = "0.4.8"
description = "Python client for Hindsight - Semantic memory system with personality-driven thinking"
authors = [
{name = "Hindsight Team"}

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-client",
"version": "0.4.7",
"version": "0.4.8",
"description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
"main": "./dist/src/index.js",
"types": "./dist/src/index.d.ts",

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-control-plane",
"version": "0.4.7",
"version": "0.4.8",
"description": "Control plane for Hindsight - Semantic memory system",
"bin": {
"hindsight-control-plane": "./bin/cli.js"

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-dev"
version = "0.4.7"
version = "0.4.8"
description = "Development utilities for Hindsight"
requires-python = ">=3.11"
dependencies = [

View file

@ -10,7 +10,7 @@
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0.html"
},
"version": "0.4.7"
"version": "0.4.8"
},
"paths": {
"/health": {

View file

@ -61,7 +61,7 @@ hindsight-admin run-db-migration --schema tenant_acme
| Variable | Description | Default |
|----------|-------------|---------|
| `HINDSIGHT_API_LLM_PROVIDER` | Provider: `openai`, `anthropic`, `gemini`, `groq`, `ollama`, `lmstudio`, `vertexai` | `openai` |
| `HINDSIGHT_API_LLM_PROVIDER` | Provider: `openai`, `openai-codex`, `claude-code`, `anthropic`, `gemini`, `groq`, `ollama`, `lmstudio`, `vertexai` | `openai` |
| `HINDSIGHT_API_LLM_API_KEY` | API key for LLM provider | - |
| `HINDSIGHT_API_LLM_MODEL` | Model name | `gpt-5-mini` |
| `HINDSIGHT_API_LLM_BASE_URL` | Custom LLM endpoint | Provider default |
@ -120,8 +120,22 @@ export HINDSIGHT_API_LLM_PROVIDER=openai
export HINDSIGHT_API_LLM_BASE_URL=https://your-endpoint.com/v1
export HINDSIGHT_API_LLM_API_KEY=your-api-key
export HINDSIGHT_API_LLM_MODEL=your-model-name
# OpenAI Codex (ChatGPT Plus/Pro subscription - uses OAuth, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
export HINDSIGHT_API_LLM_MODEL=gpt-5.2-codex
# No API key needed - uses OAuth tokens from ~/.codex/auth.json
# Claude Code (Claude Pro/Max subscription - uses OAuth, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
# No API key needed - uses claude auth login credentials
```
:::tip OpenAI Codex & Claude Code Setup
For detailed setup instructions for **OpenAI Codex** (ChatGPT Plus/Pro) and **Claude Code** (Claude Pro/Max), see the [Models documentation](./models#openai-codex-setup-chatgpt-pluspro).
:::
#### Vertex AI Setup
Google Cloud's Vertex AI provides access to Gemini models via the native Google GenAI SDK. Hindsight supports two authentication methods:

View file

@ -47,6 +47,46 @@ The following models have been tested and verified to work correctly with Hindsi
| **Groq** | `openai/gpt-oss-120b` |
| **Groq** | `openai/gpt-oss-20b` |
### Provider Default Models
Each provider has a recommended default model that's used when `HINDSIGHT_API_LLM_MODEL` is not explicitly set. This makes configuration simpler - just specify the provider and get a sensible default:
| Provider | Default Model |
|----------|--------------|
| `openai` | `o3-mini` |
| `anthropic` | `claude-haiku-4-5-20251001` |
| `gemini` | `gemini-2.5-flash` |
| `groq` | `openai/gpt-oss-120b` |
| `ollama` | `gemma3:12b` |
| `lmstudio` | `local-model` |
| `vertexai` | `gemini-2.0-flash-001` |
| `openai-codex` | `gpt-5.2-codex` |
| `claude-code` | `claude-sonnet-4-5-20250929` |
**Example:** Setting just the provider uses its default model:
```bash
# Uses claude-haiku-4-5-20251001 automatically
export HINDSIGHT_API_LLM_PROVIDER=anthropic
export HINDSIGHT_API_LLM_API_KEY=sk-ant-xxxxxxxxxxxx
```
You can override the default by explicitly setting `HINDSIGHT_API_LLM_MODEL`:
```bash
# Override to use Sonnet instead
export HINDSIGHT_API_LLM_PROVIDER=anthropic
export HINDSIGHT_API_LLM_API_KEY=sk-ant-xxxxxxxxxxxx
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
```
This also applies to per-operation overrides:
```bash
# Global: OpenAI o3-mini (default)
export HINDSIGHT_API_LLM_PROVIDER=openai
# Retain: Anthropic claude-haiku-4-5-20251001 (default)
export HINDSIGHT_API_RETAIN_LLM_PROVIDER=anthropic
```
### Using Other Models
Other LLM models not listed above may work with Hindsight, but they must support **at least 65,000 output tokens** to ensure reliable fact extraction. If you need support for a specific model that doesn't meet this requirement, please [open an issue](https://github.com/hindsight-ai/hindsight/issues) to request an exception.
@ -89,6 +129,148 @@ export HINDSIGHT_API_LLM_MODEL=your-local-model
---
### OpenAI Codex Setup (ChatGPT Plus/Pro)
Use your ChatGPT Plus or Pro subscription for Hindsight without separate OpenAI Platform API costs.
**Prerequisites:**
- Active ChatGPT Plus or Pro subscription
- Node.js/npm installed (for Codex CLI)
**Setup Steps:**
1. **Install Codex CLI:**
```bash
npm install -g @openai/codex
```
2. **Login with ChatGPT credentials:**
```bash
codex auth login
```
This opens a browser window to authenticate with your ChatGPT account and saves OAuth tokens to `~/.codex/auth.json`.
3. **Verify authentication:**
```bash
ls ~/.codex/auth.json # Should show the auth file exists
```
4. **Configure Hindsight:**
```bash
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
export HINDSIGHT_API_LLM_MODEL=gpt-5.2-codex # or gpt-5.1-codex
# No API key needed - reads from ~/.codex/auth.json automatically
```
5. **Start Hindsight:**
```bash
./scripts/dev/start-api.sh
```
**Available Models:**
- `gpt-5.2-codex` - Latest frontier agentic coding model (default)
- `gpt-5.2` - Latest frontier model
- `gpt-5.1-codex` - Previous generation coding model
- `gpt-5.1-codex-max` - Maximum context variant
- `gpt-5.1-codex-mini` - Lightweight variant
**Important Notes:**
- OAuth tokens are stored in `~/.codex/auth.json`
- Tokens refresh automatically when needed
- Usage is billed to your ChatGPT subscription (not separate API costs)
- For personal development use only (see ChatGPT Terms of Service)
**Troubleshooting:**
If authentication fails:
```bash
# Re-login to refresh tokens
codex auth login
# Check auth file exists and has correct format
cat ~/.codex/auth.json | python3 -c "import json, sys; d=json.load(sys.stdin); print('auth_mode:', d.get('auth_mode')); print('has tokens:', 'tokens' in d)"
```
---
### Claude Code Setup (Claude Pro/Max)
Use your Claude Pro or Max subscription for Hindsight without separate Anthropic API costs.
**Prerequisites:**
- Active Claude Pro or Max subscription
- Claude Code CLI installed
**Setup Steps:**
1. **Install Claude Code CLI:**
```bash
npm install -g @anthropics/claude-code
# Or via Homebrew
brew install anthropics/claude-code/claude-code
```
2. **Login with Claude credentials:**
```bash
claude auth login
```
This opens a browser window to authenticate with your Claude account. Authentication is automatically managed by the Claude Agent SDK.
3. **Verify authentication:**
```bash
claude --version
# Should show version without errors
```
4. **Configure Hindsight:**
```bash
export HINDSIGHT_API_LLM_PROVIDER=claude-code
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
# No API key needed - uses claude auth login credentials
```
5. **Start Hindsight:**
```bash
./scripts/dev/start-api.sh
```
**Available Models:**
- `claude-sonnet-4-5-20250929` - Latest Claude Sonnet (default)
- `claude-opus-4-20250514` - Claude Opus for complex tasks
- `claude-sonnet-3-5-20241022` - Previous generation Sonnet
- Any model supported by Claude Code CLI
**Important Notes:**
- Authentication handled by Claude Agent SDK (uses bundled CLI)
- Credentials managed securely by Claude Code
- Usage billed to your Claude subscription (not separate API costs)
- Includes Claude Agent SDK as dependency (auto-installed)
- For personal development use only (see Claude Terms of Service)
**Troubleshooting:**
If authentication fails:
```bash
# Re-login to refresh credentials
claude auth login
# Check Claude CLI is working
claude --version
# Test authentication directly
claude query "test"
```
If the SDK is not found:
```bash
# Install Claude Agent SDK
pip install claude-agent-sdk
# Or with uv
uv add claude-agent-sdk
```
---
## Embedding Model
Converts text into dense vector representations for semantic similarity search.

View file

@ -26,6 +26,12 @@ export GEMINI_API_KEY="your-key"
# Option D: Groq (uses openai/gpt-oss-20b for memory extraction)
export GROQ_API_KEY="your-key"
# Option E: Claude Code (uses claude-sonnet-4-20250514, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
# Option F: OpenAI Codex (uses o3-mini, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
```
**Step 2: Install the plugin**
@ -41,7 +47,7 @@ openclaw gateway
```
The plugin will automatically:
- Start a local Hindsight daemon (port 8888)
- Start a local Hindsight daemon (port 9077)
- Capture conversations after each turn
- Inject relevant memories before agent responses
@ -68,6 +74,7 @@ Optional settings in `~/.openclaw/openclaw.json`:
"hindsight-openclaw": {
"enabled": true,
"config": {
"apiPort": 9077,
"daemonIdleTimeout": 0,
"embedVersion": "latest"
}
@ -78,6 +85,7 @@ Optional settings in `~/.openclaw/openclaw.json`:
```
**Options:**
- `apiPort` - Port for the openclaw profile daemon (default: `9077`)
- `daemonIdleTimeout` - Seconds before daemon shuts down from inactivity (default: `0` = never)
- `embedVersion` - hindsight-embed version (default: `"latest"`)
- `bankMission` - Custom context for the memory bank (optional)
@ -86,12 +94,14 @@ Optional settings in `~/.openclaw/openclaw.json`:
The plugin auto-detects your LLM provider from these environment variables:
| Provider | Env Var | Default Model |
|----------|---------|---------------|
| OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
| Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` |
| Gemini | `GEMINI_API_KEY` | `gemini-2.5-flash` |
| Groq | `GROQ_API_KEY` | `openai/gpt-oss-20b` |
| Provider | Env Var | Default Model | Notes |
|----------|---------|---------------|-------|
| OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` | |
| Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` | |
| Gemini | `GEMINI_API_KEY` | `gemini-2.5-flash` | |
| Groq | `GROQ_API_KEY` | `openai/gpt-oss-20b` | |
| Claude Code | `HINDSIGHT_API_LLM_PROVIDER=claude-code` | `claude-sonnet-4-20250514` | No API key needed |
| OpenAI Codex | `HINDSIGHT_API_LLM_PROVIDER=openai-codex` | `o3-mini` | No API key needed |
**Override with explicit config:**
@ -133,32 +143,32 @@ Useful for shared memory across multiple OpenClaw instances or production deploy
View the daemon config that was written by the plugin:
```bash
cat ~/.hindsight/embed
cat ~/.hindsight/profiles/openclaw.env
```
This shows the LLM provider, model, and other settings the daemon is using.
This shows the LLM provider, model, port, and other settings the daemon is using.
### Check Daemon Status
```bash
# Check if daemon is running
uvx hindsight-embed@latest daemon status
uvx hindsight-embed@latest -p openclaw daemon status
# View daemon logs
tail -f ~/.hindsight/daemon.log
tail -f ~/.hindsight/profiles/openclaw.log
```
### Query Memories
```bash
# Search memories
uvx hindsight-embed@latest memory recall openclaw "user preferences"
uvx hindsight-embed@latest -p openclaw memory recall openclaw "user preferences"
# View recent memories
uvx hindsight-embed@latest memory list openclaw --limit 10
uvx hindsight-embed@latest -p openclaw memory list openclaw --limit 10
# Open web UI
uvx hindsight-embed@latest ui
# Open web UI (uses openclaw profile's daemon)
uvx hindsight-embed@latest -p openclaw ui
```
## Troubleshooting
@ -176,27 +186,40 @@ openclaw plugins install @vectorize-io/hindsight-openclaw
### Daemon not starting
```bash
# Check daemon status
uvx hindsight-embed@latest daemon status
# Check daemon status (note: -p openclaw uses the openclaw profile)
uvx hindsight-embed@latest -p openclaw daemon status
# View logs for errors
tail -f ~/.hindsight/daemon.log
tail -f ~/.hindsight/profiles/openclaw.log
# Check configuration
cat ~/.hindsight/embed
cat ~/.hindsight/profiles/openclaw.env
# List all profiles
uvx hindsight-embed@latest profile list
```
### No API key error
Make sure you've set one of the provider API keys:
Make sure you've set one of the provider API keys (or use a provider that doesn't require one):
```bash
# Option 1: OpenAI
export OPENAI_API_KEY="sk-your-key"
# or
# Option 2: Anthropic
export ANTHROPIC_API_KEY="your-key"
# Option 3: Claude Code (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
# Option 4: OpenAI Codex (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
# Verify it's set
echo $OPENAI_API_KEY
# or
echo $HINDSIGHT_API_LLM_PROVIDER
```
### Verify it's working
@ -208,6 +231,8 @@ tail -f /tmp/openclaw/openclaw-*.log | grep Hindsight
# Should see on startup:
# [Hindsight] ✓ Using provider: openai, model: gpt-4o-mini
# or
# [Hindsight] ✓ Using provider: claude-code, model: claude-sonnet-4-20250514
# Should see after conversations:
# [Hindsight] Retained X messages for session ...

View file

@ -1,3 +1,3 @@
"""Hindsight embedded CLI - local memory operations without a server."""
__version__ = "0.4.7"
__version__ = "0.4.8"

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-embed"
version = "0.4.7"
version = "0.4.8"
description = "Hindsight embedded CLI - local memory operations without a server"
readme = "README.md"
requires-python = ">=3.11"

View file

@ -1,6 +1,6 @@
[project]
name = "hindsight-litellm"
version = "0.4.7"
version = "0.4.8"
description = "Universal LLM memory integration via LiteLLM - works with 100+ providers"
readme = "README.md"
requires-python = ">=3.10"

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-openclaw",
"version": "0.4.7",
"version": "0.4.8",
"description": "Hindsight memory plugin for OpenClaw - biomimetic long-term memory with fact extraction",
"main": "dist/index.js",
"types": "dist/index.d.ts",

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-all"
version = "0.4.7"
version = "0.4.8"
description = "Hindsight: Agent Memory That Works Like Human Memory - All-in-One Bundle"
readme = "README.md"
requires-python = ">=3.11"

10
uv.lock
View file

@ -1448,7 +1448,7 @@ wheels = [
[[package]]
name = "hindsight-all"
version = "0.4.7"
version = "0.4.8"
source = { editable = "hindsight" }
dependencies = [
{ name = "hindsight-api" },
@ -1472,7 +1472,7 @@ provides-extras = ["test"]
[[package]]
name = "hindsight-api"
version = "0.4.7"
version = "0.4.8"
source = { editable = "hindsight-api" }
dependencies = [
{ name = "aiohttp" },
@ -1604,7 +1604,7 @@ dev = [
[[package]]
name = "hindsight-client"
version = "0.4.7"
version = "0.4.8"
source = { editable = "hindsight-clients/python" }
dependencies = [
{ name = "aiohttp" },
@ -1638,7 +1638,7 @@ provides-extras = ["test"]
[[package]]
name = "hindsight-dev"
version = "0.4.7"
version = "0.4.8"
source = { editable = "hindsight-dev" }
dependencies = [
{ name = "hindsight-api" },
@ -1684,7 +1684,7 @@ dev = [
[[package]]
name = "hindsight-embed"
version = "0.4.7"
version = "0.4.8"
source = { editable = "hindsight-embed" }
dependencies = [
{ name = "httpx" },