# Aion v0.0.3-beta.2 Release Notes

Status: published
Channel: beta
Released at: 2026-04-22T16:22:32Z

## Summary

`v0.0.3-beta.2` is the provider-auth bootstrap refresh for the Linux launcher line.

This release keeps the launcher-first bootstrap shape from `v0.0.3-beta.1`, but
fixes a real first-run gap in remote provider readiness. The packaged
`aion-ctrl` runtime now performs a minimal remote provider credential
verification during `config set ...` for the default OpenAI/Groq path. That
verification result becomes part of the launcher/installer-facing config
contract, so the bootstrap can distinguish:

- structurally ready config with verified remote credentials;
- rejected remote credentials that should stop first use;
- temporary provider/network verification outages that should surface a warning
  instead of pretending verification succeeded.

The Linux bootstrap also now surfaces provider-auth verification warnings
explicitly at the end of the install flow when the provider could not be
verified because of network or provider-side unavailability.

The product remains browser-based after launch: `aion-web` is still the
canonical product UI. The launcher is a Linux desktop shell for install, open,
status, update, repair, and diagnostics on top of the same local runtime.

## Public Distribution Scope

- Linux-first bootstrap installer.
- Bootstrap artifact: `aion-installer-linux-amd64`.
- Packaged runtime engine and launcher: `aion-ctrl-linux-amd64.tar.gz`.
- Desktop launcher shell bundled inside the runtime package.
- `aion-web` as the product UI opened from the launcher.
- Runtime images versioned under `ghcr.io/lechitz`.
- Local user state under `~/.aion`.

## Runtime Images

```text
ghcr.io/lechitz/aion-api:v0.0.2-beta.12
ghcr.io/lechitz/aion-chat:v0.0.2-beta.12
ghcr.io/lechitz/aion-web:v0.0.2-beta.12
ghcr.io/lechitz/aion-ingest:v0.0.2-beta.12
ghcr.io/lechitz/aion-streams:v0.0.2-beta.12
```

## Supported Platforms

Targeted for `v0.0.3-beta.2`:

- Linux x86_64
- Ubuntu 24.04
- Ubuntu 22.04
- Debian 12

Not supported in `v0.0.3-beta.2`:

- Windows
- macOS
- Linux ARM64

## Requirements

- Docker
- Docker Compose
- 8 GB RAM minimum/recommended for the current public beta cut
- 12 GB disk minimum
- internet access for image/artifact downloads
- one remote provider key for the default path: OpenAI or Groq
- local Ollama only when intentionally using the advanced local profile

## Release Gates

Required distribution gate:

```bash
cd /home/lechitz/Projetos/github/Aion/aion-ctrl
make distribution-check
```

## Explicit Deferrals

- Native Linux installer.
- Windows/macOS installers.
- ARM builds.
- Automatic Docker installation.
- Side-by-side runtime isolation on the same host.

## Integrity

Checksums are published in `checksums.txt` when release artifacts exist.

## Compatibility Note

`v0.0.3-beta.2` uses the bootstrap-only exception. The runtime image set remains
on `v0.0.2-beta.12`. Only the Linux public bootstrap surfaces changed in this
cut:

- `aion-installer-linux-amd64`
- `aion-ctrl-linux-amd64.tar.gz`

The installed product UI remains the same `aion-web` runtime contract. This cut
is specifically about improving remote-first readiness and making invalid remote
credentials visible before first use.