Skip to content

armgit / AiSOC

Public Imported from GitHub
0

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.

1.7 KB
Raw Blame

aisoc-cli

Developer CLI for building, validating, and publishing AiSOC plugins and detection rules.

Status — monorepo today, not yet on PyPI. The CLI ships from this monorepo and is fully functional today. pip install aisoc-cli does not resolve: the upload is blocked on registry credentials, which is an account action rather than a code change. The CLI name (aisoc) and command surface stay identical once it ships.

Installation

# Today (from this monorepo):
git clone https://github.com/beenuar/AiSOC.git
cd AiSOC && pip install -e packages/aisoc-cli

# Not yet on PyPI — the upload is blocked on registry credentials,
# which is an account action rather than a code change. Until then, install
# from source with the command above.
#   pipx install aisoc-cli     # recommended (isolated venv)
#   pip install aisoc-cli

Commands

Plugin Scaffold

aisoc plugin scaffold my-enricher
aisoc plugin scaffold my-connector --type connector

Plugin Validate

aisoc plugin validate ./my-enricher
aisoc plugin validate ./my-enricher/plugin.yaml

Plugin Publish

export AISOC_API_URL=https://api.example.com
export AISOC_API_KEY=sk-...
aisoc plugin publish ./my-enricher

Detection Validate

aisoc detection validate ./detections/brute-force.yaml

Key Generation

aisoc keygen              # generates ~/.aisoc/signing.key + signing.pub

Environment Variables

Variable Description
AISOC_API_URL AiSOC API base URL (default: http://localhost:8000)
AISOC_API_KEY API key for authentication
AISOC_SIGNING_KEY Path to Ed25519 private key (default: ~/.aisoc/signing.key)