loading...

Add physics
to VLA models
using CAD files

Generate
datasets to train
artificial general engineer.
Ships as a single self-contained Docker image.

↓ Download juakali.tar Installation Guide
juakali:latest ubuntu:24.04 base ~480MB · total downloads
terminal
$ docker load -i juakali.tar
Loaded image: juakali:latest
$ bash install.sh --port 9000
Loading image...
✓ Juakali is ready
→ http://localhost:9000
$ docker exec juakali supervisorctl status
juakali RUNNING pid 28, uptime 0:00:12
nginx RUNNING pid 29, uptime 0:00:12
redis RUNNING pid 27, uptime 0:00:12
1port exposed
3services inside
10k+concurrent WS clients
0host dependencies
total
downloads
Prerequisites

System Requirements

Only Docker is required. Everything else is pre-baked into the image.

PlatformRequirementMin VersionNotes
LinuxDocker Engine24.0+Ubuntu, Debian, Fedora, RHEL, Arch
macOSDocker Desktop4.20+Apple Silicon and Intel both supported
WindowsDocker Desktop + WSL24.20+WSL2 backend required
Download

Get Juakali

Download the image archive and install script. All platforms use the same image.

🐧

Linux

Ubuntu · Debian · Fedora · Arch

juakali.tar + install.sh
↓ juakali.tar ↓ install.sh
🍎

macOS

Intel · Apple Silicon (M1/M2/M3)

juakali.tar + install.sh
↓ juakali.tar ↓ install.sh
🪟

Windows

Windows 10 · Windows 11 (WSL2)

juakali.tar + install.sh
↓ juakali.tar ↓ install.sh

All releases on github.com/qet-lab/juakali/releases ↗  ·  Download counts pulled live from the GitHub API.

Installation

Platform Setup

Install Docker for your platform, then load and run the image.

1

Install Docker Engine

Ubuntu / Debian

# One-liner install
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER && newgrp docker

Fedora / RHEL

sudo dnf install docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
2

Verify Docker

docker --version
# Docker version 24.x.x or higher
3

Load and Run Juakali

# Load the image (one-time)
docker load -i juakali.tar

# Run with install script
bash install.sh --port 9000

# Or manually
docker run -d \
  --name juakali \
  --restart unless-stopped \
  -p 9000:9000 \
  juakali:latest
4

Open in browser

xdg-open http://localhost:9000
1

Install Docker Desktop

brew install --cask docker
# Or download .dmg: docs.docker.com/desktop/install/mac-install/
2

Allocate Resources

Docker Desktop → Settings → Resources → Advanced

# Recommended minimums
CPUs   : 4+
Memory : 8 GB
Disk   : 20 GB
3

Load and Run Juakali

docker load -i juakali.tar
bash install.sh --port 9000
4

Open in browser

open http://localhost:9000
1

Enable WSL2 — PowerShell as Administrator

wsl --install
wsl --set-default-version 2
# Restart when prompted
2

Install Docker Desktop

# docs.docker.com/desktop/install/windows-install/
# Run installer → enable "Use WSL2 based engine"
# Restart → launch Docker Desktop
# Wait for whale icon in taskbar to stop animating
3

Verify Docker — PowerShell

docker --version
docker run hello-world
4

Load and Run — PowerShell

docker load -i juakali.tar

docker run -d `
  --name juakali `
  --restart unless-stopped `
  -p 8080:9000 `
  juakali:latest
Note: Use backtick ` for line continuation in PowerShell, not \. To use install.sh, run it inside a WSL2 terminal instead.
5

Open in browser

Start-Process "http://localhost:9000"
Operations

Docker Management

Container and service-level control commands.

Container

docker start juakali
docker stop juakali
docker restart juakali
docker stats juakali
docker logs -f juakali
docker exec -it juakali bash

Services (inside container)

docker exec juakali supervisorctl status
docker exec juakali supervisorctl restart juakali
docker exec juakali supervisorctl restart nginx
docker exec juakali supervisorctl restart redis

Logs

docker exec juakali tail -f /var/log/juakali/engine.log
docker exec juakali tail -f /var/log/juakali/engine-err.log
docker exec juakali tail -f /var/log/juakali/nginx-access.log

Cleanup

docker stop juakali && docker rm juakali
docker rmi juakali:latest
docker system prune -a