{"id":13822186,"url":"https://github.com/Algorithmic-Battle/algobattle","last_synced_at":"2025-05-16T15:33:18.464Z","repository":{"id":40697633,"uuid":"322627524","full_name":"Benezivas/algobattle","owner":"Benezivas","description":"Let teams compete by making them create hard instances and fast solvers for problems of your choice. Then pitch these instances and solvers against one another. All language-agnostic.","archived":false,"fork":false,"pushed_at":"2024-01-09T21:55:34.000Z","size":2089,"stargazers_count":8,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-07-19T16:57:53.979Z","etag":null,"topics":["coding-contest","computer-science-education","docker","education","lab","teaching"],"latest_commit_sha":null,"homepage":"https://algobattle.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Benezivas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-12-18T15:07:28.000Z","updated_at":"2023-10-10T15:14:40.000Z","dependencies_parsed_at":"2023-10-01T18:58:21.555Z","dependency_job_id":"6d9af64a-9ec7-4eb5-9279-f71bec92735f","html_url":"https://github.com/Benezivas/algobattle","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benezivas%2Falgobattle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benezivas%2Falgobattle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benezivas%2Falgobattle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benezivas%2Falgobattle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Benezivas","download_url":"https://codeload.github.com/Benezivas/algobattle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213893315,"owners_count":15653524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coding-contest","computer-science-education","docker","education","lab","teaching"],"created_at":"2024-08-04T08:01:47.557Z","updated_at":"2024-11-19T22:32:33.782Z","avatar_url":"https://github.com/Benezivas.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Algorithmic Battle\n\nThe lab course \"Algorithmic Battle\" is offered by the \n[Computer Science Theory group of RWTH Aachen University](https://tcs.rwth-aachen.de/)\nsince 2019. This repository contains the necessary code and\ndocumentation to set up the lab course yourself.\n\nIn an Algorithmic Battle, pairs of teams compete against one another\nin order to solve a problem of your choice, e.g. a problem from the\nclass NP. The teams each design a `generator`, that outputs\nhard-to-solve instances for a given instance size, as well as a\n`solver` that accepts an instance and outputs a solution to it as\nquickly as possible.\n\nThe framework is written to be completely language-agnostic regarding\nthe code of the `generator` and the `solver`, as each is wrapped in a\ndocker container that only needs to adhere to an I/O structure of your\nchoice (by default, in the form of `json`-files.)\n\nIf you are interested in how to use the framework for a\nlab course of your own, please consult the teaching concept in\nthe [documentation](https://www.algobattle.org/docs/).\n# Installation and Usage\nThis project is developed and tested on all major operating systems.\n\nPlease consult the official [documentation](https://www.algobattle.org/docs/)\nfor detailed instructions on installation and usage.\n\n# Related projects\nThis repository only includes the core framework for executing an\n`Algorithmic Battle`. For a selection of concrete problems that you\ncan use to play around with the framework, have a look at the\n[algobattle-problems](https://github.com/Benezivas/algobattle-problems)\nrepository. These are problems that have been posed to students in\nsome form over the past years.\n\nWhile the framework provides all essential tools to host a tournament\nyourself, e.g. in the form of a lab course, you may be interested in\nthe [algobattle-web](https://github.com/Benezivas/algobattle-problems)\nproject.  The `algobattle-web` project implements a webframework with\nwhich you are able to comfortably manage your students teams and their\ncode, your problem files and their documentation as well as schedule\nmatches to be fought between registered student teams, using the\n`algobattle` API.\n\n# Contributing\n\nWe welcome any input on how to make this project accessible to as many\npeople as possible. If you have feedback regarding the usage of the\nframework, the documentation or would even like to help us out with\ncorrections, new features, or translations, feel free to open an issue\nor pull request. We have developed this project on the basis of\npractical experience inside our lab courses, thus some design elements\nmay be unintuitive to you. Feel free to point out anything that\nappears odd to you.\n\n# Funding\nThe development of version `4.0.0` was funded by\n[`Stiftung Innovation in der Hochschullehre`](https://stiftung-hochschullehre.de/en/) (Project \n`FRFMM-106/2022 Algobattle`) and by the [Department of Computer Science of\nRWTH Aachen University](https://www.informatik.rwth-aachen.de/go/id/mxz/?lidx=1).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlgorithmic-Battle%2Falgobattle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlgorithmic-Battle%2Falgobattle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlgorithmic-Battle%2Falgobattle/lists"}