hackagent 0.7.0

HackAgent is an open-source security toolkit to detect vulnerabilities of your AI Agents.

AI Security Red-Team Toolkit

App -- Docs -- API

Overview

HackAgent is an open-source toolkit designed to help security researchers, developers and AI safety practitioners evaluate the security of AI agents. It provides a structured approach to discover potential vulnerabilities, including prompt injection, jailbreaking techniques, and other attack vectors.

🔥 Features

• Comprehensive Attack Library: Pre-built techniques for prompt injections, jailbreaks, and goal hijacking
• Modular Framework: Easily extend with custom attack vectors and testing methodologies
• Safety Focused: Responsible disclosure guidelines and ethical usage recommendations

🔌 AI Agent Frameworks Supported

🚀 Installation

Installation from PyPI

HackAgent can be installed directly from PyPI:

# With uv (recommended)
uv add hackagent

# Or with pip
pip install hackagent

📚 Quick Start

Run the interactive CLI to start testing your AI agents:

hackagent

Or use the SDK:

from hackagent import HackAgent, AgentTypeEnum

agent = HackAgent(
    name="my_agent",
    endpoint="http://localhost:8000",
    agent_type=AgentTypeEnum.GOOGLE_ADK
)

results = agent.hack(attack_config={
    "attack_type": "advprefix",
    "goals": ["Test goal"],
    # ... generator and judges config
})

Obtain your credentials at https://app.hackagent.dev

For detailed examples and advanced usage, visit our documentation.

📊 Reporting

HackAgent automatically sends test results to the dashboard for analysis and visualization.

Access your dashboard at https://app.hackagent.dev

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md and CODE_OF_CONDUCT.md for guidelines.

📜 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

⚠️ Disclaimer

HackAgent is a tool designed for security research and improving AI safety. Always obtain proper authorization before testing any AI systems. The authors are not responsible for any misuse of this software.

---

This project is for educational and research purposes. Always use responsibly and ethically.