AgentOps Guardian 🛡️
AgentOps Guardian is a self-healing DevOps framework built for the Mistral AI Hackathon 2026 that automatically detects and repairs LLM vulnerabilities in real-time. By integrating Mistral AI, it monitors agentic workflows for prompt injections and "hallucination crashes," autonomously pushing verified code fixes to secure the pipeline.
Features
- 🔍 Real-time Vulnerability Detection - Continuously monitors LLM-powered agents for security threats
- 🛡️ Prompt Injection Defense - Identifies and blocks malicious prompt injection attempts
- 🔧 Self-Healing Capabilities - Automatically generates and applies code fixes to vulnerable components
- 🤖 Mistral AI Integration - Leverages Mistral AI for intelligent threat analysis and remediation
- 📊 Hallucination Crash Prevention - Detects and mitigates LLM output anomalies before they impact production
- ✅ Verified Fix Deployment - Validates and safely deploys security patches to the pipeline
- 📄 Text Analysis & Security Reporting - Analyzes text files for security vulnerabilities and generates comprehensive reports
Installation
Prerequisites
Install uv - a fast Python package installer:
# On macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or with pip:
pip install uv
Setup
# Clone the repository
git clone <your-repo-url>
cd agentSecOps_Guardian
# Create a virtual environment and install dependencies
uv venv
source .venv/bin/activate # On macOS/Linux
# .venv\Scripts\activate # On Windows
# Install dependencies
uv pip install -r requirements.txt
Installing the Package in development mode
To install the secure CLI tool system-wide:
# Install in development mode (recommended for development)
pip install -e .
or
uv build
After installation, you can run the secure command from anywhere:
# Run security analysis on a file
secure ./tests/example_backend.py
# With Mistral AI analysis (requires API key)
secure ./tests/example_backend.py --mistral --mistral-key your_api_key
📋 Report generated: report.md
Usage
Running the Security Analysis CLI
After installation, you can use the secure command:
# Basic usage - analyze a text file and generate security report
secure input_file.txt
# With output file specification
secure input_file.txt -o security_report.md
# With text processing options
secure input_file.txt -l -s -w --lines
# With Mistral AI analysis (requires API key)
secure input_file.txt --mistral --mistral-key your_api_key
# With different analysis types
secure input_file.txt --mistral --analysis-type prompt_injection
# Advanced options
secure input_file.txt --verbose --no-patterns
# Available options:
# -l, --lowercase Convert text to lowercase
# -s, --strip Strip leading/trailing whitespace
# -w, --remove-whitespace Remove extra whitespace between words
# --lines Process line by line (removes empty lines)
# -o, --output Output report file path (default: report.md)
# --mistral Enable Mistral AI analysis
# --mistral-key Mistral API key (overrides MISTRAL_API_KEY env var)
# --analysis-type Type of Mistral analysis (prompt_injection, hallucination, etc.)
# --verbose Enable verbose output
# --no-patterns Skip pattern-based security analysis
Example Workflow
-
Analyze a configuration file for security issues:
python -m agentsecops.main config.txt -o config_security_report.md
-
Process and analyze a log file:
python -m agentsecops.main app.log --lines -s -o log_analysis.md
-
Analyze code files for potential vulnerabilities:
python -m agentsecops.main source_code.py -o code_security_report.md
Development
# Install development dependencies
uv pip install -r requirements-dev.txt
# Run tests
pytest
# Run specific test files
pytest tests/test_main.py
pytest tests/test_textfile_parsing.py
# Run linter
flake8 agentsecops tests
# Format code
black agentsecops tests
Architecture
The current architecture focuses on text analysis and security reporting:
agentsecops/
├── __init__.py # Package initialization
├── main.py # Main CLI orchestrator
├── cli.py # Original CLI (deprecated, use main.py)
├── parsing/
│ └── textfile.py # Text file parsing utilities
├── securityinstructions/ # Security analysis module
│ └── __init__.py # Security pattern detection
└── reporting/ # Reporting module
└── __init__.py # Markdown report generation
tests/
├── test_main.py # Main workflow tests
└── test_textfile_parsing.py # Text parsing tests
How It Works
- Text Parsing -
agentsecops/parsing/textfile.pyreads and processes text files with various transformation options - Security Analysis -
agentsecops/securityinstructions/analyzes content for:- Potential passwords and credentials
- API keys and secrets
- Sensitive data patterns (emails, credit cards, SSNs)
- Common security issues (eval(), exec(), insecure protocols)
- Report Generation -
agentsecops/reporting/creates comprehensive markdown reports with findings - CLI Orchestration -
agentsecops/main.pycoordinates the entire workflow
Security Analysis Capabilities
The system detects various security issues:
- Passwords:
password=,passwd=,pwd=patterns - API Keys:
api_key=,secret=,token=patterns and long hex strings - Sensitive Data: Credit card numbers, SSN patterns, email addresses
- Security Issues: Use of
eval(),exec(),pickle.load(), insecure HTTP, path traversal
Example Security Report
When you run the analysis, it generates a detailed markdown report:
# Security Analysis Report
**Generated:** 2026-02-28 12:34:56
---
## Analysis Metadata
- **Content Length:** 1024 characters
- **Line Count:** 42 lines
---
## 🔴 Potential Passwords Found (2)
### Line 15
**Match:** `password = secret123`
**Context:** `database_password = secret123`
### Line 23
**Match:** `api_key = abc123`
**Context:** `config.api_key = abc123`
---
## 📊 Summary
- **Total Findings:** 5
- **Passwords:** 2
- **API Keys:** 1
- **Sensitive Data:** 1
- **Security Issues:** 1
⚠️ **Recommendation:** Review the findings above and address any genuine security issues.
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/security-enhancement) - Commit your changes (
git commit -m 'Add security enhancement') - Push to the branch (
git push origin feature/security-enhancement) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for Mistral AI Hackathon 2026
Mistral AI Hackathon 2026
This project was created for the Mistral AI Hackathon 2026, showcasing the potential of AI-driven security automation in DevOps workflows. AgentOps Guardian demonstrates how advanced language models can be leveraged to create self-healing systems that protect against emerging LLM security threats.
Metadata
Release files for agentsecops 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentsecops-0.1.0.tar.gz | 22.6 kB | Without provenance | Details for agentsecops-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentsecops-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for agentsecops-0.1.0-py3-none-any.whl |
Total release size: 39.7 kB
Release files / agentsecops-0.1.0.tar.gz
| Download URL | agentsecops-0.1.0.tar.gz |
|---|---|
| Size | 22.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a59dd7e43a440d102d5bd98b779a7e5a862ec2c8d98e96b69155d7b8af0ba0c
|
|
BLAKE2b-256 checksum How to use checksums |
f5dc2e662b5a3ed26b016b75aec463f3db7f16d0b8a166f5261aa8816dbe092d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / agentsecops-0.1.0-py3-none-any.whl
| Download URL | agentsecops-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac1779bf91c9e6fa764f336c910367a3e34e552967d9b3f8b012abd9b215d152
|
|
BLAKE2b-256 checksum How to use checksums |
52e16b282dbd6e312bf2f13d76eec894543fcfec4597bf9fcd1e9f28cdbf72cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for agentsecops 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.