Metadata-Version: 2.4
Name: octoocute
Version: 0.1.0
Summary: Local-first AI agent memory platform — persistent memory, semantic search, knowledge graph, crash recovery, and real-time monitoring for AI agents.
License: MIT
Project-URL: Homepage, https://github.com/antoniogiliberto/octoocute
Project-URL: Documentation, https://github.com/antoniogiliberto/octoocute#readme
Project-URL: Repository, https://github.com/antoniogiliberto/octoocute
Project-URL: Issues, https://github.com/antoniogiliberto/octoocute/issues
Keywords: ai,agents,memory,semantic-search,knowledge-graph,mcp,langchain,crewai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn[standard]
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings
Requires-Dist: python-jose[cryptography]
Requires-Dist: httpx
Requires-Dist: msgpack
Requires-Dist: numpy
Requires-Dist: sentence-transformers
Requires-Dist: spacy>=3.7
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"
Provides-Extra: llm
Requires-Dist: openai; extra == "llm"
Requires-Dist: anthropic; extra == "llm"
Provides-Extra: all
Requires-Dist: mcp>=1.0; extra == "all"
Requires-Dist: openai; extra == "all"
Requires-Dist: anthropic; extra == "all"
Dynamic: license-file

# 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

```bash
pip install octoocute
python -m spacy download en_core_web_sm
```

## Quick Start

```bash
# Start the server
octoocute serve
```

```python
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)

```bash
pip install "octoocute[mcp]"
```

Add to `~/.claude/mcp.json`:

```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
