Code Racer

A Remote Code Execution Engine built with Go and ❤️

VERSION=0.0.3
APP_NAME=thefl45h/code-racer

This project includes a (devcontainer)[https://code.visualstudio.com/docs/devcontainers/containers].

In the dev container, you can use the air command to start up the server with hot reloading.

Running in production

Create an .env.production with the above environment variables. Refer to .env.sample

Use the root docker-compose.yml file to create a production ready docker image

Building docker image

docker-compose build

Starting container

docker-compose up

What is nosocket?

nosocket is a custom binary that uses libseccomp to block socket calls. This is a security measure to prevent tasks submitted from accessing the internet.

API Documentation

Swagger Docs

/api/v1/swagger

Public API

POST https://code-racer-api.codewithflash.com/api/v1/execute
GET https://code-racer-api.codewithflash.com/api/v1/runtimes

Runtimes endpoint

GET /api/v1/runtimes: Endpoint to list available runtimes

Response

[
    {
        "language": "python3"
    },
    {
        "language": "node"
    }
]

Execute endpoint

POST /api/v1/execute. Endpoint to execute code

• language(required): language to use for execution. Refer to /api/v1/runtimes for available languages

• entrypoint(required): the file path to start execution from. This path must be present in files

• files(required): An array of files containing code to be used for execution.

• file.name(required): filename

• file.content(required): content of file

{
    "language": "node",
    "entrypoint": "main.js",
    "files": [
        {
            "name": "main.js",
            "content": "console.log('Code Racer')"
        }
    ]
}

{
    "stderr": "",
    "stdout": "Code Racer\n",
    "executionTime": "438.757875ms",
    "preparationTime": "102.106667ms"
}

Supported Languages

python, node, go, php, java, ruby

More to come