letta-ceki

Letta toolkit for Ceki — drive a real Chrome session from your Letta agent.

Killer combo. Letta's archival memory + Ceki's profile export = browser sessions that remember themselves across agent restarts. Log in once on Monday, your agent walks straight into the dashboard on Friday — no cookies stored in your code, no second login.

Install

pip install letta-ceki

The squat alias ceki-letta is reserved by the same project and depends on letta-ceki — both resolve to the same symbols.

Architecture

Variant C — structural toolkit. Eleven self-contained Python functions that the Letta agent's own LLM plans across:

There is no server-side NL endpoint and no LLM lives inside this package — your Letta agent's own model does the planning.

Register the tools in your Letta workspace

import os
os.environ["CEKI_API_KEY"] = "your_ceki_key"     # https://ceki.me dashboard
os.environ["LETTA_TOKEN"] = "your_letta_token"   # https://app.letta.com/settings/api-keys

from letta_ceki import register_all
tool_ids = register_all()
print(f"Registered {len(tool_ids)} tools.")

Then attach the tools to your agent in the Letta UI, or programmatically:

from letta_client import Letta
client = Letta(token=os.environ["LETTA_TOKEN"])
client.agents.update(agent_id="your_agent_id", tool_ids=list(tool_ids.values()))

The killer combo — persistent sessions

Tell your agent in its persona prompt:

After a successful login, always call ceki_export_profile.
On a fresh rent for a previously-logged-in site, always call
ceki_restore_profile before navigating.

That is the entire setup. Now every login the agent performs is durable:

# Run A — agent logs into your.example.com, then:
ceki_export_profile(session_id, profile_name="your-example")

# Letta restarts. Memory survives.

# Run B — fresh rent on a new browser:
ceki_restore_profile(session_id, profile_name="your-example")
# → cookies, localStorage, sessionStorage, fingerprint all restored
ceki_navigate(session_id, "https://your.example.com/dashboard")
# → already authenticated

See examples/persistent_session.py for an end-to-end runnable demo.

Use responsibly

Use only on sites you own or have authorization to operate on (your own apps, your own dashboards, public data within site Terms of Service, accessibility audits you're responsible for).

License

MIT.