Skip to content

Latest commit

Β 

History

History
118 lines (90 loc) Β· 3.32 KB

File metadata and controls

118 lines (90 loc) Β· 3.32 KB

Unified Red Team Operations Platform

A sophisticated web-based toolkit for security researchers and AI developers to systematically test the safety filters and operational boundaries of Large Language Models (LLMs).

πŸ“š Documentation

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ and npm
  • Firebase account and project
  • Google Cloud account (for Vertex AI)

Setup

  1. Clone and install dependencies:
git clone https://github.com/lucron9090/studio.git
cd studio
npm install
  1. Configure environment variables:
cp .env.example .env.local

Edit .env.local with your Firebase and Google Cloud credentials.

  1. Authenticate with Google Cloud (for Vertex AI):
gcloud auth application-default login
  1. Run development server:
npm run dev

The app will be available at http://localhost:9002

Build for Production

npm run build   # Creates optimized production build
npm start       # Serves production build

🎯 Current Status

Version: 0.1.0 (Alpha)
Production Ready: ~65%
Build Status: βœ… Stable
Last Updated: October 14, 2025

βœ… What's Working

  • User authentication (Firebase)
  • Operation creation wizard with AI assistance
  • Live attack execution interface
  • 13 AI flows powered by Vertex AI (Gemini)
  • πŸ†• Real LLM integration (OpenAI, Anthropic, xAI)
  • πŸ†• Advanced attack modules (SPECTRE, TOXIN, ECHO, full MAKER)
  • Real-time operation management
  • 40+ UI components
  • Production build system (Next.js 14.2.33)
  • Type-safe TypeScript codebase

⚠️ What's Missing

  • UI integration for advanced attack modules
  • PDF report generation
  • Production monitoring and logging

See PROJECT_STATUS.md for complete details.

πŸ—οΈ Technology Stack

  • Frontend: Next.js 14.2.33 + TypeScript + React 18
  • UI: Tailwind CSS + Shadcn/ui + Radix UI
  • Backend: Firebase/Firestore 11.9.1
  • AI: Genkit 1.19.3 + Google Vertex AI (Gemini 2.0 Flash Exp)
  • LLM Providers: OpenAI (GPT-4), Anthropic (Claude), xAI (Grok)
  • Authentication: Firebase Auth
  • Build: Next.js compiler with static + dynamic rendering

πŸ“ Project Structure

studio/
β”œβ”€β”€ src/ai/           β†’ AI flows and prompts (13 flows)
β”œβ”€β”€ src/app/          β†’ Next.js pages and routes
β”œβ”€β”€ src/components/   β†’ UI components (40+)
β”œβ”€β”€ src/services/     β†’ Business logic
└── docs/             β†’ Design documentation

🀝 Contributing

See CONTRIBUTING.md for:

  • Development environment setup
  • Code style guidelines
  • Git workflow and commit conventions
  • Testing guidelines

See GITHUB_PROJECT_SETUP.md for:

  • Detailed epic/feature breakdown
  • Issue templates and labels
  • Milestone roadmap
  • Project board setup

πŸ“„ License

Not specified