Code FREAK (Code Feedback, Review & Evaluation Kit) is an online programming platform and evaluation/autograding system for coding assignments. It supports every major programming language (language agnostic) and has a modular evaluation system based on Docker.
- Support for every major programming language (language agnostic)
- Pluggable evaluation system based on Docker (Dynamic Testing, Linting, …)
- In-browser IDE based on VSCode/Coder
- Modern UI based on React and Ant Design
- Integrates with learn management systems (LMS) via LTI 1.3 standard
- LDAP authentication
- 100% free and open source
We currently only support installation via Docker.
The image name is ghcr.io/codefreak/codefreak
.
Check out its tags for the latest version.
You can try out Code FREAK locally. The only requirement is a working installation of Docker on your computer.
The following command will start the latest development version of Code FREAK based on the master
branch.
docker run -it --rm \
-e SPRING_PROFILES_ACTIVE=dev \
-v /var/run/docker.sock:/var/run/docker.sock \
-p 8080:8080 \
ghcr.io/codefreak/codefreak:canary
The UI is accessible at http://localhost:8080.
Log in using teacher
and password 123
.
Additionally, the users admin
and student
are available with their corresponding roles and the same password 123
.
Using the "dev" environment will seed the database with some example assignments and tasks.
This will use you local Docker daemon for evaluation and IDE instances.
There are two major image versions on Docker Hub: latest
and canary
. latest
always points to the latest stable release and canary
is basically a snapshot release based on the master
branch from GitHub.
Our image tags follow semantic versioning. For example the tag ghcr.io/codefreak/codefreak:4
will always reference the latest v4 release.
Our Docker image should run without any further configuration. Out of the box it will use an in-memory database and the Docker daemon available via /var/run/docker.sock
or the DOCKER_HOST
environment variable. This is of course NOT suitable for production deployments. Please see our installation/deployment guide for detailed instructions and recommendations.
The latest documentation is always available on docs.codefreak.org. You can find the "raw" documentation files inside the /docs
directory.
The development of Code FREAK started in 2018. It has been used in production from an early stage on at Kiel University of Applied Sciences (Germany). Extensive testing in various computer science courses resulted in valuable feedback. The reception by studends and teachers is very positive.
While this is not a mature product yet, all major features (editing, evaluation, reviewing) do work already. We have many ideas for new features and the existing application still needs some polishing. Development is ongoing in cooperation with current users.
Code FREAK is intended to become a community-driven project. If you are interested in trying it for your educational institution or if you have any questions, feel free to get in touch with us! ✉ [email protected]
There are still A LOT of features that have not been integrated into Code FREAK, yet.
You will find them in our ROADMAP.md
file.
If your desired feature is missing please open an issue on GitHub!
Code FREAK | Code Feedback Review & Evaluation Kit
Copyright (C) 2019 Kiel University of Applied Sciences
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.