• Dharmick Sai
  • Anirudh Achal
  • Adithya Rajesh


  • Sathvik Hebbar
  • Rakshith M
  • Madhav Kumar
  • Kavya Bhat
  • Dhruvil Lakhtaria


  • Create a functional programming judge system which compiles and executes code. The judge should be able to test all the submissions with all predefined test cases.
  • Create isolated environments using Docker Containers in which submitted code should be run with time and memory restrictions while addressing all security concerns.


Programming judge is a robust code execution system in which users can submit and test programming questions. The judge wil evaluate the submissions on predefined test cases and display the results with the help of isolated environments. Although there are many other judges online, in this project our end goal was to create a website that contained all the problems asked in on-campus interviews in NITK and allowed users to practice solving them.


Design and Tech Stack

The codebase is split into Frontend, Backend and Evaluator. Frontend component is written in ReactJS. For the backend we have used Go along with its Gin framework and Postgres as the database. The Evaluator component is written in Go and makes use of Docker.

The dataflow of the system is as follows: client requests such as submitting code, viewing problem and getting verdict are sent to the backend. From there the necessary data is fetched from the database and then sent back to the client. When a file is uploaded for code submission it is stored in the storage file system and then a request is sent to the evaluator to compile and execute the code. Once completed the verdict is sent back and stored in the database.


Problem Set

The application provides functionalities to create new problems, view them and submit solutions, and also modify and delete them. Each problem in the set clearly states the input and output parameters, time and memory limits.


Getting Verdict

To make sure that the submitted code cannot perform any malicious activities on the system, it has to be executed in a sandboxed environment. To implement this, we will be using Docker Containers which will have an initial memory limit, with preset network permissions and time limit for the container. They also provide protection against security concerns such as fork, bomb etc.

The submitted solutions are then compiled and run inside the docker containers against multiple test case files mounted from the storage file system. We have made standard imagefiles to support popular languages such as C, C++, Python, Java. We also check for error codes such as time limit exceeded, memory limit exceeded, wrong answer with respect to the expected output, compilation error, and also runtime errors.



There is a lot of scope to extend our application. Making it scalable such that it can be used by millions of users at the same time would be an interesting challenge. Some improvements that can be made is including an editor for writing code instead of only allowing to upload files. Another major feature to improve scalability would be to introduce a message queue between the backend and evaluator that will store the submissions. This will ensure that requests don’t fail when there is high load on the website.


  1. Cp Judge (explained by Gaurav Sen)
  2. IEEE Research paper on a code execution engine
  3. Golang tutorial
  4. Docker tutorial
  5. Gin