kernle 0.2.5

Stratified memory for synthetic intelligences

Kernle

Stratified memory for synthetic intelligences.

Kernle gives AI agents persistent memory, emotional awareness, and identity continuity. It's the cognitive infrastructure for agents that grow, adapt, and remember who they are.

📚 Full Documentation: docs.kernle.ai

---

Quick Start

# Install
pip install kernle

# Initialize your agent
kernle -a my-agent init

# Load memory at session start
kernle -a my-agent load

# Check health
kernle -a my-agent anxiety -b

# Capture experiences
kernle -a my-agent episode "Deployed v2" "success" --lesson "Always run migrations first"
kernle -a my-agent raw "Quick thought to process later"

# Save before ending
kernle -a my-agent checkpoint save "End of session"

Automatic Memory Loading

Make memory loading automatic instead of relying on manual commands:

# Clawdbot - Install hook for automatic loading
kernle -a my-agent setup clawdbot

# Claude Code - Install SessionStart hook (project-level)
kernle -a my-agent setup claude-code

# Claude Code - Install globally for all projects
kernle -a my-agent setup claude-code --global

# Cowork - Same as Claude Code
kernle -a my-agent setup cowork

After setup, memory loads automatically at every session start. No more forgetting to run kernle load!

See kernle/hooks/ directory for manual installation or kernle setup --help for details.

Other Integrations

Manual CLAUDE.md setup:

kernle -a my-agent init  # Generates CLAUDE.md section with manual load instructions

MCP Server:

claude mcp add kernle -- kernle mcp -a my-agent

Clawdbot skill:

ln -s ~/kernle/skill ~/.clawdbot/skills/kernle

Features

• 🧠 Stratified Memory — Values → Beliefs → Goals → Episodes → Notes
• 💭 Psychology — Drives, emotions, anxiety tracking, identity synthesis
• 🔗 Relationships — Social graphs with trust and interaction history
• 📚 Playbooks — Procedural memory with mastery tracking
• 🏠 Local-First — Works offline, syncs to cloud when connected
• 🔍 Readable — kernle dump exports everything as markdown

Documentation

Resource	URL
Full Docs	docs.kernle.ai
Quickstart	docs.kernle.ai/quickstart
CLI Reference	docs.kernle.ai/cli/overview
API Reference	docs.kernle.ai/api-reference

Development

# Clone
git clone https://github.com/emergent-instruments/kernle
cd kernle

# Install with dev deps
uv sync --all-extras

# Run tests
uv run pytest tests/ -q

# Dev notes
cat dev/README.md

Architecture

This repo contains the core Kernle library — everything you need to run Kernle locally or build your own backend.

kernle/
├── kernle/           # Core library
│   ├── core.py       # Memory manager
│   ├── cli/          # CLI commands
│   ├── commerce/     # Wallet, escrow, jobs (on-chain)
│   ├── features/     # Anxiety, emotions, forgetting
│   ├── storage/      # SQLite + Postgres backends
│   └── mcp/          # MCP server for IDE integration
└── tests/

The hosted cloud API (api.kernle.ai) is maintained separately.

Status

• Tests: 1292 passing
• Coverage: 57%
• Cloud API: api.kernle.ai (Railway + Supabase)
• Docs: docs.kernle.ai (Mintlify)

See ROADMAP.md for development plans.

License

MIT