Glimpse is a microservice that allows for remote code execution, written in Python.

Current list of supported languages:

• Java
• C++
• Python
• C
• JavaScript
• GoLang

Glimpse is not yet deployed, but will be soon. In the meantime, you can spin it up yourself locally.

1. Run the following setup script: chmod +x setup.sh && ./setup.sh. This will install all necessary Python dependencies and build the Docker image.
2. To run the FastAPI app, use the following command: python3 -m uvicorn api:app --host 0.0.0.0 --port 8000 --workers <int:num_workers>.
   • num_workers will decide the number of web workers that are running the API in parallel. When developing locally, no more than 2 are needed.
3. Send a request to the endpoint like so:

fetch('<endpoint_url>/run-code-pool', {
    method: 'POST',
    headers: {
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "language": "py", // also accepts "java", "js", "cpp", "c", "go"
        "code": "print(\"Hello, world!\")",
        "input": ""  // optional parameter
    })
}).then((resp) => resp.json())
.then((data) => console.log(data));

Or use our friendly neighborhood cURL CLI tool:

curl -X POST '<endpoint_url>/run-code-pool' \
    -H 'Content-Type: application/json' \
    -d '{"language": "py", "code": "print(\"Hello, world!\")", "input": ""}'

The output from the endpoint will be as follows:

{
    "output": "Hello, world!\n",
    "error": "",
    "language": "py",
    "info": "python3 --version"
}

Glimpse allows code to be executed via a web request. You can run code and display code results in environment like Node, in a React application, etc. It works by sending instructions to a Docker container about how to compile and/or execute code coming in, carrying out those instructions, and saving the result before replacing the code-contaminated container.

/run-code-pool

Runs untrusted code using a Docker Container pool and returns the output.

{
    "language": str,  // py, js, java, cpp, c, go
    "code": str,  // Stringified code block
    "input": str,  // User input (for print() statements)
}

{
    "output": str, // Stringified output of the code snippet
    "error": str, // Any errors that occured during program compilation or execution
    "language": str, // same as input
    "info": str, // Command to get version information from server
}

Glimpse is not meant to be used to run I/O operations in most languages. If one were to try to run the command input() with Glimpse, it would eventually timeout. All I/O interactions must be spoofed on the client-side, and passed to the endpoint using the input body param.