Integr8sCode

GitHub Live Demo

Quick start

Deployment

# 1. Clone the repo
git clone https://github.com/HardMax71/Integr8sCode.git
cd Integr8sCode

# 2. Start containers
docker-compose up --build

Access points:

Service	URL
Frontend	https://127.0.0.1:5001/
Backend API	https://127.0.0.1:443/
Grafana	http://127.0.0.1:3000 (admin/admin123)

Verify installation

Check if the backend is running:

curl -k https://127.0.0.1/api/v1/k8s-limits

Example response:

{
  "cpu_limit": "1000m",
  "memory_limit": "128Mi",
  "timeout_seconds": 5
}

Enable Kubernetes metrics

If CPU and Memory metrics show as null, enable the metrics server:

kubectl create -f https://raw.githubusercontent.com/pythianarora/total-practice/master/sample-kubernetes-code/metrics-server.yaml

Verify with:

kubectl top node

Example output:

NAME             CPU(cores)   CPU%   MEMORY(bytes)   MEMORY%
docker-desktop   267m         3%     4732Mi          29%

Core features

• Every script runs in its own Kubernetes pod, fully isolated from others
• Resource limits keep things in check: 1000m CPU, 128Mi memory, configurable timeouts
• Multiple Python versions supported (3.9, 3.10, 3.11, 3.12)
• Real-time updates via Server-Sent Events so you see what's happening as it happens
• Full audit trail through Kafka event streams
• Failed events get retried automatically via dead letter queue

Architecture

The platform has three main parts:

• A Svelte frontend that users interact with
• FastAPI backend handling the heavy lifting, backed by MongoDB, Kafka, and Redis
• Kubernetes cluster where each script runs in its own pod with Cilium network policies

flowchart TB
    User:::userStyle --> Frontend
    Frontend --> API
    API --> Coordinator
    Coordinator --> Saga
    Saga --> K8sWorker[K8s Worker]
    K8sWorker --> Pod
    K8sWorker --> ResultProcessor[Result Processor]
    PodMonitor[Pod Monitor] --> ResultProcessor
    ResultProcessor --> SSE
    SSE --> User
    classDef userStyle fill:#e0e0e0,stroke:#333,stroke-width:2px

For detailed architecture diagrams, see the Architecture section.

Security

• Pods can't make external network calls (Cilium deny-all policy)
• Everything runs as non-root with dropped capabilities
• Read-only root filesystem on containers
• No service account access to Kubernetes API

Documentation

• Architecture

  ---

  System design, service interactions, and event flows

• API Reference

  ---

  Complete REST and SSE endpoint documentation

• Components

  ---

  SSE, Workers, DLQ, and Schema management

• Operations

  ---

  Tracing, metrics, monitoring, and troubleshooting

Sample test

Verify your installation by running this Python 3.10+ code:

from typing import TypeGuard

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

def example_function(data: object):
    match data:
        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])

Expected output:

An integer greater than 10
A string: hello
Something else