Skip to main content

A 2026-native, multi-agent security framework for protecting autonomous AI systems from instruction smuggling, noise-jamming, and meta-injections.

Project description

Aletheia Cyber-Defense

๐Ÿ›ก๏ธ Aletheia Cyber-Defense (ACD)

A 2026-native, multi-agent security framework designed to protect autonomous AI systems from instruction smuggling, noise-jamming, and meta-injections.

In an era where AI agents manage CI/CD pipelines, finance, and operations, Aletheia provides the System 2 Reasoning layer that ensures every action is verified, traced, and aligned with core intent.

Status: Alpha. Active development. APIs may change.


๐Ÿš€ Key Features

  • Polymorphic Defense โ€” Rotates reasoning methodology to prevent prompt-path exploitation and blueprint leakage
  • Structural Intent Analysis (SIA) โ€” Traces the origin of authority for every tool call, neutralizing smuggled instructions in metadata
  • The Judge (Air-Gapped Veto) โ€” Centralized arbiter that validates policy shifts against a cryptographically signed security manifest
  • Swarm-Resistant Triage โ€” Scout agent clusters diversionary noise and prioritizes high-blast-radius threats

๐Ÿ—๏ธ Architecture

Aletheia operates via a Tri-Agent Consensus model:

Incoming Request
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚    Scout    โ”‚  Real-time threat intelligence + swarm detection
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
       โ”‚
       โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Nitpicker  โ”‚  Polymorphic intent analysis + lineage tracing
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
       โ”‚
       โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚    Judge    โ”‚  Hard veto against signed security manifest
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
       โ”‚
  PROCEED / DENY

๐Ÿ“‚ Project Structure

aletheia-cyber-core/
โ”œโ”€โ”€ agents/
โ”‚   โ”œโ”€โ”€ scout_v2.py        # Threat intelligence + swarm detection
โ”‚   โ”œโ”€โ”€ nitpicker_v2.py    # Polymorphic intent sanitization
โ”‚   โ””โ”€โ”€ judge_v1.py        # Policy enforcement + hard veto
โ”œโ”€โ”€ bridge/
โ”‚   โ””โ”€โ”€ fastapi_wrapper.py # Production REST API
โ”œโ”€โ”€ manifest/
โ”‚   โ””โ”€โ”€ security_policy.json  # Ground truth veto rules
โ”œโ”€โ”€ simulations/
โ”‚   โ”œโ”€โ”€ adversarial_loop.py   # Adversarial training scenarios
โ”‚   โ””โ”€โ”€ shadow_audit_01.py    # Real-world attack vectors
โ”œโ”€โ”€ legal/
โ”‚   โ””โ”€โ”€ SOVEREIGNTY.md     # Governance principles
โ”œโ”€โ”€ main.py                # CLI entry point
โ”œโ”€โ”€ AGENTS.md              # Agent communication protocol
โ””โ”€โ”€ requirements.txt

๐Ÿ› ๏ธ Quick Start

pip install -r requirements.txt

Run a local audit (pure Python, no web server required):

python main.py

Start the API server (FastAPI wrapper for HTTP integrations):

uvicorn bridge.fastapi_wrapper:app --reload

Run adversarial simulations:

PYTHONPATH=. python simulations/adversarial_loop.py
PYTHONPATH=. python simulations/shadow_audit_01.py
PYTHONPATH=. python simulations/lunar_shadow_audit.py
PYTHONPATH=. python simulations/neutral_anchor_audit.py

Configure veto rules โ€” edit manifest/security_policy.json


๐Ÿ”’ Security Manifest

The manifest/security_policy.json defines immutable veto rules:

Veto ID Action Blocked Rationale
VETO_01 Modify_Auth_Registry Prevents identity escalation
VETO_02 Open_External_Socket Prevents data exfiltration
VETO_03 Bulk_Delete_Resource Prevents destructive payloads

All policy changes require dual-key sign-off.


๐Ÿค Governance

See legal/SOVEREIGNTY.md for the Aletheia Sovereignty Manifest:

  • Agentic Neutrality โ€” provider agnostic
  • Human Anchor โ€” manual sign-off on hard veto rules
  • Open Verification โ€” cryptographically verifiable audit results

๐Ÿ“ฆ API Reference

POST /v1/audit

{
  "payload": "string",
  "origin": "trusted_admin | untrusted_metadata | external_file",
  "action": "string",
  "ip": "string"
}

Response:

{
  "decision": "PROCEED | DENIED",
  "metadata": {
    "threat_level": 1.2,
    "latency_ms": 14.0,
    "redacted_payload": "string"
  },
  "reasoning": "string"
}

See docs/LAUNCH_GUIDE.md for a beginner-friendly launch and distribution playbook.

๐Ÿ”— Links


ยฉ 2026 Aletheia Sovereign Systems โ€” MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aletheia_cyber_core-1.0.0.tar.gz (20.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aletheia_cyber_core-1.0.0-py3-none-any.whl (19.2 kB view details)

Uploaded Python 3

File details

Details for the file aletheia_cyber_core-1.0.0.tar.gz.

File metadata

  • Download URL: aletheia_cyber_core-1.0.0.tar.gz
  • Upload date:
  • Size: 20.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for aletheia_cyber_core-1.0.0.tar.gz
Algorithm Hash digest
SHA256 3e38c5ce079e92beb936c60cc9efefbaf0d3aca283baf5eabce15897dfb2ddd7
MD5 a923dd07768cb52977e606c69c41df42
BLAKE2b-256 42f1b043c48ae8de432cee1e870ddb94383ef5073c210be04447a2b95b23df8d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aletheia_cyber_core-1.0.0.tar.gz:

Publisher: publish.yml on holeyfield33-art/aletheia-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aletheia_cyber_core-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for aletheia_cyber_core-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d7ef46e15883c36fae19d6984fc343bf51390ffda7ed00f9570e95737241e20d
MD5 21dbd1c54c5a4f6ad93b48ca258c1329
BLAKE2b-256 9b0d9b72507cef1cf7712b270ddf585b934e4a548972bd1ddc3ec1c06840f745

See more details on using hashes here.

Provenance

The following attestation bundles were made for aletheia_cyber_core-1.0.0-py3-none-any.whl:

Publisher: publish.yml on holeyfield33-art/aletheia-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page