Integr8sCode¶

Run Python, Node.js, Ruby, Go and Bash scripts in isolated Kubernetes pods and watch the output stream back live.

Quick start¶

You need Docker with Compose and a reachable Kubernetes cluster. Getting started shows how to set up k3s.

git clone https://github.com/HardMax71/Integr8sCode.git
cd Integr8sCode
./deploy.sh dev

Then open https://localhost:5001 and log in as user / user123.

What it does¶

Every script runs in its own pod: non-root, read-only root filesystem, no capabilities, no service account token, and a NetworkPolicy that blocks all traffic in and out wherever the cluster's network plugin enforces it. CPU, memory and timeout limits are system-wide admin settings, and a language can raise them for its own pods. Status updates and the result reach the browser over Server-Sent Events.

The API and six workers talk through Kafka, one topic per event type. Every event is also stored in MongoDB for 30 days, where admins can browse and replay it.

Documentation¶

Getting Started

Set up k3s, start the stack and run your first script
Architecture

System design, service interactions, and event flows
API Reference

Every REST and SSE endpoint, rendered from the OpenAPI spec
Components

Workers, SSE, the execution saga, the DLQ and MongoDB indexes
Operations

Deployment, tracing, and monitoring
Security

Policies, network isolation, and supply chain
Configuration Reference

Every TOML setting and secret
Frontend

Frontend routing and components
Contributing

Development setup, pre-commit hooks, and PR guidelines