Share 
## https://sploitus.com/exploit?id=198F1402-8E1A-5E70-A157-FF7BF2092BF1
# โšก Decepticon โ€” Autonomous Multi-Agent Offensive Security

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Python Version](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
[![Status](https://img.shields.io/badge/status-experimental-orange.svg)](README.md)

## Overview

Decepticon is an autonomous offensive security framework built for modern red team operations. It combines multi-agent reasoning, modular cyber personas, and LangGraph orchestration to enable AI-driven reconnaissance, exploitation, and reporting workflows.

This repository is designed for advanced users who want a platform for autonomous penetration testing research and secure red team automation.

## Why This Project

- Autonomous multi-agent orchestration for offensive workflows.
- Agent roles that map to reconnaissance, planning, initial access, and reporting.
- Support for both CLI and Streamlit web interfaces.
- Docker-based lab environment with attacker and victim containers.
- Designed for rapid experimentation with LLM-driven cybersecurity agents.

## Quick Start

### 1. Clone the repository
```bash
git clone https://github.com//.git
cd Autonomous-Multi-Agent-Offensive-Security-main
```

### 2. Create a Python virtual environment
```bash
python -m venv .venv
```

### 3. Activate the environment
- Windows:
  ```powershell
  .\.venv\Scripts\Activate.ps1
  ```
- macOS / Linux:
  ```bash
  source .venv/bin/activate
  ```

### 4. Install dependencies
```bash
pip install -r requirements.txt
```

### 5. Configure environment variables
```bash
cp .env.example .env
```
Update `.env` with your API keys and LangGraph settings.

### 6. Start the Docker lab
```bash
docker compose up -d --build
```

### 7. Run the application
- CLI mode:
  ```bash
  python frontend/cli/cli.py
  ```
- Web UI:
  ```bash
  streamlit run frontend/web/streamlit_app.py
  ```

## Recommended Configuration

Update `.env` with the following values:

- `OPENAI_API_KEY`
- `ANTHROPIC_API_KEY`
- `LANGSMITH_API_KEY`
- `LANGSMITH_ENDPOINT`
- `LANGSMITH_PROJECT`
- `LANGGRAPH_API_URL`

## Project Structure

- `frontend/`: CLI and Streamlit user interfaces
- `src/`: agent workflows, prompts, tools, and utilities
- `docker-compose.yml`: attacker and victim container orchestration
- `Dockerfile.attacker`: Kali-based attacker image
- `.env.example`: environment configuration template

## Best Practices for Uploading to GitHub

1. Remove any existing remote if needed:
   ```bash
git remote remove origin
```
2. Add your new repository remote:
   ```bash
git remote add origin https://github.com//.git
```
3. Push to GitHub:
   ```bash
git push -u origin main
```

> If you need to use a personal access token, prefer `gh auth login` or Git Credential Manager rather than embedding the token in the URL.

## Notes

- This repository is experimental and intended for authorized security research.
- Do not run offensive tooling against systems without explicit permission.
- Keep secrets and API keys secure at all times.

## License

Apache License 2.0