mrkeyoor.com_
Fri 16 Oct 18:54 UTC
AI Toolsevaluationupdated 05 Oct 2026

airi review

AIRI is a self-hosted animated AI companion with text and voice chat, Live2D or VRM characters, and optional game and messaging integrations. It runs as a web, desktop, or experimental mobile app and can use hosted model APIs or local providers.

+160stars / 7d
Verdict

Our AIRI run installed 2,699 packages and used 4,174 MB, then failed both the build and 14 of 2,238 tests, so this is a serious development project rather than a tidy self-hosted app. Try the packaged beta first if you want the animated companion itself. Build from source when Live2D or VRM, voice, and cross-app experiments justify the monorepo's size and unfinished edges.

We ran it

Lab card: what happened when we ran airiScreenshot of airi (airi.moeru.ai/docs)
Install✓ · 251s2699 packages · 4174 MB
Build✗ · 68s
Tests✗ · 222s2221 passed · 14 failed · 3 skipped of 2238 (vitest)
Repo5645 files~457,079 lines of source · 594.2 MB · 31 CI workflows

Answers from our run

Does airi build from source?

Dependencies installed in 251 seconds (2699 packages), and the build failed. We cloned commit 2e0e963 into a clean Debian container with 3 CPUs and no project-specific setup.

Do airi's tests pass?

Not all of them: 2221 of 2238 passed and 14 failed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Who should not use airi?

Anyone seeking a finished consumer product with a stable contract: the latest release is v0.12.0-beta.5, and the README calls the project early-stage.

What are the alternatives to airi?

Open-LLM-VTuber, SillyTavern, Eliza. Our AIRI run installed 2,699 packages and used 4,174 MB, then failed both the build and 14 of 2,238 tests, so this is a serious development project rather than a tidy self-hosted app.

Setup2/54,174 MB installed, then build and test commands failed
Docs4/5Detailed app paths and providers, but the scope is sprawling
Community5/550,065 stars and issue work active on October 5
Maturity2/5Beta release, early-stage label, and failed lab checks

Discussed on

  1. hnShow HN: Recreation of Neuro-sama for a year, alternative of Grok Companion10 points
  2. hnThe Open Source xAI Ani that's next level3 points

Who it’s for

Developers building a personal AI character around Live2D or VRM rather than a plain chat window.
Tinkerers who want one companion to talk, listen, use desktop tools, or connect to Discord, Telegram, Minecraft, and Factorio.
Vue and TypeScript contributors comfortable navigating a large pnpm workspace.
Users prepared to choose and configure separate language, speech, and transcription providers.

Who it’s NOT for

Anyone seeking a finished consumer product with a stable contract: the latest release is v0.12.0-beta.5, and the README calls the project early-stage.
Small contributor machines or narrow CI images: our install added 2,699 packages, consumed 4,174 MB, and still left a 594.2 MB checkout.
Teams that require a green clean-container gate: our build exited 129, while 14 of 2,238 tests failed and 2 errors remained.
Users who read self-hosted as a promise of zero collection in every distribution: the published application privacy policy lists IP address, usage, provider names, tool-call traces, and errors among collected data.
Windows ARM64 or Linux musl users who need desktop computer control: the current desktop README says its bundled CLI has no matching binary for those targets.

Setup reality

Our fresh Debian sandbox installed commit 2e0e963 in 251 seconds, adding 2,699 packages and using 4,174 MB. The build failed after 68 seconds with exit 129: 37 of 40 tasks succeeded, while stage-pocket and stage-web failed. Tests then failed after 222 seconds, with 2,221 passed, 14 failed, 3 skipped, and 2 errors out of 2,238.

AIRI can use local providers such as Ollama, but hosted language, speech, or transcription services need their own credentials. Telegram development also needs Postgres and bot credentials; Discord and Minecraft integrations use local environment files. The hosted backend diagram includes Postgres and Redis. A character setup may also need Live2D or VRM assets.

Current contributor instructions pin Node 26.7.0 and pnpm 11.24.0 through mise. Desktop startup installs Electron on first use, NixOS needs the supplied FHS shell, and computer control requires operating-system permissions. Mobile development adds Capacitor plus an iOS or Android toolchain. These paths are separate, so the two-line web quick start does not describe the whole product.

AIRI v0.12.0-beta.5 is an animated companion, not a chat skin

AIRI combines a language model with speech input, voice output, and a Live2D or VRM character. The desktop app can expose computer-use tools, while optional integrations reach Discord, Telegram, Minecraft, and Factorio. That makes AIRI interesting for someone trying to build a persistent virtual companion rather than another text box with a character portrait.

The project supports many hosted model APIs as well as local routes including Ollama, vLLM, and SGLang. Speech options include commercial services and local engines. Some ambitious items remain explicitly unfinished: the README marks its Memory Alaya work and pure in-browser WebGPU inference as work in progress. The latest packaged release is v0.12.0-beta.5, which is a fair label for a product spanning this many moving parts.

What happened when we ran it

Our sandbox installed commit 2e0e963 in 251 seconds. Pnpm pulled 2,699 packages and the installed tree occupied 4,174 MB. Before that install, the checkout already held 5,645 files, about 457,079 lines of source, and used 594.2 MB. This is a large working copy for a personal app, and cache or container costs will show up quickly on a contributor machine.

