Prerequisites

• Docker and Docker Compose
• Kubernetes cluster (k3s, Docker Desktop K8s, or minikube) with kubectl configured

Quick start

git clone https://github.com/HardMax71/Integr8sCode.git
cd Integr8sCode
cp backend/secrets.example.toml backend/secrets.toml
./deploy.sh dev

The secrets.toml file holds credentials and is gitignored. The example template has working development defaults.

Verify

curl -k https://localhost/api/v1/health/live

Access

Default credentials: user / user123 (regular), admin / admin123 (admin).

Self-signed TLS certs are generated automatically — accept the browser warning.

Run tests

./deploy.sh test

Stop

./deploy.sh down

See the full deployment guide for Docker build strategy, troubleshooting, pre-built images, and more.

You can check correctness of start by running a sample test script:

1. Open website at https://127.0.0.1:5001/, go to Editor
2. In code window, paste following code: ```python from typing import TypeGuard

def is_string(value: object) -> TypeGuard[str]: return isinstance(value, str)

def example_function(data: object): match data: # Match statement introduced in Python 3.10 case int() if data > 10: print("An integer greater than 10") case str() if is_string(data): print(f"A string: {data}") case _: print("Something else")

example_function(15) example_function("hello") example_function([1, 2, 3])

First, select `>= Python 3.10` and run script, will output:

Status: completed Execution ID: Output: An integer greater than 10 A string: hello Something else

Then, select `< Python 3.10` and do the same:

Status: completed Execution ID: Output: File "/scripts/script.py", line 7 match data: # Match statement introduced in Python 3.10 ^ SyntaxError: invalid syntax

This shows that pods with specified python versions are creating and working as expected. Btw, the latter throws error
cause `match-case` was introduced first in `Python 3.10`.

</details>


## Architecture Overview

> [!TIP]
> Full documentation is available at https://hardmax71.github.io/Integr8sCode/

<img src="./docs/assets/images/system_diagram.svg" alt="system diagram">

The platform is built on three main pillars:

- Frontend: Svelte app that users interact with.
- Backend: Powered by FastAPI, Python, and MongoDB to handle all the heavy lifting.
- Kubernetes Cluster: Each script runs in its own pod, ensuring isolation and resource control.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.