fluctlightdb 0.4.1

Python client for FluctlightDB — brain-native memory for AI agents

fluctlightdb

Python client for FluctlightDB — a brain-native memory store for AI agents.

Install

pip install fluctlightdb

Optional in-process recall (Rust extension, when wheels are available for your platform):

pip install "fluctlightdb[native]"
# or: pip install fluctlightdb-native

No cargo or Rust toolchain required for the HTTP client.

Quick start (HTTP — like qdrant-client)

Run a FluctlightDB server (download a release binary or use your own deployment), then:

from fluctlightdb import FluctlightClient

client = FluctlightClient(
    base_url="http://127.0.0.1:8792",
    api_key="your-key",
)

client.experience("user prefers dark mode", context="settings")
print(client.activate_lite("theme preference"))

Or use environment variables:

export FLUCTLIGHT_SERVE_URL=http://127.0.0.1:8792
export FLUCTLIGHT_API_KEY=your-key

from fluctlightdb import FluctlightClient

client = FluctlightClient.from_env()
print(client.activate("dark mode"))

In-process recall (optional)

When fluctlightdb-native is installed:

from fluctlightdb import get_recall_client

brain = get_recall_client("~/.fluctlight/tenants/default/brain")
print(brain.activate("dark mode"))

Docs

• Getting started
• HTTP API (OpenAPI)

License

MIT — see LICENSE.