agentic-radar

Table of Contents

1. Description
2. Agentic Visualizer
3. Getting Started
   • Prerequisites
   • Installation
4. Advanced Installation
   • CrewAI Installation
   • OpenAI Agents Installation
5. Usage
6. Advanced Features
   • Agentic Prompt Hardening
   • Test for Vulnerabilities in Agentic Workflows
   • CI/CD Workflow
7. Roadmap
8. Blogs and Tutorials
9. Community
10. Frequently Asked Questions
11. Contributing
12. Code Of Conduct
13. License

Description 📝

The Agentic Radar is designed to analyze and assess agentic systems for security and operational insights. It helps developers, researchers, and security professionals understand how agentic systems function and identify potential vulnerabilities.

It allows users to create a security report for agentic systems, including:

1. Workflow Visualization - a graph of the agentic system's workflow✅
2. Tool Identification - a list of all external and custom tools utilized by the system✅
3. MCP Server Detection - a list of all MCP servers used by system's agents✅
4. Vulnerability Mapping - a table connecting identified tools to known vulnerabilities, providing a security overview✅

The comprehensive HTML report summarizes all findings and allows for easy reviewing and sharing.

View Full Report Example Here

Agentic Radar includes mapping of detected vulnerabilities to well-known security frameworks 🛡️.

• OWASP Top 10 LLM Applications

• OWASP Agentic AI – Threats and Mitigations

Agentic Visualizer 🎆

If you only care about visualization, try out the Agentic Visualizer.

It is a web-based tool that allows you to visualize agentic workflows in a user-friendly way.

Getting Started 🚀

Prerequisites

There are none! Just make sure you have Python (pip) installed on your machine.

Installation

pip install agentic-radar

# Check that it is installed
agentic-radar --version

Some features require extra installations, depending on the targeted agentic framework. See more below.

Advanced Installation

CrewAI Installation

CrewAI extras are needed when using one of the following features in combination with CrewAI:

• Agentic Radar Test
• Descriptions for predefined tools

You can install Agentic Radar with extra CrewAI dependencies by running:

pip install "agentic-radar[crewai]"

[!WARNING] This will install the crewai-tools package which is only supported on Python versions >= 3.10 and < 3.13. If you are using a different python version, the tool descriptions will be less detailed or entirely missing.

OpenAI Agents Installation

OpenAI Agents extras are needed when using one of the following features in combination with OpenAI Agents:

• Agentic Radar Test

You can install Agentic Radar with extra OpenAI Agents dependencies by running:

pip install "agentic-radar[openai-agents]"

Usage

Agentic Radar now supports two main commands:

1. scan

Scan code for agentic workflows and generate a report.

agentic-radar scan [OPTIONS] FRAMEWORK:{langgraph|crewai|n8n|openai-agents|autogen}

Example:

agentic-radar scan langgraph -i path/to/langgraph/example/folder -o report.html

---

2. test

Test agents in an agentic workflow for various vulnerabilities. Requires OPENAI_API_KEY set as environment variable.

agentic-radar test [OPTIONS] FRAMEWORK:{openai-agents} ENTRYPOINT_SCRIPT_WITH_ARGS

Example:

agentic-radar test openai-agents "path/to/openai-agents/example.py"

See more about this feature here.

Advanced Features ✨

Agentic Prompt Hardening