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 (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
- ๐ Aletheia Sovereign Systems: https://holeyfield33-art.github.io/unitarity-lab
- โ Support: https://buymeacoffee.com/holeyfielde
- ๐ GitHub: https://github.com/holeyfield33-art/aletheia-core
ยฉ 2026 Aletheia Sovereign Systems โ MIT License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e38c5ce079e92beb936c60cc9efefbaf0d3aca283baf5eabce15897dfb2ddd7
|
|
| MD5 |
a923dd07768cb52977e606c69c41df42
|
|
| BLAKE2b-256 |
42f1b043c48ae8de432cee1e870ddb94383ef5073c210be04447a2b95b23df8d
|
Provenance
The following attestation bundles were made for aletheia_cyber_core-1.0.0.tar.gz:
Publisher:
publish.yml on holeyfield33-art/aletheia-core
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aletheia_cyber_core-1.0.0.tar.gz -
Subject digest:
3e38c5ce079e92beb936c60cc9efefbaf0d3aca283baf5eabce15897dfb2ddd7 - Sigstore transparency entry: 1114062731
- Sigstore integration time:
-
Permalink:
holeyfield33-art/aletheia-core@36c9e6a11df9ea843b4e1ed854c7c5edfa9a3935 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/holeyfield33-art
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@36c9e6a11df9ea843b4e1ed854c7c5edfa9a3935 -
Trigger Event:
release
-
Statement type:
File details
Details for the file aletheia_cyber_core-1.0.0-py3-none-any.whl.
File metadata
- Download URL: aletheia_cyber_core-1.0.0-py3-none-any.whl
- Upload date:
- Size: 19.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7ef46e15883c36fae19d6984fc343bf51390ffda7ed00f9570e95737241e20d
|
|
| MD5 |
21dbd1c54c5a4f6ad93b48ca258c1329
|
|
| BLAKE2b-256 |
9b0d9b72507cef1cf7712b270ddf585b934e4a548972bd1ddc3ec1c06840f745
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aletheia_cyber_core-1.0.0-py3-none-any.whl -
Subject digest:
d7ef46e15883c36fae19d6984fc343bf51390ffda7ed00f9570e95737241e20d - Sigstore transparency entry: 1114062734
- Sigstore integration time:
-
Permalink:
holeyfield33-art/aletheia-core@36c9e6a11df9ea843b4e1ed854c7c5edfa9a3935 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/holeyfield33-art
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@36c9e6a11df9ea843b4e1ed854c7c5edfa9a3935 -
Trigger Event:
release
-
Statement type: