記憶 (kioku) — memory in Japanese: 記 to record, 憶 to remember
Tri-hybrid search (BM25 + Vector + Knowledge Graph) in a single file.
No big DB, no server, no Cloud LLM.
Just pip install.
// WHY
Existing long-term memory tools store flat text or vectors with no structure. They can't answer "Why was I stressed last month?" because they don't track how events, emotions, and decisions are connected. Kioku Lite adds a Knowledge Graph on top of keyword and semantic search, so your agent can trace cause and effect across months of conversation.
// COMPARISON
| System | Infrastructure | LLM required | Search | Knowledge Graph |
|---|---|---|---|---|
| Mem0 | Cloud-managed | Yes (every write) | Vector + Graph | Yes, managed |
| Claude Code | Flat markdown files | No | Context window only | No |
| OpenClaw | SQLite per-agent | No | Semantic (embedding) | No |
| Kioku Lite | Single SQLite file | Agent-driven, zero extra | Tri-hybrid (BM25 + vector + KG) | Yes, agent-driven |
Full breakdown: Memory Comparison
// SETUP
Each guide is a self-contained prompt. Paste it into your agent and it will install kioku-lite, set up identity files, and start remembering automatically.
// GENERAL AGENT
Standard setup via kioku-lite init --global
and install-profile.
Works with any agent that supports SKILL.md.
// OPENCLAW
Setup for OpenClaw gateway agents. Derives SOUL.md and TOOLS.md from installed profile. Supports Telegram bots.
// QUICK INSTALL (3 commands)
$ pipx install "kioku-lite[cli]"
$ kioku-lite setup # download embedding model (~1.1GB, one-time)
$ kioku-lite init --global # integrate with your agent
// PERSONA
Kioku Lite ships with 2 default personas. Need something different? Ask your agent to configure a new one for any domain.
Companion
Tracks emotions and life events.
Nodes: EMOTION, LIFE_EVENT
Edges: TRIGGERED_BY
Mentor
Tracks decisions and lessons learned.
Nodes: DECISION, LESSON
Edges: LED_TO
Want a persona for HR management, product management, or any other domain? Just ask your agent to create one — entity types and relationships are plain strings, not fixed enums.
Details: KG Open Schema
// ARCHITECTURE
Three search signals (BM25, vector, Knowledge Graph) fused via RRF. Agent-driven, zero LLM calls inside kioku-lite.
// ROADMAP
kioku-lite is available now for personal use.
Zero Docker, zero cloud dependency, single SQLite file.
kioku-full (dedicated graph DB + vector DB, multi-tenant, API keys)
is under active development for team and enterprise deployments.
MIT License · Python 3.11+ · Works with Claude Code, Cursor, Windsurf, OpenClaw