git404hub

what is al-munaa fr?

farhanward/al-munaa — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · easy

tl;dr

A security wrapper for AI agents that blocks prompt injection attacks and lets agents share attack signatures without sharing the raw attack text.

vibe map

vibe map loading… check back in a sec.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Wrap an existing AI agent so its inputs, tool calls, and outputs get scanned for prompt injection.

VIBE 2

Let a fleet of agents share signed attack signatures without exposing the raw malicious text.

VIBE 3

Run the bundled offline demo to see an attack get blocked and an antibody shared between two agents.

VIBE 4

Use the calibration script to measure false positive and false negative rates on your own attack samples.

what's the stack?

PythoncryptographyEd25519GPT-5.6

how it stacks up fr

farhanward/al-munaa0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Core demo runs offline with only the cryptography package, an OpenAI API key is optional for live GPT-5.6 features.

in plain english

AL-MUNAA is a security layer you wrap around an AI agent to protect it from prompt injection attacks, which are hidden instructions hiding inside content the agent reads, such as a README file, a web page, or a tool response, trying to trick it into leaking secrets or running dangerous commands. It scans what the agent reads, checks what the agent is about to do before it acts, and reviews what the agent outputs, all before anything reaches the outside world. What makes this project different is how it lets separate agents share what they learned about an attack without sharing the actual attack text, secrets, or conversation. When it catches an attack, it builds what the project calls an antibody: a set of hashed, fingerprint-like signatures of the attack pattern that can recognize reworded or disguised variants of the same attack, but cannot be reversed back into the original text. Other agents can import this signed antibody from a publisher they explicitly trust, so if one agent gets attacked, others in the same trust group become immune to that specific attack pattern without ever seeing the raw malicious content. Ambiguous or unclear cases get escalated to GPT-5.6 for a structured risk analysis, but the final allow, review, or block decision always stays governed by the project's own policy rules rather than resting entirely on the model's judgement. The project includes a calibration script and a small synthetic test set of attack variants and benign lookalike text to measure how accurately the matching works, along with a bundled demo you can run end to end without needing any API key. It is written in Python 3.10 or newer, needs only the cryptography library to run the core demo offline, and ships as an installable package with a small SDK for wrapping your own agent's input, tool calls, and output checks.

prompts (copy fr)

prompt 1
Walk me through running the offline demo in demo/run_demo.py to see AL-MUNAA block an attack.
prompt 2
Show me how to wrap my own agent's tool calls using the Guard class from munaa_immune.
prompt 3
Explain how AL-MUNAA's antibody fingerprint can catch a reworded prompt injection without storing the original text.
prompt 4
Help me set up two agents that share antibodies through a trusted publisher registry.

Frequently asked questions

what is al-munaa fr?

A security wrapper for AI agents that blocks prompt injection attacks and lets agents share attack signatures without sharing the raw attack text.

What language is al-munaa written in?

Mainly Python. The stack also includes Python, cryptography, Ed25519.

How hard is al-munaa to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is al-munaa for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.