whatisgithub

What is al-munaa?

farhanward/al-munaa — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · easy

In one sentence

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

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

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 build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythoncryptographyEd25519GPT-5.6

How does it compare?

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 you get it running?

Difficulty · easy Time to first run · 5min

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

So what is it?

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.

Copy-paste prompts

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?

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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.