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.
Python ai-agentsai-memoryknowledge-graphknowledge-managementknowledge-representationreccomendation-system
#!/usr/bin/env bash
# Resilient BEAM 10M/1 ingest + product evaluate.
# Resume-safe. LISTEN-based ensure_api (never pkill healthy uvicorn).
# Uses flock so watchdog/ensure never double-bind :8000.
# NEVER touches beam1m1clean — uses beam10m1clean / beam-10m-1-clean only.
#
# TARGET comes from data/beam/10M/1/meta.json (ingest_target or n_turns-5).
# Do not invent TARGET without a normalized sample.
set +e
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$ROOT"
unset BRAINPAT_TOKEN BRAINAPI_TOKEN
set -a; source ./.env; set +a
export TERM=dumb PYTHONUNBUFFERED=1
SRC="${BRAINAPI_SRC:-$HOME/.brainapi/source}"
UV_LOG=/tmp/uvicorn-beam10m.log
CEL_LOG=/tmp/brainapi-beam-worker.log
LOCK_DIR=/tmp/beam10m-locks
mkdir -p "$LOCK_DIR"
BEAM_INGEST_CONCURRENCY="${BEAM_INGEST_CONCURRENCY:-2}"
BEAM_INGEST_TIMEOUT="${BEAM_INGEST_TIMEOUT:-2400}"
CELERY_WORKER_CONCURRENCY="${CELERY_WORKER_CONCURRENCY:-4}"
RUN_ID="${BEAM_10M_RUN:-beam-10m-1-clean}"
BRAIN_ID="${BEAM_10M_BRAIN:-beam10m1clean}"
EVAL_RUN_ID="${BEAM_10M_EVAL_RUN:-beam-10m-1-clean-product}"
SAMPLE_ID="${BEAM_10M_SAMPLE:-1}"
api_ok() {
lsof -iTCP:8000 -sTCP:LISTEN >/dev/null 2>&1 || return 1
code=$(curl -s -o /dev/null --max-time 5 -w '%{http_code}' http://127.0.0.1:8000/docs || echo 000)
[[ "$code" == "200" || "$code" == "401" ]]
}
start_uvicorn() {
(
flock -n 9 || return 0
if lsof -iTCP:8000 -sTCP:LISTEN >/dev/null 2>&1; then
return 0
fi
nohup bash -c "cd '$SRC' && exec ./.venv/bin/uvicorn src.services.api.app:app --host 127.0.0.1 --port 8000" \
>> "$UV_LOG" 2>&1 &
echo $! > /tmp/beam10m-uvicorn.pid
sleep 5
) 9>"$LOCK_DIR/uvicorn.lock"
}
start_celery() {
(
flock -n 9 || return 0
if pgrep -f '/.venv/bin/celery -A src.workers.app worker' >/dev/null 2>&1; then
return 0
fi
nohup bash -c "cd '$SRC' && exec ./.venv/bin/celery -A src.workers.app worker --loglevel=info --pool=threads \
--concurrency=${CELERY_WORKER_CONCURRENCY} \
-Q ingest_data,finalize_ingestion,process_architect_relationships,consolidate_graph,chatbot_memory,ingest_file,ingest_structured_data" \
>> "$CEL_LOG" 2>&1 &
echo $! > /tmp/beam10m-celery.pid
sleep 5
) 9>"$LOCK_DIR/celery.lock"
}
ensure_api() {
for _ in 1 2 3 4 5 6 7 8 9 10 11 12; do
if api_ok; then
start_celery
return 0
fi
start_uvicorn
start_celery
sleep 3
done
return 1
}
resolve_target() {
.venv/bin/python - <<PY
import json
from pathlib import Path
meta = Path("data/beam/10M/${SAMPLE_ID}/meta.json")
if not meta.exists():
print(0)
raise SystemExit(0)
row = json.loads(meta.read_text(encoding="utf-8"))
target = row.get("ingest_target")
if target is None:
n = int(row.get("n_turns") or 0)
target = max(1, n - 5) if n else 0
print(int(target))
PY
}
terminal_count() {
.venv/bin/python - <<PY
import json
import re
from pathlib import Path
p = Path("runs/${RUN_ID}/ingest.jsonl")
rows = [json.loads(l) for l in p.read_text().splitlines() if l.strip()] if p.exists() else []
last = {}
for r in rows:
last[r.get("unit_id")] = r
pat = re.compile(r"maximum context length is 8192", re.I)
n = 0
for r in last.values():
st = r.get("status")
err = r.get("error") or ""
if st in {"completed", "partial_failed", "permanent_failed"}:
n += 1
elif st == "failed" and pat.search(err):
n += 1
print(n)
PY
}
completed_count() {
terminal_count
}
watchdog() {
while [[ ! -f /tmp/beam-10m-1.STOP ]]; do
if ! lsof -iTCP:8000 -sTCP:LISTEN >/dev/null 2>&1; then
echo "WATCHDOG_API_RESTART $(date -u +%H:%M:%S)"
start_uvicorn
fi
if ! pgrep -f '/.venv/bin/celery -A src.workers.app worker' >/dev/null 2>&1; then
echo "WATCHDOG_CELERY_RESTART $(date -u +%H:%M:%S)"
start_celery
fi
sleep 30
done
}
TARGET=$(resolve_target)
if [[ "$TARGET" -le 0 ]]; then
echo "FATAL_NO_TARGET: normalize 10M sample first: ./beam.sh download --size 10M"
echo "Then re-run; TARGET is read from data/beam/10M/${SAMPLE_ID}/meta.json"
exit 1
fi
N_TURNS=$(.venv/bin/python - <<PY
import json
from pathlib import Path
meta = Path("data/beam/10M/${SAMPLE_ID}/meta.json")
print(json.loads(meta.read_text(encoding="utf-8")).get("n_turns", 0))
PY
)
STALL_LIMIT=3
prev_n=-1
stalls=0
MIN_EVAL_TURNS=$(( TARGET * 70 / 100 ))
if [[ "$MIN_EVAL_TURNS" -lt 1 ]]; then
MIN_EVAL_TURNS=1
fi
rm -f /tmp/beam-10m-1.STOP /tmp/beam-10m-1.DONE
echo "START_10M_INGEST $(date -u +%Y-%m-%dT%H:%M:%SZ) concurrency=$BEAM_INGEST_CONCURRENCY celery_c=$CELERY_WORKER_CONCURRENCY target=$TARGET n_turns=$N_TURNS brain=$BRAIN_ID run=$RUN_ID"
ensure_api || { echo FATAL_API_DOWN; exit 1; }
watchdog &
WD_PID=$!
echo "watchdog_pid=$WD_PID"
for try in $(seq 1 300); do
ensure_api || { echo API_DOWN; sleep 20; continue; }
done_n=$(completed_count)
echo "try=$try terminal=$done_n target=$TARGET $(date -u +%H:%M:%S)"
if [[ "$done_n" -ge "$TARGET" ]]; then
break
fi
if [[ "$done_n" -eq "$prev_n" ]]; then
stalls=$((stalls + 1))
if [[ "$stalls" -ge "$STALL_LIMIT" ]]; then
echo "INGEST_STALLED terminal=$done_n (no progress ${stalls} tries) — proceed to eval"
break
fi
else
stalls=0
fi
prev_n=$done_n
./beam.sh ingest \
--size 10M --sample "$SAMPLE_ID" \
--run "$RUN_ID" \
--brain "$BRAIN_ID" \
--concurrency "$BEAM_INGEST_CONCURRENCY" \
--timeout "$BEAM_INGEST_TIMEOUT"
sleep 2
done
done_n=$(completed_count)
echo "INGEST_DONE=$done_n"
kill "$WD_PID" 2>/dev/null
wait "$WD_PID" 2>/dev/null
if [[ "$done_n" -lt "$MIN_EVAL_TURNS" ]]; then
echo "INGEST_INCOMPLETE abort eval ($done_n/$N_TURNS target=$TARGET)"
date -u +%Y-%m-%dT%H:%M:%SZ > /tmp/beam-10m-1.DONE
exit 2
fi
for ab in \
abstention \
contradiction_resolution \
event_ordering \
information_extraction \
instruction_following \
knowledge_update \
multi_session_reasoning \
preference_following \
summarization \
temporal_reasoning
do
echo "==== EVAL $ab $(date -u +%H:%M:%S) ===="
ensure_api
./beam.sh evaluate \
--size 10M --sample "$SAMPLE_ID" \
--run "$EVAL_RUN_ID" \
--brain "$BRAIN_ID" \
--profile product \
--abilities "$ab" \
--concurrency 1 \
--historical-limit 12 --max-passages 12 --max-facts 40 \
--no-ppr
done
./beam.sh report --run "$EVAL_RUN_ID"
.venv/bin/python - <<PY
import json, statistics, re
from pathlib import Path
rows=[json.loads(l) for l in Path('runs/${RUN_ID}/ingest.jsonl').read_text().splitlines() if l.strip()]
last={}
for r in rows: last[r.get('unit_id')]=r
pat=re.compile(r'maximum context length is 8192', re.I)
comp=[r for r in last.values() if r.get('status')=='completed' and (r.get('cost') or {}).get('llm_source_multiplier') is not None]
mult=[r['cost']['llm_source_multiplier'] for r in comp]
perm=sorted(
uid for uid,r in last.items()
if r.get('status')=='permanent_failed'
or (r.get('status')=='failed' and pat.search(r.get('error') or ''))
)
print('MULTIPLIER n', len(mult),
'median', round(statistics.median(mult),1) if mult else None,
'mean', round(statistics.mean(mult),1) if mult else None)
print('PERMANENT_FAILS', perm)
rep_path=Path('runs/${EVAL_RUN_ID}/report.json')
if rep_path.exists():
rep=json.loads(rep_path.read_text())
m=rep.get('metrics') or {}
print('HEADLINE', m.get('headline_score'))
print('PER', m.get('per_ability'))
PY
date -u +%Y-%m-%dT%H:%M:%SZ > /tmp/beam-10m-1.DONE
echo MULTI_DONE