LOJ — LeLe Online Judge

简体中文 · 繁體中文

---

Introduction

LOJ (LeLe Online Judge) is a modern online judge platform built with Next.js 16. It supports programming problem solving, contests, training tracks, an AI teaching assistant, and multi-engine code execution evaluation.

Features

• Problem System — Create and manage programming problems with multiple test cases, self-test samples, and BlockNote rich text editing
• Contest System — ACM / OI scoring modes, real-time rankings, independent problem copies
• Training Tracks — Themed problem sets for progressive learning paths
• AI Assistant — Integrated AI chat with problem-context-aware programming guidance
• Multi-Engine Judging — Pluggable evaluation engines: OneCompiler (default), Judge0, Runoob
• Code Editor — Monaco Editor (VS Code engine) with multi-language syntax highlighting
• User System — NextAuth authentication, JWT sessions, role-based access control
• Admin Panel — Full management for users, problems, contests, training, settings, storage
• Storage Backends — Local filesystem / S3-compatible object storage
• Security Hardening — Built-in rate limiting, permission validation, IP spoofing protection, SSRF protection

Getting Started

One-liner:

curl -fsSL https://raw.githubusercontent.com/aiwandiannaodelele/LOJ/main/deploy.sh | bash

Or manually:

git clone https://github.com/aiwandiannaodelele/LOJ.git
cd LOJ
npm install
npm run db:push
npm run db:seed
npm run dev

Open http://localhost:3000 to view it.

Command Reference

Command	Description
npm run dev	Start dev server (localhost:3000)
npm run build	Build for production
npm run start	Start production server (SQLite default)
npm run lint	ESLint code check
npm run db:push	Push database schema
npm run db:seed	Seed sample data
npm run db:generate	Generate Prisma client
npm run pm2:start	Start with PM2 process manager
npm run pm2:logs	View PM2 logs

Tech Stack

Technology	Purpose
Next.js 16	React framework (App Router)
Tailwind CSS v4	Styling
shadcn/ui	UI component library
Prisma 7	ORM / Database
SQLite / D1	Database (dev / production)
NextAuth v5	Authentication (credentials + JWT)
Monaco Editor	Code editor
BlockNote	Rich text editor
OneCompiler / Judge0	Judging engines

Deployment

Self-Hosting

One-liner (auto-detects Docker vs PM2, supports China mirrors)

curl -fsSL https://raw.githubusercontent.com/aiwandiannaodelele/LOJ/main/deploy.sh | bash

Docker (PostgreSQL default)

./deploy.sh

Visit http://localhost:3000/init to set up the admin account.

PM2 (SQLite default)

npm install && npm run build && npm run db:push
npm run pm2:start

Node.js (SQLite default)

npm install && npm run build && npm run db:push
npm start

Cloud Platforms

Platform	Database	Notes
Vercel	Turso / Supabase	git push, set TURSO_DATABASE_URL + TURSO_AUTH_TOKEN
Netlify	Turso / Supabase	git push, native Next.js support + env vars
Cloudflare Pages	D1	Requires @opennextjs/cloudflare + wrangler.toml

Database Options

Option	Provider	Setup
SQLite	sqlite	Local file, zero config
PostgreSQL	postgresql	Set DB_PROVIDER=postgresql + DATABASE_URL
Turso	sqlite	Set TURSO_DATABASE_URL + TURSO_AUTH_TOKEN
Cloudflare D1	sqlite	Requires Cloudflare Pages + D1 binding

License

GNU AGPL v3.0

Links

• Security Policy
• Contributing Guide
• Discussion Guide
• Discussions
• Report Bug
• Request Feature