pentest-harness - Pentest Harness — Heaven for Hackers. A self-hoste

项目说明

<di="center">

<img src="docs/images/pentest-harness-banner-1200.png" alt="Pentest Harness — Heaven for Hackers" width="100%" />

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.

</div>

---

Screenshots

| Workspace | Provider cards |
|:---:|:---:|
| <img src="docs/images/screenshot-hero.png" alt="Pentest Harness workspace" width="420" /> | <img src="docs/images/screenshot-models.png" alt="Pentest Harness provider cards" width="420" /> |

---

Features

---

Demo

<img src="docs/media/pentest-harness-demo.gif" alt="Pentest Harness demo" width="100%" />

Download the full video

---

Quick start

The Web UI opens at 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

---

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 | |
| Settings file | $DSH_HOME/settings.yaml (default ~/.dsh/settings.yaml) |
| Credentials | $DSH_HOME/.credentials.yaml (owner-only permissions) |

---

License

MIT

---

<di="center">

⚡ Sponsored by HackWithClaude

<br/>

<p>
<a href=" target="_blank" rel="noopener noreferrer">
<img src="
alt="HackWithClaude — Elevate Your AI Game" />
</a>
</p>

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

</div>

项目信息

开发语言：TypeScript

Star 数：407

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Pentest Harness — Heaven for Hackers. A self-hosted AI agent harness for authorized pentests, bug bounty, security labs, and CTFs. Bring your own AI model API; sessions stay local.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。