SIBYL LABSdocs
Lab home Research

Install

The CLI pulls in the whole family. Install it, activate, and wire Sibyl into your agent. Requires Python 3.10 or newer.

1. Install the CLI

$ pip install sibyl-memory-cli

This pulls in sibyl-memory-client (the local SDK) and sibyl-memory-hermes (the Hermes provider) automatically.

2. Activate

$ sibyl init

sibyl init opens a browser to activate your account. Sign a SIWE message with your wallet (browser wallet or Coinbase Smart Wallet); the terminal picks up the binding automatically. Credentials are written to ~/.sibyl-memory/credentials.json at mode 0600.

Free is the default

You do not need to pay to build real things. Free tier gives you the full five-tier memory model with a 2 MB local cap. Staker and subscription tiers lift the cap and add self-learning and the memory linter. See Tiers & access.

3. Wire it into your agent

sibyl setup auto-detects your stack and wires Sibyl as the memory provider. Run it with no argument to detect everything, or name one target. 

$ sibyl setup                # detect Hermes, Claude Code, and Codex
$ sibyl setup claude-code    # wire just one
$ sibyl setup --dry-run      # print what would change, write nothing

Targets: hermes, claude-code, codex. See Integrations for what each one does.

Bring existing memory with you

Already have agent memory in CLAUDE.md, AGENTS.md, a Codex config, or Hermes files? sibyl migrate moves it in without risk. It backs up every file it finds and byte-verifies the copy before anything else happens, wires Sibyl into each detected harness, then prints a prompt you run in your own agent to extract structured memory from the backup. The extraction runs locally; Sibyl Labs never sees your files. 

$ sibyl migrate
Backup-first, never destructive

Trimming the originals is the last step, it is optional, and it only happens after you confirm and only because a verified backup already exists. Keep the backup until you have confirmed everything migrated.

Just the SDK

If you only want the library to call from your own Python:

$ pip install sibyl-memory-client

Then jump to How it works for the API surface.

Verify

$ sibyl status     # local credentials, DB size, server-side tier
$ sibyl health     # provider self-check (schema version, DB path, tenant)