Regrader is not maintained anymore in favor of ia-toki/judgels. See #88 for details.
An ICPC-style programming contest system.
Built on top of:
I needed a judging system for programming contest and spent days and nights on looking for one. Then I found Regrader - one of the best programming contest management systems on the internet. It's an open source project and extremely easy to install!
What I loved about the system is its flexibility and user-friendliness. With just a few clicks you are able to make a fully custom design of your Regrader page, suiting your needs. Moreover the system itself is stable and reliable.
Do what I did - try Regrader, you won't regret it!
- Vasil Sarafov, Bulgaria
Regrader requires these packages. Please install them.
Download a copy of the latest Regrader: https://github.com/fushar/regrader/releases/download/v3.0.0/regrader-v3.0.0.tar.gz
Create an InnoDB database in your MySQL database server.
Then, make a copy of .env from .env.example:
$ cp .env.example .envAnd edit each entry of .env based on your system configuration:
ENCRYPTION_KEY denotes the encryption key that will be used by CodeIgniter. It is advisable that the string consists of 32 random characters.DB_HOSTNAME denotes the hostname of the database server.DB_USERNAME and DB_PASSWORD denotes the user credentials of the database.DB_NAME denotes the database name that will be used by Regrader.CPP_CHECKER_COMPILER_PATH denotes the C++ compiler path that will be used to compile checker source code (e.g., /usr/bin/g++). If you don't wish to use checker at all, leave it empty.Finally, make sure your php.ini file has date.timezone option set.
Open Regrader in your browser, and perform the installation steps as instructed. If at any step the system cannot install at some specified directories, please add write permission on them.
Execute run_grader.sh script on your host:
./run_grader.shOpen Manage->Users. Edit admin user and change the password to something else.
Open Manage->Languages. There will be 4 programming languages set up by default: Pascal, Java, C++, and C. For each language you want to actually use, you have to at least edit its compile command as necessary depending where you install the compiler.
Open Manage->Options and configure additional properties of the system.
After installation, you can log in and add users, contests, problems, etc. The interface should be quite intuitive to use :)
You can set up a solution checker for your problems. This is useful for problems that can have multiple solutions. The template for a checker can be found here: https://github.com/fushar/regrader/blob/develop/examples/checker.cpp.
Regrader currently supports English and Indonesian. To change the language to Indonesian, open application/config/config.php and change the value of $config['language'] into 'indonesian'.
You can show institution logos beside the contestant names in the scoreboard. The scoreboard will look very nice. Just upload X.jpg in Manage->Files as the logo for institution X. Then, tick the option Show Institution Logos in the corresponding contest's setting.
You can use Manage->Files to upload public files, for example, for inserting images in problem statements.
Besides the usual public scoreboard, you can also generate public scoreboard that is separated from the system. This is useful for hiding the contest URL address from the public and in order to minimize traffic and external attack.
Of course, to achieve a semi-live scoreboard, you have to do the above steps periodically, possibly using a script.
Here are common suggestions that should solve most possible errors:
Regrader is licensed under MIT License.
Contributions are welcome! To set up Regrader for development, you need:
After that, fork and clone Regrader. Then, run
./build.shYou are then ready to develop.
To produce a tar.gz that is ready to deploy, run
./publish.sh