Files
ai-llm-red-team-handbook/scripts/examples/README.md
T

98 lines
2.0 KiB
Markdown

# Example Scripts
This directory contains example implementations and demonstration scripts.
## 📜 Scripts
### `c2_server_elite.py` (56 KB)
Advanced Command & Control (C2) server demonstration showing sophisticated attack infrastructure capabilities.
**Features:**
- Multi-protocol support
- Encryption and obfuscation
- Command execution framework
- Advanced payload delivery
**Usage:**
```bash
python3 examples/c2_server_elite.py --help
```
⚠️ **For educational and authorized testing only!**
### `runner.py`
Test runner framework for executing LLM red team test suites.
**Purpose:**
- Orchestrates multiple test executions
- Collects and aggregates results
- Generates JSON reports
**Usage:**
```bash
python3 examples/runner.py
```
Requires:
- `client.py` - LLM client implementation
- `config.py` - Configuration settings
- `models.py` - Data models
### `models.py`
Data models and base classes for LLM security testing.
**Components:**
- `TestResult` - Dataclass for test results
- `BaseTest` - Base class for test implementations
**Usage:**
```python
from examples.models import TestResult, BaseTest
class MyTest(BaseTest):
id_prefix = "TEST"
category = "custom"
def run(self, client):
# Test implementation
return [TestResult(...)]
```
## 🎯 Purpose
These examples demonstrate:
- Advanced attack techniques
- Testing framework patterns
- Data model structures
- Integration approaches
## ⚠️ Security Notice
**These are demonstration scripts for authorized security testing only.**
- Review code before execution
- Only use in controlled environments
- Follow responsible disclosure practices
- Respect all applicable laws and regulations
## 🔗 Related Documentation
- [Main Scripts](../docs/README.md)
- [Testing Guide](../docs/TESTING_GUIDE.md)
- [Quick Start](../docs/QUICKSTART.md)
---
**Note:** These examples are provided for educational purposes and to demonstrate implementation patterns. Adapt them to your specific testing requirements.