aegis-gateway

aegis-gateway

Aegis is a self-hosted AI gateway. It sits between your applications and any LLM provider, runs every request through guardrails you declare in one YAML file, and records every decision in a hash-chained audit ledger — so "why was this blocked, masked or paused, and who signed off?" always has an answer.

This is the umbrella package: the aegis CLI, the server, the kernel and all first-party policy packs.

Install

pip install aegis-gateway
python -m spacy download en_core_web_sm   # model used by the PII pack

Requires Python 3.12+.

Sixty seconds to a governed endpoint

aegis init                                 # aegis.yaml: fake provider + PII masking
aegis serve --config aegis.yaml --no-auth  # http://localhost:8000

Point any OpenAI client at it — the model field selects an Aegis route:

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8000/v1", api_key="dev")
reply = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Email jane@example.com the summary"}],
)
print(reply.choices[0].message.content)  # the model only ever saw <EMAIL_ADDRESS_0>

Then read the trail:

export AEGIS_SERVER_URL=http://localhost:8000
aegis explain --last                                    # verdict-by-verdict trail
aegis audit export -o ledger.jsonl && aegis audit verify ledger.jsonl

Four verdicts, nothing else

What's included

Install a subset instead if you only need part of it — e.g. pip install aegis-gateway-core to build a plugin.

Learn more

• Documentation — guide, policy packs, plugin development, reference
• Changelog · Releases
• Source & issues

Aegis is alpha software, licensed under AGPL-3.0-or-later.