mrkeyoor.com_
Tue 01 Sept 17:43 UTC
AI Toolsevaluationupdated 25 Aug 2026

airi review

Airi is a self-hosted animated AI companion that can talk, listen, display a Live2D or VRM character, and connect to games or chat services. It aims beyond a text roleplay window by combining language models, speech, avatar motion, desktop and browser stages, and integrations in one project.

+238stars / 7d
Verdict

Airi is one of the more ambitious open companion projects, and it already joins voice, animated characters, multiple model providers, and game or chat integrations in a coherent direction. That breadth is also the risk: the repository is large, core roadmap items remain unfinished, and our measured commit neither built nor passed all tests. Try the packaged release or hosted stage first, then adopt only if its animated and cross-app capabilities justify the moving parts.

We ran it

Lab card: what happened when we ran airiScreenshot of airi (airi.moeru.ai/docs)
Install✓ · 213s2839 packages · 4781 MB
Build✗ · 45s
Tests✗ · 119s1436 passed · 12 failed · 1 skipped of 1449 (vitest)
Repo5200 files~394,897 lines of source · 589.5 MB · 29 CI workflows

Answers from our run

Does airi build from source?

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

Do airi's tests pass?

Not all of them: 1436 of 1449 passed and 12 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?

Users seeking a finished offline companion with no provider setup: the roadmap still lists pure browser WebGPU inference and the Memory Alaya system as unfinished.

What are the alternatives to airi?

Open-LLM-VTuber, SillyTavern, Amica. Airi is one of the more ambitious open companion projects, and it already joins voice, animated characters, multiple model providers, and game or chat integrations in a coherent direction.

Setup2/5Packaged apps exist; source setup is huge and our build failed
Docs4/5Broad README and contributor guide, with some setup still dispersed
Community5/5Daily changes, current releases, translations, and active issue work
Maturity2/5Usable releases exist, but core systems and interfaces are still moving

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

People who want an animated personal companion rather than a plain chat interface.
VTuber and character developers experimenting with Live2D, VRM, speech, and real-time interaction.
Contributors interested in a TypeScript monorepo spanning web, Electron, mobile, bots, games, and AI providers.
Self-hosters willing to configure model and speech providers or connect local services such as Ollama.

Who it’s NOT for

Users seeking a finished offline companion with no provider setup: the roadmap still lists pure browser WebGPU inference and the Memory Alaya system as unfinished.
Anyone who needs a small codebase or quick contributor install: our checkout was 589.5 MB, and pnpm installed 2,839 packages using 4,781 MB.
Teams requiring a clean build and test baseline from the measured commit: our build exited 129, while 12 of 1,449 tests failed.
People who only need text roleplay: the repository includes avatar rendering, audio pipelines, desktop and mobile apps, servers, game bridges, and bot integrations that add weight without improving a simple chat session.
Integrators who need a settled external module SDK today: an open report says the published server SDK cannot install because better-ws is missing from npm, and another documents first-connection events being dropped until reconnect.

Setup reality

In our fresh Debian sandbox, pnpm installation succeeded in 213 seconds, adding 2,839 packages and using 4,781 MB. The build failed with exit 129 after 45 seconds: Turbo reported 29 successful tasks out of 33 and named stage-tamagotchi as failed. The supplied log does not state why the process exited 129.

Tests ran for 119 seconds: 1,436 passed, 12 failed, and 1 was skipped out of 1,449. All 12 displayed failures were in @proj-airi/better-ws's src/index.test.ts; the summary also reported one error. The log is not enough to assign a cause.

Running Airi needs an LLM provider or a compatible local service, plus separate speech credentials or local models for the features you enable. Contributors need Node.js 23+, pnpm, and platform libraries for desktop work; bot and game integrations add their own credentials, databases, or running game clients.

A companion with a body and many connections

Airi is trying to build the sort of persistent virtual character usually seen in AI VTuber demonstrations. The character can listen through a microphone, speak through several synthesis providers, and appear as a Live2D or VRM model with blinking, gaze, idle motion, and expressions. Language-model support spans hosted APIs and compatible local servers such as Ollama, vLLM, and SGLang.

The project reaches beyond conversation. Its repository includes Telegram and Discord bots, Minecraft and Factorio work, a desktop companion, a browser stage, a mobile app, server packages, audio pipelines, and a plugin system under development. This makes Airi interesting as a character platform. It also means a person wanting one chat window is buying a lot of unrelated machinery.

The main README is in English, with maintained links to Chinese, Japanese, Russian, Vietnamese, French, and Korean versions. Packaged desktop releases are available, and a browser version lets prospective users see the stage without building the monorepo. That is the sensible first trial because source development is a much larger commitment.

