Add fraglets to
your service

import requests

API_KEY = "frag_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
BASE = "https://api.fraglet.org/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# Create a fraglet — embedding generated server-side
fraglet = requests.post(f"{BASE}/fraglets", headers=HEADERS, json={
    "title": "Nocturnal jazz wanderer",
    "brief": "Late-night jazz devotee drawn to intimate venues.",
    "detail": "A deep appreciation for musicians who treat standards "
              "as starting points rather than destinations...",
    "category": "Contemporary jazz and fusion",
    "tags": ["jazz", "post-bop", "intimate-venues"],
    "domain": "music",
    "visibility": "open"
}).json()

print(fraglet["id"])        # UUID
print(fraglet["embedding"]) # 3072-dim vector

# Fetch it back
fetched = requests.get(
    f"{BASE}/fraglets/{fraglet['id']}", headers=HEADERS
).json()

# Match against your catalogue
results = your_vector_db.query(
    vector=fetched["embedding"],
    top_k=20,
    threshold=0.3
)

-- pgvector: rank your catalogue items
-- by similarity to the fraglet embedding

SELECT id, title, description,
  1 - (embedding <=> $1) AS similarity
FROM your_items
WHERE 1 - (embedding <=> $1) > 0.3
ORDER BY embedding <=> $1
LIMIT 20;

const API_KEY = 'frag_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const BASE = 'https://api.fraglet.org/api/v1';
const headers = { Authorization: `Bearer ${API_KEY}` };

// Create a fraglet
const fraglet = await fetch(`${BASE}/fraglets`, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title: 'Nocturnal jazz wanderer',
    brief: 'Late-night jazz devotee drawn to intimate venues.',
    detail: 'A deep appreciation for musicians who treat standards...',
    category: 'Contemporary jazz and fusion',
    tags: ['jazz', 'post-bop', 'intimate-venues'],
    domain: 'music',
    visibility: 'open'
  })
}).then(r => r.json());

// Match against your catalogue
const results = await vectorDb.query({
  vector: fraglet.embedding,
  topK: 20
});