Pensyve Documentation
Pensyve is a universal memory runtime for AI agents. Store, recall, and manage episodic, semantic, and procedural memories with 8-signal retrieval, FSRS-based decay, multimodal embeddings, and LLM-powered extraction.
Open source (Apache 2.0) with a managed cloud service. Most developers are up and running in under 5 minutes.
Quickstarts
Pick your integration and start remembering.
- Python — PyO3 native module, fastest path
- TypeScript — HTTP client SDK with retry and timeout
- REST API — FastAPI server, language-agnostic
- Go — HTTP client with
context.Context - MCP — Stdio transport for Claude, Cursor, and other MCP hosts
- Claude Code — Persistent memory plugin for Claude Code
- OpenClaw — Tool adapter for OpenClaw/OpenHands agents
- CLI —
pensyve recall,pensyve rememberfrom your terminal
Key Concepts
Namespaces provide top-level isolation. Each namespace gets its own storage, embeddings, and graph — use them to separate projects, environments, or tenants.
Entities represent the actors in your system: agents, users, teams, or tools. Every memory belongs to an entity.
Episodes are bounded interaction sequences (like a conversation turn or tool call chain). Messages within an episode share context and have a configurable TTL.
Memories come in three types: episodic (what happened), semantic (subject-predicate-object knowledge triples with temporal validity), and procedural (Bayesian action-outcome reliability tracking).
Under the Hood
- Architecture — 8-signal retrieval, RRF fusion, FSRS decay, knowledge graph
- Multimodal Memory — image memory (Florence-2) and code memory (UniXcoder)
- Intelligent Extraction — LLM-powered fact, entity, and relation extraction
Pensyve Cloud
- Overview — managed service, dashboard, API keys
- Pricing — three-tier pay-as-you-go: $0.002/op standard, $0.005/op multimodal, $0.01/op extraction
Integrations
Pensyve plugs into the tools and frameworks you already use.
Agent Frameworks
| Integration | Language | Type | Source |
|---|---|---|---|
| LangChain | Python | Tool adapter | integrations/langchain/ |
| LangChain.js | TypeScript | Tool adapter | integrations/langchain-ts/ |
| CrewAI | Python | Tool adapter | integrations/crewai/ |
| AutoGen | Python | Tool adapter | integrations/autogen/ |
| OpenClaw / OpenHands | TypeScript | Plugin | integrations/openclaw-plugin/ |
Coding Assistants
| Integration | Protocol | Source |
|---|---|---|
| Claude Code | Plugin (hooks, commands, skills, agents) | integrations/claude-code/ |
| Cursor | MCP (stdio) | integrations/cursor/ |
| Cline | MCP (stdio) | integrations/cline/ |
| Windsurf | MCP (stdio) | integrations/windsurf/ |
| OpenCode | Plugin | integrations/opencode-plugin/ |
| VS Code | Extension (sidebar + commands) | integrations/vscode/ |
| VS Code Copilot | Chat participant | integrations/vscode-copilot/ |
SDKs & Protocol
| SDK | Language | Install |
|---|---|---|
| Python SDK | Python | pip install pensyve |
| TypeScript SDK | TypeScript | bun add pensyve |
| Go SDK | Go | go get github.com/major7apps/pensyve/pensyve-go |
| REST API | Any | HTTP — no SDK required |
| MCP Server | Any MCP client | cargo install pensyve-mcp |
| CLI | Terminal | cargo install pensyve-cli |
| WASM | Browser / Edge | pensyve-wasm crate |
All integrations share a common client layer (integrations/shared/) and the same Pensyve API — swap one for another without changing your memory data.