Integrations

One engine, several front doors. sibyl setup wires most of these for you; the manual steps are here for when you want to know exactly what changed.

Hermes Agent

Bundled provider for Hermes Agent v0.13 and newer.

$ pip install sibyl-memory-hermes
$ sibyl-memory-hermes install-plugin

Then set Sibyl as the provider in ~/.hermes/config.yaml:

memory:
  provider: sibyl

Or let the CLI do it: sibyl setup hermes.

MCP clients

The MCP server wraps the local SQLite + FTS5 engine and exposes it over MCP (stdio) to any MCP-compatible agent: Claude Code, Codex, Cursor, Continue, and anything else that speaks the protocol.

$ pip install sibyl-memory-mcp

Then point your MCP client at the server entry point. For the two most common clients, the CLI wires them directly:

$ sibyl setup claude-code   # registers via `claude mcp add --scope user`
$ sibyl setup codex         # writes the entry into ~/.codex/config.toml

For Cursor, Continue, and other MCP hosts, add the server to your client's MCP config using its standard format. The tools your agent gets are search, recall, and list over the local store.

The SDK directly

If you are writing your own Python orchestration and want to call memory yourself, skip the wrappers:

$ pip install sibyl-memory-client

from sibyl_memory_client import MemoryClient

memory = MemoryClient.local("~/.sibyl-memory/memory.db")
memory.set_entity("project", "atlas", {"status": "active"})

The full API surface is on the How it works page.

Which package do I install?