The build failed after 68 seconds with exit 129. Turbo reported 37 successful tasks out of 40, with 34 served from cache. The two named failures were @proj-airi/stage-pocket#build and @proj-airi/stage-web#build. The tail also warned that no output files were found for the auth-server build task and showed a browser-compatibility externalization warning. It does not establish why either failed task exited 129, so we will not assign a cause.

Tests failed after 222 seconds. Vitest reported 2,221 passed, 14 failed, and 3 skipped out of 2,238, plus 2 errors. The summary says 3 test files failed among 289. Its tail names a gesture test and an ambient-light sampling test, but it does not show all 14 failing assertions. Most of the suite passed; the release gate still ended red.

Our scan found 31 CI workflow files and pnpm workspaces, with no root Dockerfile and no directory literally named tests. That last detail does not mean AIRI lacks tests, since the Vitest output found them beside source across the workspace. It does tell you how this monorepo is organized: checks, applications, packages, services, and integrations are distributed rather than gathered into one conventional test tree.

Current source development pins Node 26.7.0 and pnpm 11.24.0

The contribution guide uses mise to install versions from .tool-versions. Current main pins Node 26.7.0, pnpm 11.24.0, and .NET 10. Our measured commit installed under the supplied Node 22 lab image, but matching today's contributor setup means using the repository pins before deciding whether a failure reproduces.

A two-command pnpm i and pnpm dev path starts Stage Web. Desktop development uses a separate Tamagotchi command, and the guide notes that a fresh Electron 42 setup downloads its binary when development starts. Pocket development calls Capacitor with a selected simulator or device. NixOS users get a dedicated FHS shell because Electron's shared libraries are outside its standard paths.

Integrations add services and secrets. The Telegram bot requires Postgres and credentials in a local environment file. Discord uses its own credentials, while Minecraft needs a running client, an exported world, and a port. The architecture diagram shows a hosted backend with Postgres and Redis. AIRI can remain local for selected model and speech paths, but the exact data route depends on every provider you enable.

Desktop computer control starts enabled in each new composer

The desktop README says a fresh chat composer begins with Use computer on. A selected request receives computer-use tools and can return screenshots to a vision-capable model. On macOS, the launching app may need Accessibility, Screen Recording, and Automation permissions. This is useful power with a sharp permission boundary: turn it off before sending a prompt that should not receive desktop tools.

The bundled computer-use CLI is version 0.0.16 and talks over a private Unix socket or Windows named pipe. Its current package has no matching binary for Windows ARM64 or Linux musl. The docs also warn that a zero exit code does not prove the requested interface change happened. Anyone building unattended desktop actions needs outcome checks, not only command status.

The application privacy policy lists analytics and AI-use metadata

AIRI's published application privacy policy says it may collect IP address, visited pages, time spent, operating system, approximate location, account identifiers, configured provider names, agent usage, MCP and tool-call traces, and errors. It names PostHog as a third-party service and says uninstalling stops collection. That policy is broader than many readers will infer from the phrase self-hosted. Review the distribution and configuration you plan to use before entering sensitive prompts.

Local providers can keep model calls on your hardware, but they do not automatically answer what the application sends elsewhere. The same review should cover speech services, transcription, sync, analytics, and every messaging integration. AIRI's provider catalog is a strength when you want choice. It also makes privacy a configuration-by-configuration decision rather than one property of the repository.

An October 5 push shows activity, while the release remains beta

GitHub showed 50,065 stars and 218 combined open issues and pull requests on October 5, 2026. The repository was pushed that day. Search results split the queue into 95 issues and 123 pull requests, and issue 2814 received a detailed local-provider streaming report the same day.

Issue 2814 reports that AIRI desktop 0.12.0-beta.5 can lose spaces while streaming from an OpenAI-compatible local server, even when the raw stream is correct. It is one report, not our lab finding, yet it captures the product risk well: a provider can connect and still produce damaged conversation text at an assembly boundary. AIRI is worth trying for its unusually broad companion experience. Our failed build and 14 test failures make the packaged beta the sensible first stop for users, while contributors should enter expecting a large moving codebase.

Alternatives

ProjectWhat it isPick it when
Open-LLM-VTuber gh↗A local cross-platform voice companion with interruption and Live2D avatar support.pick this instead when hands-free voice and a Live2D character matter more than AIRI's game and desktop scope.
SillyTavern gh↗A power-user frontend for character chat across local and hosted language models.pick this instead when character conversation and prompt control matter more than an animated autonomous companion.
Eliza gh↗An agent framework for building characters that act across services and plugins.pick this instead when you need an extensible agent runtime more than AIRI's finished avatar interface.

What people are saying

  1. [github-trending] moeru-ai/airi

Sources

  1. Project AIRI README
  2. Project AIRI contributing guide
  3. AIRI Stage Tamagotchi README
  4. Project AIRI privacy policy
  5. AIRI v0.12.0-beta.5 release
  6. AIRI issue 2814

More ai tools reviews

universal-modder · DeepEP-Ascend · DeepGEMM-Ascend · hypoarena · jeeves · faster-whisper · the whole board →