What happened when we ran it

We cloned commit d5742db into an unprivileged Debian container with 3 CPUs and 8 GB of RAM. The checkout contained 5,200 files, about 394,897 lines of source, and occupied 589.5 MB. Installing with pnpm succeeded in 213 seconds. It added 2,839 packages and used 4,781 MB on disk.

The build failed after 45 seconds with exit code 129. Turbo completed 29 tasks out of 33 and reported that the @proj-airi/stage-tamagotchi build command exited 129. The ui-server-auth task had transformed 3,762 modules before its process also exited 129, and Turbo warned that another auth-server task produced no output files. The supplied tail does not explain the exit code, so there is no evidence for a more specific cause.

Tests ran for 119 seconds. Vitest reported 1,436 passing tests, 12 failures, and 1 skipped test out of 1,449, plus one error. The displayed failures all came from 12 cases in @proj-airi/better-ws's src/index.test.ts. A server test printed an EADDRINUSE scenario and another log line came from an extension-host error fixture, but the supplied summary does not connect either line to the failed cases.

The repository has 29 CI workflow files and colocates tests beside source rather than keeping a top-level tests directory. Our result is therefore one concrete snapshot: installation worked, while the aggregate build and test commands did not finish cleanly at that commit.

The product path is easier than the contributor path

Most users should start with the current desktop release or browser stage. Airi v0.11.3, released on July 18, 2026, added desktop voice input, improved microphone permissions, character-card packages, and fixes around authentication and production assets. Windows users can install through winget or Scoop, and macOS users have a Homebrew cask.

Getting useful conversation still requires choices. You need a language-model provider, an OpenAI-compatible endpoint, or a local server such as Ollama. Speech recognition and synthesis have their own provider and local options. Avatar use requires a compatible model, while Discord, Telegram, Minecraft, and Factorio integrations each bring separate configuration. Airi offers the pieces, but it cannot choose a privacy, cost, and latency tradeoff for you.

Contributor setup asks for Node.js 23 or newer, Corepack, and pnpm. Desktop work adds Rust and operating-system libraries. The monorepo's package count reflects how many surfaces share code: stage UI, model drivers, audio, servers, bots, plugins, docs, and native shells all live together. A focused change can still trigger a wide dependency and test graph.

The unfinished parts matter

The README calls Airi early-stage. Its roadmap marks pure browser-local WebGPU inference and the Memory Alaya system as unfinished. Factorio has a proof of concept, while some game goals remain works in progress. The plugin system is also described as work in progress. These labels are useful boundaries, especially when the project's presentation can make the companion look more complete than its underlying platform.

Open issues show interface churn in practical places. One August 25 report says the published server SDK cannot install because its better-ws dependency is absent from npm. Another documents external text events being dropped on the first connection until the stage reconnects, with a proposed fix under review. A separate current report concerns a black screen on the second app launch. These are specific reasons to test the exact client, provider, and integration path you plan to use.

Health and the decision

Airi was pushed on August 25, 2026, a little over a month after v0.11.3. Current pull requests cover transcription, Wayland behavior, VRM emotions, voice design, provider compatibility, analytics, and server fixes. The combined GitHub count includes issues and pull requests, and the recent queue shows active development rather than a dormant backlog.

Use Airi if an animated, voiced character that can cross into desktop apps, chat services, and games is the point. Its ambition is backed by real applications and releases, though the platform is still changing quickly. For straightforward character roleplay, SillyTavern is easier to justify. For Airi, begin with one avatar and one provider, verify voice and restart behavior, and expand only after that path is dependable.

Alternatives

ProjectWhat it isPick it when
Open-LLM-VTuber gh↗A self-hosted voice-interactive AI VTuber with avatar and model-provider support.pick this instead when you want a narrower voice-and-avatar project and do not need Airi's broad app and game ecosystem.
SillyTavern gh↗A mature local interface for character chat, roleplay, model providers, and extensions.pick this instead when text roleplay and character management matter more than an animated desktop body or game control.
AmicaA browser-based AI companion centered on VRM avatars, voice, and WebXR.pick this instead when VRM and browser or WebXR interaction are the focus and you want a smaller surface to evaluate.

What people are saying

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

Sources

  1. Project Airi README
  2. Project Airi contributing guide
  3. Airi v0.11.3 release
  4. Airi server SDK install issue
  5. Airi first-connection event issue

More ai tools reviews

claudian · SkillSpector · robin · mjlab · MoGe · awesome-design-md · the whole board →