DoomArena is a modular, configurable, plug-in security testing framework for AI agents that supports many agentic frameworks including $\tau$-bench, Browsergym, OSWorld and TapeAgents (see Mail agent example). It enables testing agents in the face of adversarial attacks consistent with a given threat model, and supports several attacks (with the ability for users to add their own) and several threat models.
The DoomArena Intro Notebook
is a good place for learning hands-on about the core concepts of DoomArena.
You will implement an AttackGateway
and a simple FixedInjectionAttack
to alter the normal behavior of a simple flight searcher agent.
If you only want to use the library just run
pip install doomarena # core library, minimal dependencies
If you want to run DoomArena integrated with TauBench, additionally run
pip install doomarena-taubench # optional
If you want to run DoomArena integrated with Browsergym, additionally run
pip install doomarena-browsergym # optional
If you want to test attacks on a Mail Agent (which can summarize and send emails on your behalf) inspired by the LLMail Challenge run
pip install -e doomarena/mailinject # optional
If you want to run DoomArena integrated with OSWorld run
pip install -e doomarena/osworld
and follow our setup instructions here.
Export relevant API keys into your environment or .env
file.
OPENAI_API_KEY="<your api key>"
OPENROUTER_API_KEY="<your api key>"
To actively develop DoomArena
, please create a virtual environment and install the package locally in editable mode using
pip install -e doomarena/core
pip install -e doomarena/taubench
pip install -e doomarena/browsergym
pip install -e doomarena/mailinject
pip install -e doomarena/osworld
Once the environments are set up, run the tests to make sure everything is working.
make ci-tests
make tests # requires openai key
Follow the environment-specific instructions for TauBench and BrowserGym
Note: contributions made prior to the open-sourcing are not accounted for; please refer to author list for full list of contributors.
If you found DoomArena helpful, please cite us
@misc{boisvert2025doomarenaframeworktestingai,
title={DoomArena: A framework for Testing AI Agents Against Evolving Security Threats},
author={Leo Boisvert and Mihir Bansal and Chandra Kiran Reddy Evuru and Gabriel Huang and Abhay Puri and Avinandan Bose and Maryam Fazel and Quentin Cappart and Jason Stanley and Alexandre Lacoste and Alexandre Drouin and Krishnamurthy Dvijotham},
year={2025},
eprint={2504.14064},
archivePrefix={arXiv},
primaryClass={cs.CR},
url={https://arxiv.org/abs/2504.14064},
}