Skip to content

BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.

3.1 KB
Raw Blame
#!/usr/bin/env python3
"""Idempotently seed the dedicated public demo brain from published V2 docs."""

from __future__ import annotations

import argparse
import hashlib
import os
import sys
import time

import requests


DEFAULT_DOCS_URL = "https://brainapi.lumen-labs.ai/docs/llms-full.txt"


def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("--api-url", default=os.getenv("BRAINAPI_URL", "http://localhost:8000"))
    parser.add_argument("--docs-url", default=DEFAULT_DOCS_URL)
    parser.add_argument("--brain", default=os.getenv("PUBLIC_DEMO_BRAIN_ID", "agentdemo"))
    parser.add_argument("--timeout", type=int, default=600)
    args = parser.parse_args()

    token = os.getenv("BRAINPAT_TOKEN")
    if not token:
        print("BRAINPAT_TOKEN is required", file=sys.stderr)
        return 2
    if not args.brain.isalnum() or args.brain == "system":
        print("Demo brain must be a non-system alphanumeric identifier", file=sys.stderr)
        return 2

    api_url = args.api_url.rstrip("/")
    docs_response = requests.get(args.docs_url, timeout=30)
    docs_response.raise_for_status()
    docs_text = docs_response.text
    digest = hashlib.sha256(docs_text.encode("utf-8")).hexdigest()
    marker = f"BRAINAPI_PUBLIC_DEMO_SHA256_{digest}"
    headers = {"BrainPAT": token, "X-Brain-ID": args.brain}

    existing = requests.get(
        f"{api_url}/retrieve/text-chunks",
        headers=headers,
        params={"query_text": marker, "limit": 1},
        timeout=30,
    )
    if existing.status_code == 200 and existing.json().get("total", 0) > 0:
        print(f"Public demo brain {args.brain!r} is already current ({digest[:12]}).")
        return 0
    if existing.status_code not in (200, 406):
        existing.raise_for_status()

    payload = {
        "data": {
            "data_type": "text",
            "text_data": f"{marker}\nSource: {args.docs_url}\n\n{docs_text}",
        },
        "brain_id": args.brain,
        "skip_enrichment": True,
    }
    accepted = requests.post(
        f"{api_url}/ingest/",
        headers={
            **headers,
            "Content-Type": "application/json",
            "Task-Identifier": f"public-demo-{digest[:24]}",
        },
        json=payload,
        timeout=30,
    )
    accepted.raise_for_status()
    task_id = accepted.json()["task_id"]

    deadline = time.monotonic() + args.timeout
    while time.monotonic() < deadline:
        task_response = requests.get(
            f"{api_url}/tasks/{task_id}",
            headers=headers,
            timeout=30,
        )
        task_response.raise_for_status()
        task = task_response.json()
        status = str(task.get("status", "unknown")).lower()
        if status in {"completed", "success", "succeeded"}:
            print(f"Seeded public demo brain {args.brain!r} ({digest[:12]}).")
            return 0
        if status in {"failed", "error", "revoked"}:
            print(f"Public demo seed task failed: {task}", file=sys.stderr)
            return 1
        time.sleep(2)

    print(f"Timed out waiting for seed task {task_id}", file=sys.stderr)
    return 1


if __name__ == "__main__":
    raise SystemExit(main())