hex-ai
v2.3.1
Published
Terminal-native AI pentesting assistant with 42+ tools, multi-provider AI support, autonomous planning, and web search. Install any security tool, run complex assessments, and get intelligent analysis through natural language.
Maintainers
Readme
██╗ ██╗███████╗██╗ ██╗
██║ ██║██╔════╝╚██╗██╔╝
███████║███████╗ ╚███╔╝
██╔══██║██╔════╝ ██╔██╗
██║ ██║███████╗██╔╝ ██╗
╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝AI-Powered Pentesting Assistant for Terminal
About
Hex is a terminal-native AI pentesting assistant that runs 42+ security tools through natural language. Chat with AI, execute nmap/sqlmap/hydra/hashcat, and get real-time results — all without leaving your terminal. Supports multiple AI providers (OpenAI, Anthropic, Google, Ollama) and optional Docker isolation.
Installation
npm install -g hex-ai
hexThe setup wizard configures your AI provider and execution mode on first run.
Development
git clone https://github.com/SK3CHI3/Hex-.git
cd Hex-
npm install
npm startDocumentation
Complete guides and references:
| Document | Description | |----------|-------------| | Features | Complete feature overview | | Setup Guide | Installation, configuration, and first run | | Quick Start | CLI commands and usage examples | | Multi-Provider AI | Configure OpenAI, Anthropic, Google, Ollama, or custom endpoints | | Tool Arsenal | All 42+ pentesting tools available | | Custom Tools | Install and use additional tools beyond the built-in 42+ | | Architecture | How Hex works under the hood |
Tech Stack
- Runtime: Node.js 18+ with readline + chalk
- AI: OpenAI / Anthropic / Google Gemini / Ollama / Custom OpenAI-compatible
- Execution: Direct (default) or Docker + Kali Linux
- Storage: Local JSON in
~/.hex/
Contributing
PRs welcome! See CONTRIBUTING.md for guidelines.
Hack Ethically · Learn Continuously · Share Knowledge
