pentest-harness README

The project's README from github.com/S1N6H/pentest-harness. As one markdown file: README.md.

Pentest Harness — Heaven for Hackers

Pentest Harness

Heaven for Hackers — the professional security testing workspace.

An open-source, dark-first AI agent harness for authorized penetration tests, bug bounty research, security labs, and CTF engagements. Built on a plugin architecture where every layer — model adapters, tools, sessions, settings, and credentials — is replaceable from configuration.

Works with any AI model API. Bring your own key from OpenAI, Anthropic, DeepSeek, Google, Mistral, Groq, OpenRouter, Azure OpenAI, or any OpenAI-compatible gateway — one click auto-discovers your models and you're running.


Screenshots

Workspace Provider cards
Pentest Harness workspace Pentest Harness provider cards

Features


Demo

Pentest Harness demo

Download the full video


Quick start

git clone https://github.com/S1N6H/pentest-harness.git
cd pentest-harness
pnpm install
pnpm build
pnpm dsh web

The Web UI opens at http://127.0.0.1:2323 in your browser.

If pnpm dsh is not on your PATH, use pnpm exec dsh web or node apps/cli/lib/index.js web.

Requirements

Run on another port

pnpm dsh web --port 3000

First run — connect any AI model

  1. Open Settings → Models.
  2. Click Add a custom provider (or Edit an existing one).
  3. Paste your API base URL — the provider ID and display name auto-fill.
  4. Enter your API key (stored in your local credential store, never in settings).
  5. Models auto-discover from the endpoint — click one to add it, or add by hand.
  6. Pick a model in the composer and start your engagement.

Defaults

Setting Value
Web UI http://127.0.0.1:2323
Settings file $DSH_HOME/settings.yaml (default ~/.dsh/settings.yaml)
Credentials $DSH_HOME/.credentials.yaml (owner-only permissions)

License

MIT


⚡ Sponsored by HackWithClaude


HackWithClaude — Elevate Your AI Game

Unlimited AI models · One platform · Zero limits

Access every major model — Claude, GPT, Gemini, and more — in one place. Built for builders who ship.

🚀 Visit HackWithClaude.com · 💡 Explore the models

pentest-harness (S1N6H/pentest-harness)

Searching Database…

Что это?Самостоятельно размещаемый (self-hosted) каркас ИИ-агента для авторизованных пентестов, исследований в багбаунти, лабораторий безопасности и CTF, где вы приносите свой API-ключ ИИ-модели.
Это CLI-инструмент или веб-приложение?Это локальное веб-приложение: вы запускаете его из терминала CLI-командой, а затем всю работу делаете в браузерном Web UI.
Как его запустить?Установите Node.js 20+ и pnpm, затем выполните 'pnpm dsh web' (или 'pnpm exec dsh web' / 'node apps/cli/lib/index.js web'), чтобы открыть Web UI в браузере.
Нужен ли для работы свой API-ключ ИИ-модели?Да — вы приносите свой ключ от OpenAI, Anthropic, DeepSeek, Google, Mistral, Groq, OpenRouter, Azure OpenAI или любого OpenAI-совместимого шлюза, а доступные модели автоматически находятся в один клик.
Есть ли подводные камни при установке?Если после установки команды 'dsh' нет в PATH, придётся откатиться к 'pnpm exec dsh web' или запустить входной файл CLI напрямую через Node.
Где в итоге оказываются мои API-ключи и данные сессий?API-ключи лежат в локальном хранилище учётных данных с доступом только для владельца и лишь упоминаются в настройках — никогда не записываются в файлы настроек или логи, — а сессии остаются локально в файлах JSONL/SQLite.
Что такое 'Pentest Mode'?Это встроенный стандарт работы, заложенный в сам каркас, который структурирует поведение агента специально для авторизованных операций наступательной безопасности.
Насколько легко переключать ИИ-провайдеров?Карточки провайдеров позволяют добавить кастомного провайдера, просто вставив его API base URL и ключ, автоматически найти его модели и тестировать или переключать соединения, не трогая файлы конфигурации.
Как сохраняются мои сессии, чтобы потом к ним вернуться?Сессии надёжно сохраняются в файлы JSONL или SQLite с полной поддержкой воспроизведения, так что вы можете продолжить работу ровно с того места, где остановились.
Почему проект описывает «всё как плагин»?Он построен на плагин-фреймворке Cordis, поэтому адаптеры моделей, инструменты, сессии, настройки и учётные данные заменяются через конфигурацию, а не живут в закрытом ядре.
Creator
S1N6H
Size
27.3 MB
Stars
422
Updated
CommitSep 11
Age
1mo
Commits · 90 Days