JudgeLib

JudgeLib Documentation

Simple guides to get JudgeLib running in your application.

How JudgeLib Works

JudgeLib processes code submissions through a simple pipeline: your code gets split into test cases, queued in Redis, and executed by workers.

1. NPM Library
Required

Install this library in your app to submit code for evaluation.

  • Splits test cases into batches
  • Sends to Redis queue
  • Gets results back
2a. Free Microservice
Cloud Hosted

Use our free hosted service on Render.

  • 3 worker instances
  • Slow cold starts
  • Good for testing
2b. Self-Host
Recommended

Deploy on your infrastructure with Docker & Kubernetes.

  • Docker isolation
  • Auto-scaling with KEDA
  • Production ready

Quick Comparison

FeatureFree MicroserviceSelf-Host
SecurityBasicDocker Isolated
PerformanceSlow startsFast
Auto-scalingFixed✓ KEDA
Best ForTestingProduction

For Production Apps

Self-hosting gives you better security, performance, and auto-scaling. Perfect for production workloads.

Get Started in 2 Steps

2Choose Your Backend

Free Microservice

Use our hosted service

Self-Host

Deploy yourself - Recommended