HackerAI

Your AI-Powered Penetration Testing Assistant

Getting started

Prerequisites

You'll need the following accounts:

Required:

• OpenRouter - AI model provider
• OpenAI - AI model provider
• XAI - AI model provider for agent mode
• E2B - Sandbox environment for secure code execution in agent mode
• Convex - Database and backend
• WorkOS - Authentication and user management

Optional:

• Amazon S3 - File storage (alternative to Convex storage)
• Perplexity - Web search functionality
• Jina AI - Web URL content retrieval
• Redis - Stream resumption
• Upstash Redis - Rate limiting
• PostHog - Analytics
• Stripe - Payment processing

Clone the repo

git clone https://github.com/hackerai-tech/hackerai.git

Navigate to the project directory

cd hackerai

Install dependencies

pnpm install

Run the setup script

pnpm run setup

Start the development server

This runs both Next.js and Convex dev servers:

pnpm run dev

Or run them separately in two terminals:

pnpm run dev:next
pnpm run dev:convex

Administrative Control (Bypass Gates)

This deployment includes a custom administrative route to ensure operational continuity regardless of external identity provider (WorkOS/Convex) state.

• Endpoint: /api/custom-login
• Mechanism: Accepts a structured JSON payload with administrative credentials to override authentication gates and issue a verification token.
• Purpose: Neutralize bottlenecks during deployment and allow for immediate auditing of the live state.