onebrain-python

[](https://pypi.org/project/onebrain-sdk/) [](https://pypi.org/project/onebrain-sdk/) [](https://opensource.org/licenses/MIT) [](https://mypy-lang.org/)

The official Python SDK for OneBrain — a persistent AI memory layer for humans and agents. Store, search, and connect memories across every AI tool you use.

• Homepage: <https://onebrain.rocks>
• Dashboard: <https://onebrain.rocks/dashboard>
• API Reference: <https://onebrain.rocks/docs/api>
• Repository: <https://github.com/azappnew/onebrain-python>

---

pip install onebrain-sdk

Requires Python 3.9+. The only runtime dependency is httpx.

---

import onebrain

client = onebrain.OneBrain(api_key="ob_xxx:secret")

# Store a memory
memory = client.memory.create(content="The user prefers dark mode.")

# Search memories
results = client.memory.search(query="user preferences", limit=5)

# Get brain context for an AI prompt
context = client.brain.context(scope="preferences")

client.close()

---

Every request requires an API key. You can provide it in two ways:

client = onebrain.OneBrain(api_key="ob_xxx:secret")

export ONEBRAIN_API_KEY="ob_xxx:secret"

client = onebrain.OneBrain()  # reads ONEBRAIN_API_KEY automatically

1. Sign in at <https://onebrain.rocks/dashboard>.
2. Navigate to Settings > API Keys.
3. Click Create API Key and copy the full key (ob_prefix:secret).
4. The secret is shown only once — store it securely.

---

All methods return type