# Heidelberg AI Lab Internal Beta

This is an internal beta. It installs Heidelberg AI Lab only. It does not
install, update, remove, or change your local AI apps or their data.

## Windows

1. Run `Heidelberg-AI-Lab-0.1.0-beta.3-Windows-x64-Setup.exe`.
2. Keep the default installation location and create the desktop icon.
3. Open **Heidelberg AI Lab** from the desktop or Start menu.
4. If AI Lab says Podman is not ready, install Podman Desktop and select
   **Repair Podman** in AI Lab. This asks before creating or starting Podman's
   local machine.

The Windows installer is unsigned. Windows may show a security warning. Ask
your IT team before using it on a managed computer.

## macOS

1. Open `Heidelberg-AI-Lab-0.1.0-beta.3-macOS-arm64.dmg`.
2. Drag **Heidelberg AI Lab** to Applications.
3. Open it from Applications.
4. If AI Lab says Podman is not ready, install Podman Desktop and select
   **Repair Podman** in AI Lab. This asks before creating or starting Podman's
   local machine.

The macOS app is ad-hoc signed and not notarized. macOS may require an explicit
approval to open it. Ask your IT team before using it on a managed computer.

## Linux

1. Install Node.js 20 or newer and Podman with your distribution's package manager.
2. Download `Heidelberg-AI-Lab-0.1.0-beta.3-Linux-any.tgz`.
3. Run `npm install --global ./Heidelberg-AI-Lab-0.1.0-beta.3-Linux-any.tgz`.
4. Start AI Lab with `ai-lab`.

The Linux package is architecture-independent JavaScript, not a native desktop
installer. Node.js and Podman remain separate system requirements.

## Updates

AI Lab checks the release manifest on startup and every 24 hours while it stays
open. It never downloads or installs an update automatically. When a newer installer exists,
AI Lab offers to open the download page. Updating AI Lab does not update,
restart, remove, or alter installed containers, images, models, or named
volumes.

## Offline Use

The update check is optional. If there is no Internet connection, AI Lab stays
usable and does not show an error. Initial Podman images and models still need
their normal first-time downloads.