https://github.com/splx-ai/agentic-radar
A security scanner for your LLM agentic workflows
https://github.com/splx-ai/agentic-radar
agentic-ai agentic-framework agentic-workflow ai ai-red-teaming ai-security cli devsecops generative-ai llm llm-security red-teaming security security-tools
Last synced: 2 months ago
JSON representation
A security scanner for your LLM agentic workflows
- Host: GitHub
- URL: https://github.com/splx-ai/agentic-radar
- Owner: splx-ai
- License: apache-2.0
- Created: 2025-02-12T11:50:49.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-27T15:30:33.000Z (2 months ago)
- Last Synced: 2025-03-27T16:36:28.877Z (2 months ago)
- Topics: agentic-ai, agentic-framework, agentic-workflow, ai, ai-red-teaming, ai-security, cli, devsecops, generative-ai, llm, llm-security, red-teaming, security, security-tools
- Language: Python
- Homepage: https://splx.ai
- Size: 14.3 MB
- Stars: 339
- Watchers: 9
- Forks: 34
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- trackawesomelist - Agentic Radar (⭐479) - Open-source CLI security scanner for agentic AI workflows. (Recently Updated / [May 11, 2025](/content/2025/05/11/README.md))
- awesome-langchain - Agentic Radar - Open-source CLI security scanner for agentic workflows. Scans your workflow’s source code, detects vulnerabilities, and generates an interactive visualization along with a detailed security report.  (Tools / Services)
- awesome-hacking-lists - splx-ai/agentic-radar - A security scanner for your LLM agentic workflows (Python)
- awesome-llm-security - Agentic Radar - source CLI security scanner for agentic workflows.  (Tools / Survey)
- Awesome-AI-Agents - Agentic Radar - Open-source CLI security scanner for agentic workflows. Scans your workflow’s source code, detects vulnerabilities, and generates an interactive visualization along with a detailed security report.  (Applications / Advanced Components)
- awesome-ai-security - Agentic Radar - _Open-source CLI security scanner for agentic workflows._ (Offensive tools and frameworks / LLM)
README
A Security Scanner for your agentic workflows!
View Demo
·
Documentation
·
Report Bug
·
Request Feature
Table of Contents
-
Description
-
Getting Started
- Usage
- Roadmap
- Demo
- Blog Tutorials
- Community
- Frequently Asked Questions
- Contributing
- Code Of Conduct
- 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. **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.
**Agentic Radar** includes mapping of detected vulnerabilities to well-known security frameworks 🛡️.
+ [OWASP Top 10 LLM Applications](https://owasp.org/www-project-top-10-for-large-language-model-applications/)
+ [OWASP Agentic AI – Threats and Mitigations](https://genaisecurityproject.com/resource/agentic-ai-threats-and-mitigations)
**Why Use It?** 🔎
Agentic systems have complex workflows and often interact with multiple tools, making transparency and security assessment challenging. This tool simplifies the process by offering a structured view of workflows, tools, and potential risks.
**Detailed Report**
## Getting Started 🚀
### Prerequisites
There are none! Just make sure you have Python (pip) installed on your machine.
### Installation
```sh
pip install agentic-radar
# Check that it is installed
agentic-radar --version
```
#### CrewAI Installation
For better tool descriptions in CrewAI, you can install the `crewai` extra:
```sh
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.
## Usage
Run `agentic-radar --help` for more info:
```
Usage: agentic-radar [OPTIONS] COMMAND [ARGS]...
Options:
-i, --input-dir TEXT Path to the directory where all the code is
[env var: AGENTIC_RADAR_INPUT_DIRECTORY;
default: .]
-o, --output-file TEXT Where should the output report be stored
[env var: AGENTIC_RADAR_OUTPUT_FILE;
default: report_20250311_122338.html]
--version
--install-completion [bash|zsh|fish|powershell|pwsh]
Install completion for the specified shell.
--show-completion [bash|zsh|fish|powershell|pwsh]
Show completion for the specified shell, to
copy it or customize the installation.
--help Show this message and exit.
Commands:
langgraph Scan code written with LangGraph
crewai Scan code written with CrewAI
n8n Scan a n8n workflow configuration JSON
openai-agents Scan code written with OpenAI Agents SDK
```
## Roadmap 📈
Planned features (in no particular order)
- [ ] Framework Support
- [x] [LangGraph](https://github.com/langchain-ai/langgraph)
- [x] [CrewAI](https://github.com/crewAIInc/crewAI)
- [x] [n8n](https://github.com/n8n-io/n8n)
- [x] [OpenAI Agents](https://github.com/openai/openai-agents-python)
- [ ] [LlamaIndex](https://github.com/run-llama/llama_index)
- [ ] [Swarm](https://github.com/openai/swarm)
- [ ] [PydanticAI](https://github.com/pydantic/pydantic-ai)
- [ ] [AutoGen](https://github.com/microsoft/autogen)
- [ ] [Dify](https://github.com/langgenius/dify)
- [x] CI
- [x] Code style checks
- [x] Automated releases to PyPi
- [x] Improve report design
- [x] Improve SVG scaling
## Demo 🎥
**[Demo Google Colab Notebook](https://colab.research.google.com/drive/1AAN23QAMsm0C7KGRmSSw7G2WFatzIa46?usp=sharing) 📘**
Designed for AI engineers and security researchers, this demo showcases how to integrate **Agentic Radar** into your development workflow. ⚙️
It helps you understand agentic system behavior, visualize security risks, and enhance AI transparency in your applications. 🚀
## Blog Tutorials 💡
- [CrewAI](https://splx.ai/blog/enhancing-ai-transparency-scanning-crewai-workflows-with-agentic-radar)
- [n8n](https://splx.ai/blog/scanning-n8n-workflows-with-agentic-radar)
## Community 🤝
We welcome contributions from the AI and security community! Join our [Discord community](https://discord.gg/QZQpef5PsD) or [Slack community](https://join.slack.com/t/splxaicommunity/shared_invite/zt-31b3hc3mt-A0v78qztTIMSNBg6y~WOAA) to connect with other developers, discuss features, get support and contribute to **Agentic Radar** 🚀
If you like what you see, give us a star! It keeps us inspired to improve and innovate and helps others discover the project 🌟
## Frequently Asked Questions ❓
**Q: Is my source code being shared or is everything running locally?**
A: Everything is running locally. Your source code is never uploaded anywhere.
## Contributing 💻
[CONTRIBUTING](CONTRIBUTING.md)
## Code Of Conduct 📜
[CODE OF CONDUCT](CODE_OF_CONDUCT.md)
## License ⚖️
[LICENSE](LICENSE)