v0.8.0-beta.4

moeru-ai/airiv0.8.0-beta.4Dec 17, 2025by nekomeowww

AI Summary

This beta release introduces a new model-driver package for driving capabilities and an experimental Three.js performance runtime. It includes PostHog integration for analytics and fixes several critical bugs related to audio input, UI imports, and system prompt initialization.

Key Highlights

  • New `model-driver-lipsync` package for driving capabilities
  • Experimental Three.js performance runtime design
  • PostHog analytics integration for app version tracking
  • Fixes for headless model issues and audio timeout handling

New Features

  • New model-driver-lipsync package
  • Experimental Three.js performance runtime
  • PostHog analytics integration

Full Release Notes

## Before downloading

> [!CAUTION]
> **Data lost warning.**
> You should download [v0.8.0-beta.2](https://github.com/moeru-ai/airi/releases/tag/v0.8.0-beta.2) and export the data before downloading v0.8.0-beta.4.
> **Or your chat data may lost**.
>
> After downloaded, navigate to **Settings** -> **Data** -> **Export Data** for downloading data.

## Installation

### macOS

> [!TIP]
> For macOS users, currently Apple requires all installed App to have code sign validated with Apple servers, 
> while we are working hard for enrolling the Apple Developer Program for correct code signing, this error message may be prompted
> > Apple could not verify “AIRI.app” is free of malware that may harm your Mac or compromise your privacy.
> 
> <img width="260" height="243" alt="image" src="https://github.com/user-attachments/assets/ee48e445-8ecb-4e64-a41e-0cc0126fc0c6" />
> 
> In such case, you can always bypass this by issuing this following command in Terminal.app or iTerm2.app
> ```shell
> sudo xattr -c '/Applications/airi.app'
> ```

### Windows

Download and install.

### Linux

<details>
<summary>Flatpak (x86_64, x64, amd64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-x64.flatpak
flatpak install -u AIRI-0.8.0-beta.4-linux-x64.flatpak
rm -rf AIRI-0.8.0-beta.4-linux-x64.flatpak
```

</details>

<details>
<summary>Flatpak (aarch64, arm64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-arm64.flatpak
flatpak install -u AIRI-0.8.0-beta.4-linux-arm64.flatpak
rm -rf AIRI-0.8.0-beta.4-linux-arm64.flatpak
```

</details>

<details>
<summary>Debian / Ubuntu / <code>apt</code> / <code>dpkg</code> (x86_64, x64, amd64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-amd64.deb
sudo apt install AIRI-0.8.0-beta.4-linux-amd64.deb
rm -rf AIRI-0.8.0-beta.4-linux-amd64.deb
```

</details>

<details>
<summary>Debian / Ubuntu / <code>apt</code> / <code>dpkg</code> (aarch64, arm64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-arm64.deb
sudo apt install AIRI-0.8.0-beta.4-linux-arm64.deb
rm -rf AIRI-0.8.0-beta.4-linux-arm64.deb
```

</details>

<details>
<summary>Fedora / <code>rpm</code> / <code>dnf</code> (x86_64, x64, amd64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-x86_64.rpm
sudo dnf install AIRI-0.8.0-beta.4-linux-x86_64.rpm
rm -rf AIRI-0.8.0-beta.4-linux-x86_64.rpm
```

</details>

<details>
<summary>Fedora / <code>rpm</code> / <code>dnf</code> (aarch64, arm64)</summary>

```shell
wget https://github.com/moeru-ai/airi/releases/download/v0.8.0-beta.4/AIRI-0.8.0-beta.4-linux-aarch64.rpm
sudo dnf install AIRI-0.8.0-beta.4-linux-aarch64.rpm
rm -rf AIRI-0.8.0-beta.4-linux-aarch64.rpm
```

</details>

### 🚀 Features

- **model-driver-lipsync**: New package for model driving capabilities - by @nekomeowww [<samp>(08cab)</samp>](https://github.com/moeru-ai/airi/commit/08cab851)
- **stage-tamagotchi,stage-pages,stage-shared**: Show alert when there is no audio input for troubleshooting - by @sumimakito [<samp>(1829e)</samp>](https://github.com/moeru-ai/airi/commit/1829eb1e)
- **stage-ui-three-performance-runtime**: Init new experimental three performance runtime design - by @Lilia-Chen in https://github.com/moeru-ai/airi/issues/809 [<samp>(c74f3)</samp>](https://github.com/moeru-ai/airi/commit/c74f3352)
- **stage-web, stage-tamagotchi**: Register app version to posthog - by @luoling8192 [<samp>(35227)</samp>](https://github.com/moeru-ai/airi/commit/35227854)

### 🐞 Bug Fixes

- **airi-plugin-vscode**:
  - Add EOL line - by @nekomeowww [<samp>(7f3a0)</samp>](https://github.com/moeru-ai/airi/commit/7f3a0726)
- **server-sdk,airi-plugin-vscode**:
  - Improve connect, ensure connected before sending - by @nekomeowww [<samp>(84c05)</samp>](https://github.com/moeru-ai/airi/commit/84c053b4)
- **stage-pages**:
  - Missing component import - by @nekomeowww [<samp>(59442)</samp>](https://github.com/moeru-ai/airi/commit/59442bea)
- **stage-tamagotchi**:
  - Now h3 treats timeout as seconds instead of milliseconds - by @nekomeowww [<samp>(c5b58)</samp>](https://github.com/moeru-ai/airi/commit/c5b58c61)
  - Do not create nested callback for injeca constructor - by @nekomeowww [<samp>(263e1)</samp>](https://github.com/moeru-ai/airi/commit/263e1849)
- **stage-ui**:
  - Prevent NaN or negative scale to fix the headless model issue - by @sumimakito [<samp>(90fd3)</samp>](https://github.com/moeru-ai/airi/commit/90fd3b48)
  - Sync & broadcast for all BroadcastChannel peers - by @nekomeowww [<samp>(23879)</samp>](https://github.com/moeru-ai/airi/commit/238797db)
  - Fixed the system prompt initialisation bug - by @Lilia-Chen in https://github.com/moeru-ai/airi/issues/796 [<samp>(c19ea)</samp>](https://github.com/moeru-ai/airi/commit/c19ead96)
  - AIRI in full resolution! fixed pixi.js resolution issue - by @shinohara-rin in https://github.com/moeru-ai/airi/issues/808 [<samp>(58897)</samp>](https://github.com/moeru-ai/airi/commit/588978d9)
- **stage-ui,stage-web,stage-tamagotchi**:
  - Should not use useI18n in non-setup hook - by @nekomeowww [<samp>(efa3b)</samp>](https://github.com/moeru-ai/airi/commit/efa3b8de)

## New Contributors
* @shinohara-rin made their first contribution in https://github.com/moeru-ai/airi/pull/808