octoocute 0.1.0

Local-first AI agent memory platform — persistent memory, semantic search, knowledge graph, crash recovery, and real-time monitoring for AI agents.

Octoocute

Local-first AI agent memory platform. Persistent memory, semantic search, knowledge graph, crash recovery, and real-time monitoring — all running on your machine.

Install

pip install octoocute
python -m spacy download en_core_web_sm

Quick Start

# Start the server
octoocute serve

from octoocute import Octoocute

client = Octoocute(api_key="sk-octoocute-...")
agent = client.agent("my-bot")

agent.write("user:name", "Alice")
print(agent.read("user:name"))          # Alice
print(agent.search("user info"))        # semantic search

MCP (Claude Code / Cursor)

pip install "octoocute[mcp]"

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "octoocute": {
      "command": "python",
      "args": ["-m", "octoocute.mcp_server"],
      "env": {
        "OCTOOCUTE_API_KEY": "sk-octoocute-..."
      }
    }
  }
}

Restart your editor. 16 memory tools appear automatically.

Features

• Persistent Memory — versioned, timestamped, semantically searchable
• Semantic Search — bge-small-en-v1.5, 384-dim embeddings, sub-ms
• Knowledge Graph — spaCy NER, entity extraction, relationship mapping
• Crash Recovery — msgpack snapshots, instant restore
• Real-Time Dashboard — React + Vite + Tailwind, 8 tabs
• MCP Server — 16 tools for Claude Code / Cursor / Windsurf
• Framework Integrations — LangChain, CrewAI, OpenAI Agents, AutoGen
• 100% Local — SQLite + WAL, no cloud, no external API calls