Skip to content

Latest commit

 

History

History
100 lines (75 loc) · 2.78 KB

README.md

File metadata and controls

100 lines (75 loc) · 2.78 KB

AIAgentJudge

A distributed competitive programming and AI judge system with automated code evaluation, real-time scoreboard, and multi-worker architecture.

📋 Overview

AIAgentJudge is a comprehensive online judge platform designed to automate the evaluation of competitive programming and AI submissions. It a robust REST API backend, and a distributed worker system for parallel code execution and testing.

✨ Features

  • User Authentication: Register and login functionality with secure JWT tokens
  • Problem Management: Create and manage coding problems with multiple test cases
  • Submission Handling: Support for multiple programming languages with automated judging
  • Real-time Scoreboard: Track user rankings and submission scores
  • Distributed Judge System: Multi-worker architecture for parallel code execution
  • REST API:
  • Docker Support: Fully containerized with Docker Compose for easy deployment
  • Contest Support: Built-in contest management with permission controls

🏗️ Project Structure

🛠️ Tech Stack

Backend

  • Django 5.1 - Web framework
  • Django REST Framework - REST API
  • PostgreSQL - Database
  • Redis - Message queue & caching
  • JWT - Authentication

Frontend

  • HTML5 - Markup
  • JavaScript - Interactivity
  • Nginx - Web server

Worker

  • Python - Code execution engine
  • Redis Streams - Job queue
  • Docker - Isolated execution environment
  • bwrap - virtualization of submissions

📦 Prerequisites

  • Docker & Docker Compose
  • Python 3.8+ (for local development)
  • PostgreSQL 13+
  • Redis 7.0+

🚀 Installation & Setup

Using Docker Compose (Recommended)

  1. Clone the repository

    git clone <repository-url>
cd AiAgentJudge

  2. Create environment files

    # Backend configuration
cat > .env.backend << EOF
DEBUG=True
SECRET_KEY=your-secret-key-here
API_KEY=your-api-key-here
DATABASE_URL=postgresql://user:password@postgres:5432/aiagentjudge
REDIS_URL=redis://redis:6379/0
EOF

# Database configuration
cat > .env.database << EOF
POSTGRES_USER=postgres
POSTGRES_PASSWORD=yourpassword
POSTGRES_DB=aiagentjudge
EOF

# Worker configuration
cat > .env.worker1 << EOF
REDIS_HOST=redis
REDIS_PORT=6379
API_KEY=your-api-key-here
EOF

  3. Build and start services

    docker-compose up -d

  4. Access the application

Judge Script Template

See Worker/template/judge.py for the standard judge implementation. For custom judge implementation(for example interactive problems and ... ) just overload the functions in the class provided by BaseJudge and upload the script for the problem