An in-memory KV/JSON engine.
Built for one node.

from spedo_client import SpedoClient

# 1. Connect to local Spedo instance (sub-millisecond in-memory engine)
client = SpedoClient(host="127.0.0.1", port=6380)

# 2. In-Process Reactive Live Variable (3.52M reads/s in local RAM)
maintenance = client.bind_var("flags:maintenance", default=False)
print(f"✓ Maintenance Active: {maintenance.value}")

# 3. Key-Value & JSON Storage
client.set("session:usr_101", '{"name": "Alex Dev", "tier": "enterprise"}')
session = client.get("session:usr_101")
print(f"✓ In-Memory Session (0.8µs): {session}")

# 4. Sub-Millisecond AI Vector Similarity Search (SIMD AVX-512)
results = client.vector_search(
    index="documents",
    query_vector=[0.042, -0.189, 0.812],
    top_k=3,
    metric="COSINE"
)
print(f"✓ Nearest Vector Matches (0.60ms): {results}")

import React from 'react';
import { SpedoProvider, useSpedoVar, useSpedoQuery } from '@spedo/react';

// 1. App Root Provider
export function App() {
  return (
    <SpedoProvider url="ws://localhost:8080/spedo">
      <LiveDashboard />
    </SpedoProvider>
  );
}

// 2. Reactive UI Component with Zero Polling
function LiveDashboard() {
  // Live variable with optimistic local UI updates (0µs):
  const [banner, setBanner] = useSpedoVar<string>('config:banner', 'Welcome!');
  // Live query stream syncing differential updates:
  const { data: orders } = useSpedoQuery<any>('order:*', { freshness: 'bounded:50ms' });

  return (
    <div className="p-6">
      <h1>{banner}</h1>
      <p>Active Orders: {orders?.length}</p>
      <button onClick={() => setBanner('New Announcement')}>Broadcast Update</button>
    </div>
  );
}