README.md

HackerAI

Your AI-Powered Penetration Testing Assistant

Getting started

Prerequisites

You'll need the following accounts:

Required:

• OpenRouter - AI model provider
• OpenAI - Content moderation
• 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