redcell

AI-агенты, которые проводят пентест от начала до конца и пишут отчёт.

[!WARNING] REDCELL предоставляется исключительно для обучения, исследований и легального авторизованного тестирования безопасности. Используйте его только для тестирования систем, которыми вы владеете или на тестирование которых у вас есть явное письменное разрешение, и только в рамках согласованной области. Несанкционированный доступ к компьютерным системам или вмешательство в их работу является преступлением в Азербайджане (статьи 271–273 Уголовного кодекса) и по законам большинства других стран. То, как вы его используете, и соблюдение закона — полностью ваша ответственность.

---

Что это такое

REDCELL проводит команду LLM-агентов через пентест. Оркестратор планирует работу и передаёт задачи агентам-исполнителям, которые запускают реальные инструменты внутри контейнера Kali и отчитываются о результатах. Вы наблюдаете за ходом и управляете им из консоли оператора: чат, который управляет оркестратором, живой граф агентов и лента активности, живой просмотр браузера, которым управляет агент, терминал на любом обратном шелле, который поймает агент, и отчёт, который можно передать по завершении работы.

Модели подключаются через LiteLLM, так что вы можете направить его на OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, локальный Ollama или что угодно ещё, что он поддерживает. Каждый запуск сохраняет контрольные точки по ходу работы, поэтому сбой или перезапуск продолжается с того места, где остановился.

Возможности

• Мультиагентный движок. Цикл plan/act на LangGraph. Оркестратор делегирует задачи агентам-исполнителям, которые запускают shell-инструменты и фиксируют находки, добычу и хосты по мере работы.
• Структурированные инструменты. Отдельные инструменты для nmap, nuclei, поиска директорий и vhost, а также поиска и запуска в Metasploit. Каждый разбирает свой вывод в поверхность атаки или находки, поэтому сканирование фиксирует хосты и уязвимости без дополнительного шага. run_command покрывает всё, для чего нет отдельного инструмента.
• Реальное выполнение, локально или удалённо. Инструменты выполняются в контейнере Kali через docker exec. Выбирайте localhost или сохранённый сервер для каждой сессии; удалённый сервер запускает тот же контейнер по SSH с host networking.
• Браузер агента. Для сценариев входа и приложений с интенсивным использованием JavaScript, до которых не добраться shell-инструментами, агент управляет настоящим Chromium в контейнере Kali. Вы наблюдаете за ним вживую и можете перехватить управление, чтобы прокликать что-то самостоятельно, а затем вернуть его обратно.
• Обратные шеллы. Агент открывает слушатель, перехватывает шелл и даёт вам интерактивный терминал на нём. Вы также можете открывать свои собственные терминалы и выполнять команды самостоятельно.
• Сетевое пивотирование. Маршрутизируйте трафик инструментов через перехваченный обратный шелл, чтобы добраться до хостов, видимых только с скомпрометированной машины. Обратный SOCKS-туннель chisel обеспечивает это, и nmap автоматически работает через туннель.
• Чат управляет запуском. Скажите чату, что вы хотите, и он управляет живым оркестратором или переоткрывает завершённый запуск для новой работы. Он также отвечает на вопросы о работе.
• Сессии сканирования кода. Направьте сессию на публичный git-репозиторий или локальную папку для проверки безопасности исходного кода, с привязкой находок к файлу и строке.
• Конфигурация для каждой сессии. Задайте сервер выполнения, модель и необязательный прокси для исходящего трафика для каждой сессии. Серверы и прокси поставляются с реальной проверкой соединения, чтобы вы знали, что они работают, прежде чем полагаться на них.
• Триаж находок. Подтверждайте или отклоняйте находки и объединяйте дубликаты, которые агент записал дважды. В отчёт не попадают отклонённые и помечаются подтверждённые.
• Отчёты. Экспорт в PDF, а также JSON и SARIF. Текст генерируется моделью сессии и очищается так, чтобы читался как написанный человеком, с резюме для руководства, методологией, находками и рекомендациями по устранению в порядке приоритета.
• Живая консоль. Лента активности, терминалы и браузер агента передаются по WebSockets; граф агентов, находки, добыча, поверхность атаки, слушатели и история прокси обновляются по короткому опросу. Всё это обновляется вживую по мере работы запуска.
• Уведомления. Всплывающие уведомления в приложении, а также уведомления браузера, когда вкладка в фоне, чтобы вопрос от агента или перехваченный шелл не остались незамеченными.

Архитектура

flowchart LR
  UI["Operator console<br/>React + Vite"] -->|REST + WebSocket| API["FastAPI"]
  API --> PG[(PostgreSQL)]
  API --> RS[(Redis<br/>pub/sub + queue)]
  API --> S3[(MinIO<br/>files & reports)]
  RS --> W["Worker (arq)"]
  W --> ENG["Engine<br/>LangGraph + LiteLLM"]
  ENG -->|docker exec| KALI["Kali container<br/>local or remote over SSH"]
  KALI --> TGT["Targets"]
  W -->|events / chat / shell| RS
  RS -->|stream| API

API не запускает агентов. Он ставит запуск в очередь, воркер выполняет его, а воркер публикует вывод в каналы Redis, которые API передаёт в браузер по WebSockets.

Стек

Python 3.12, FastAPI, async SQLAlchemy + asyncpg, Alembic, arq, LangGraph, LiteLLM, ReportLab, PostgreSQL, Redis, MinIO, asyncssh. Фронтенд: React 18, Vite, TypeScript, Tailwind, TanStack Query, xterm. Инструментарий: uv для Python, bun для фронтенда.

Быстрый старт

Вам понадобятся Docker, uv и bun.

# 1. infrastructure (Postgres, Redis, MinIO)
docker compose -f docker-compose.dev.yml up -d

# 2. Python deps, database, and seed data
uv sync --group live
uv run rc db upgrade
uv run rc seed              # admin user, provider catalog, buckets

# 3. copy the env template
cp .env.example .env

# 4. run the three processes (separate terminals)
cd apps/api    && uv run uvicorn app.main:app --host 127.0.0.1 --port 8080
cd apps/worker && uv run arq worker.settings.WorkerSettings
cd apps/web    && bun install && bun run dev

Или запустите все три сразу с помощью менеджера процессов (они объявлены в Procfile): pipx install honcho, затем honcho start.

Откройте http://localhost:5183 и войдите как admin / admin.