Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.
Python agentic-aiai-securityalert-triageblue-teamcybersecuritydetection-engineeringincident-responselanggraphllm-agentsmcpmitre-attackmodel-context-protocolpurple-teamsecurity-operationsself-hostedsiemsoarsocthreat-detectionthreat-intelligence
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[project]
name = "aisoc-ueba"
version = "0.1.0"
description = "AiSOC UEBA — User & Entity Behaviour Analytics microservice"
requires-python = ">=3.11"
dependencies = [
# Floor 0.117: below it a `-> None` handler under PEP 563 trips FastAPI's
# "204 must not have a response body" assert at import. One range for
# every service — see services/api/pyproject.toml for the measurement.
"fastapi>=0.117,<0.162",
"uvicorn[standard]>=0.29.0",
"sqlalchemy[asyncio]>=2.0.0",
"asyncpg>=0.29.0",
"alembic>=1.13.0",
"pydantic>=2.0.0",
"pydantic-settings>=2.0.0",
"aiokafka>=0.10.0",
"numpy>=1.26.0",
"scipy>=1.12.0",
"httpx>=0.27.0",
"structlog>=24.1,<27.0",
"opentelemetry-sdk>=1.24.0",
"opentelemetry-exporter-otlp>=1.24.0",
"opentelemetry-instrumentation-fastapi>=0.45b0",
]
[project.optional-dependencies]
# `httpx` is bounded here as well as in the runtime list: a bare name in a
# dev extra widens the runtime bound to "any release ever published",
# which is the constraint pip then resolves against.
dev = ["pytest", "pytest-asyncio", "httpx>=0.27.0", "pytest-cov>=5,<8"]
# Phase 2.2 — coverage floor for CI gate.
#
# Measured baseline at the time of introduction: 3%. Floor is
# set at 2% (current - 2pp) so flaky branch-execution variance
# doesn't break main, while still catching any real regression. Raise
# this number as the suite grows — never lower it without a written
# justification. The pyproject is consulted by
# `pytest --cov-config=pyproject.toml --cov=app` in CI.
#
# Why pyproject instead of pytest.ini: keeps the floor next to the
# dep constraint that produced it, so a bump in either is reviewed
# in the same diff.
# Same shape as services/api and services/osquery-tls rather than a third
# strictness level. `python_version` is pinned so the finding set does not
# move with whatever interpreter mypy happens to run on.
[tool.mypy]
python_version = "3.11"
strict = false
ignore_missing_imports = true
[tool.coverage.run]
source = ["app"]
branch = true
[tool.coverage.report]
fail_under = 2
show_missing = true
skip_covered = false
exclude_lines = [
"pragma: no cover",
"raise NotImplementedError",
"if TYPE_CHECKING:",
"if __name__ == .__main__.:",
]