https://github.com/hardmax71/integr8scode
Integr8sCode lets you run Python scripts online by executing them in isolated K8s pods with resource limits. Just input your code!
https://github.com/hardmax71/integr8scode
fastapi grafana js k8s locust mongodb prometheus pydantic-v2 python svelte svelte3 tailwind
Last synced: 4 months ago
JSON representation
Integr8sCode lets you run Python scripts online by executing them in isolated K8s pods with resource limits. Just input your code!
- Host: GitHub
- URL: https://github.com/hardmax71/integr8scode
- Owner: HardMax71
- License: mit
- Created: 2024-10-10T20:37:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-23T20:57:10.000Z (over 1 year ago)
- Last Synced: 2024-10-24T08:47:15.009Z (over 1 year ago)
- Topics: fastapi, grafana, js, k8s, locust, mongodb, prometheus, pydantic-v2, python, svelte, svelte3, tailwind
- Language: Python
- Homepage:
- Size: 318 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Integr8sCode
Welcome to **Integr8sCode**! This is a platform where you can run Python scripts online with ease. Just paste your
script, and the platform run it in an isolated environment within its own Kubernetes pod, complete with resource limits
to keep
things safe and efficient. You'll get the results back in no time.
> [!NOTE]
> A deployed and working version of Integr8sCode is available at https://app.integr8scode.cc/ .
How to deploy
### Prerequisites
- Docker and Docker Compose
- Kubernetes cluster (k3s, Docker Desktop K8s, or minikube) with `kubectl` configured
### Quick start
```bash
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
```bash
curl -k https://localhost/api/v1/health/live
```
### Access
| Service | URL |
|--------------------|--------------------------------------------------------|
| Frontend | [https://localhost:5001](https://localhost:5001) |
| Backend API | [https://localhost:443](https://localhost:443) |
| Kafdrop (Kafka UI) | [http://localhost:9000](http://localhost:9000) |
| Grafana | [http://localhost:3000](http://localhost:3000) |
| Jaeger (Tracing) | [http://localhost:16686](http://localhost:16686) |
Default credentials: `user` / `user123` (regular), `admin` / `admin123` (admin).
Self-signed TLS certs are generated automatically — accept the browser warning.
### Run tests
```bash
./deploy.sh test
```
### Stop
```bash
./deploy.sh down
```
See the [full deployment guide](https://hardmax71.github.io/Integr8sCode/operations/deployment/) for Docker build strategy, troubleshooting, pre-built images, and more.
Sample test
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`.
## Architecture Overview
> [!TIP]
> Full documentation is available at https://hardmax71.github.io/Integr8sCode/
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.