pyomnibrain

Python SDK & Client for OmniBrain (ChronoCache) Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine

Installation

pip install pyomnibrain

Quickstart

from pyomnibrain import OmniBrainClient

# Connect to local OmniBrain daemon
client = OmniBrainClient(host="127.0.0.1", port=4821)

# Check daemon health
health = client.health()
print(f"Connected to OmniBrain v{health['version']}")

# Snapshot an article into offline memory
capture_result = client.capture(
    url="https://example.com/rust-architecture",
    title="High-Performance Rust Architectures",
    content="""
    <article>
        <h1>High-Performance Rust Architectures</h1>
        <p>Rust empowers developers to build reliable, high-throughput systems with zero-cost abstractions.</p>
    </article>
    """
)
print(f"Captured: {capture_result['title']} | Compression: {capture_result['compression']['compression_ratio']}x")

# Search offline memory with hybrid fusion
results = client.search("high-performance reliable systems", limit=5, mode="hybrid")
for r in results:
    print(f"[{r['match_type'].upper()}] {r['title']} (Score: {r['score']:.4f})")
    print(f"  Snippet: {r['snippet']}")