Under the hood
Open tools, one server, your data.
Albulena is a Python system built on LangGraph and local models. It runs as one service on a server: the models, the worker and the analyst UI. Every alert, finding, verdict and lesson of a site lives in that site's own SQLite file.
1 · IngestReplayer
Reads SIEM alerts and 14 days of raw logs in sim time, normalises them and tracks which sensors went silent.
- email · auth · host FW
- netflow · config
2 · ClusterOnline clusterer
Plain Python, no LLM. Links alerts by user, host and IP, and groups change-window noise by change ID.
- entity link · 60 min
- hubs, scanners · 3 h
- maint:CHG-2211
3 · ReasonLangGraph run per case
Five domain agents in parallel, then correlation, similar cases, the risk floor, the supervisor AI and the guardrails.
- thread_id = cluster_id
- pauses at human review
4 · Decide & learnAnalyst UI
Streamlit queue with case cards, opened in the browser. The analyst's decision resumes the graph, and the learn node updates memory.
- incidents · lessons
- indicators · baselines
OrchestrationLangGraphA state graph, not a prompt chain
Send fans out one task per log source, and a reducer merges the five reports. interrupt() stops the run for the analyst. A SQLite checkpointer saves every step, so a run resumes after a restart.
ModelsOllamaqwen3:8b and nomic-embed-text
Agents and supervisor run on a local 8B model. Case summaries are embedded with a 768-dim local model. Agents skip the LLM when an entity sits close to its baseline.
OutputPydantic v2JSON schema, hard caps
Every LLM call returns a typed object via json_schema structured output. Reasons, steps and text length are capped in the schema. Bad output falls back to a template verdict.
MemorySQLiteOne file holds everything
Logs, alerts, cases, findings and the audit log in tables. Past incidents in a sqlite-vec vector table. Lessons in an FTS5 full-text index.
CorrelationNetworkXAn entity graph per case
Users, hosts and IPs become a graph. Degree centrality names the pivot, such as WS-07, and the kill-chain stages are counted across sources.
Threat intelMITRE ATT&CKChecked against STIX, offline
Rules map to techniques such as T1566, T1078 and T1021. Every ID the AI writes is checked against the local STIX bundle.
// Albulena verdict: what the supervisor AI must return (shortened example)
{
"verdict": "likely_real",
"confidence": 0.86,
"reasons": [
{ "text": "Night logon by j.miller right after a phishing mail",
"evidence": ["A-001207", "F-0012-AU1"] },
{ "text": "WS-07 scanned the OT segment, then its firewall was turned off",
"evidence": ["F-0012-NF1", "F-0012-CF1"] }
],
"closest_case": "INC-0042",
"attack_ids": ["T1566", "T1078", "T1021", "T1046", "T1543"],
"verify_steps": ["Check gate timer config on GATE-SRV-01"],
"containment_options": ["OT safety check, then isolate WS-07"]
}
// then code checks it: real IDs only, valid ATT&CK, risk floor → P1
Where it runs
HostedAlbulena on our server. Your team opens it in the browser, nothing to install.
Self-hostedThe same build on your own server, next to the data, with local models. For sites that cannot send alerts out.
15–25 minFull demo day of 2,993 alerts on one M-series Mac. About 2x faster with 4 parallel Ollama slots.
Secondsmake replay-fast: rule-based agents and template verdicts, no LLM at all.
~5 smake test: offline test suite, no model needed.
Test modeOpenRouter can stand in for Ollama with synthetic data only. The UI shows a cloud banner.