Red Team Portable Infrastructure (RTPI)

Unified platform for red team operations, combining attack-node, MCP-Nexus, and pen_attack-node capabilities.

Quick Start

Prerequisites

• Node.js 20+ (check with node -v, install via nvm)
• Docker & Docker Compose

Setup

# 1. Copy environment file
cp .env.example .env

# 2. Install dependencies
npm install

# 3. Start database and Redis services
docker compose up -d postgres redis

# 4. Run database migrations
npm run db:push

# 5. Create default admin user
npx tsx scripts/create-admin.ts

# 6. Start development servers (two terminals)

# Terminal 1: Backend API
npm run dev

# Terminal 2: Frontend UI
npm run dev:frontend

Port Configuration

Default ports are configured to avoid conflicts with common local services:

• PostgreSQL: 5434 (instead of 5432)
• Redis: 6381 (instead of 6379)

Access

• Frontend UI: http://localhost:5000
• Backend API: http://localhost:3001
• API Documentation: http://localhost:3001/api/v1
• Default credentials: admin / Admin123!@

Security Note: Change the default admin password after first login!

Note: Always access the full application through the frontend URL. The backend API serves JSON responses only.

Available Commands

# Development
npm run dev              # Start backend API server
npm run dev:frontend     # Start frontend UI server

# Testing
npm test                 # Run unit tests
npm run test:e2e         # Run E2E tests

# Building
npm run build            # Build frontend for production

# Database
npm run db:generate      # Generate migrations
npm run db:push          # Apply migrations
npm run db:studio        # Open database studio

# Code Quality
npm run lint             # Run ESLint
npm run format           # Format code with Prettier

Documentation

• Development Guide
• API Documentation
• Deployment Guide

License

MIT License - See LICENSE file for details

Demo Images

Operations Management

Target Management

AI Provider Integration

Dynamic Agent Configuration

Agent Workflow

Agentic Report Production

Dynamic Tool Management

Tool Workflows

Logic Monitoring