How to Build Your Own Programming Arena — Exploring the omegaUp Codebase

Imagine you need to organize a programming olympiad for several thousand participants. It's not enough to just come up with problems — you need somewhere to receive solutions, verify them in real time, monitor load, and ensure that no one brings down the server with malicious code. Sound familiar?

This is exactly what omegaUp exists for — an open-source platform that grew out of an educational initiative in Latin America and has become a powerful tool for running competitions and teaching algorithms. Today we'll look "under the hood" of this project and find out why it might be interesting not only to computer science teachers, but also to professional developers.

What is omegaUp?

In short, it's a full-featured ecosystem for automatic judging of programming problems (Online Judge). The project solves two main challenges:

1. Automation: Teachers don't need to manually check hundreds of code listings. The system will compile the code, run it through tests, and assign scores on its own.
2. Security: Running someone else's code is always a risk. omegaUp uses advanced isolation mechanisms to ensure that a participant's code doesn't escape the "sandbox."

The project has been on GitHub for many years, has gathered an impressive community, and supports several programming languages, including olympiad classics: C++, Java, Python.

What's Under the Hood: Architectural Details

The project is divided into several key components. It's not a terrifying monolith, but a modular system.

1. Frontend and API (main repository)

The main repository contains the logic for managing users, problems, and contests.

• Back-end: Written in PHP. Developers use the DAO (Data Access Objects) and VO (Value Objects) patterns, which makes working with the database predictable and structured. All controllers live in the frontend/server/src/Controllers folder.
• Internationalization: The project supports Spanish, English, and Portuguese. If you've been wanting to figure out how to properly organize i18n in a large project, take a look at frontend/templates.

2. The Heart of the System — Grader (Quark project)

The most interesting stuff happens in a separate service called Quark. This is where the queue of submitted solutions is managed. It's responsible for ensuring that every problem is judged on time and that results are delivered to the user.

3. Security — omegajail

How do you run a "black box" with code so that it doesn't delete the database? omegaUp uses omegajail. This is a mechanism based on Linux containers and seccomp-bpf. Fun fact: it's built on work from the Chromium project (Google). The system strictly limits system calls, memory, and execution time.

Why Should Developers Pay Attention to This Project?

Even if you don't plan to launch your own LeetCode clone, there's plenty to learn from the omegaUp codebase:

• Working with interactive problems: Thanks to the libinteractive library, the platform allows creating problems where user code must interact with the jury program in real time. This is much more complex than simply comparing text files on output.
• Test organization: The project actively uses yarn test. You can see how to cover a complex system with lots of dependencies with tests.
• Scalability: The system is designed to handle peak loads during major contests.

How to Run the Project Locally?

Developers have prepared an excellent deployment guide. For a quick start, you'll need the standard set of tools: git, yarn, and a bit of patience for building submodules.

# Клонируем со всеми внутренними зависимостями
git clone --recurse-submodules https://github.com/omegaup/omegaup
cd omegaup

# Если забыли про субмодули при клонировании:
git submodule update --init --recursive

# Установка зависимостей
yarn install
yarn test

Practical Value: Where to Use This?

1. Within your company: For running internal hackathons or assessing candidate skills. Your own platform gives you full control over data and problems.
2. Education: If you teach courses or work at a university, omegaUp is a turnkey solution that will free you from routine work.
3. Open Source contribution: There are over 800 open issues in the repository. The project is open to contributors, and it's a great chance to work on a truly in-demand product used by tens of thousands of people.

omegaUp is not just "another site with problems." It's a mature engineering project that demonstrates how to build secure and high-load systems for code execution. If you're interested in compilers, Linux process isolation, or just want to see a quality implementation of PHP architecture — this repository definitely deserves a spot in your GitHub stars.

Ready to try your hand at being an olympiad systems architect? Start with the environment setup documentation.