<source width="100%"

srcset="./docs/content/public/banner-light-1280x640.avif" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" /> <img

width="250" src="./docs/content/public/banner-light-1280x640.avif" />

Project AIRI

Re-creating Neuro-sama, a soul container of AI waifu / virtual characters to bring them into our world.

[Join Discord Server] [Try it] [简体中文] [日本語] [Русский] [Tiếng Việt] [Français] [한국어]

AIRI - A container of cyber living souls, re-creation of Neuro-sama | Product Hunt moeru-ai%2Fairi | Trendshift

Heavily inspired by Neuro-sama

[!TIP] > On Windows, you can also install AIRI with winget: > > ```powershell >

winget install MoeruAI.AIRI > > > Or install AIRI with [Scoop](https://scoop.sh/): > >powershell > scoop bucket add airi

https://github.com/moeru-ai/airi > scoop install airi/airi > ``` > > On macOS, you can install AIRI with Homebrew Cask without

adding a custom tap: > > sh > brew install --cask airi >

[!WARNING] Attention: We do not have any officially minted cryptocurrency or token associated with this project. Please check the information and proceed with caution.

[!NOTE] > > We've got a whole dedicated organization @proj-airi for all the sub-projects born from Project AIRI.

Check it out! > > RAG, memory system, embedded database, icons, Live2D utilities, and more!

[!TIP] > We have a translation project on Crowdin. If you find any inaccurate translations, feel free to

contribute improvements there. > <img style="width: 140px; height:

40px;" src="https://badges.crowdin.net/badge/light/crowdin-on-dark.png" srcset="https://badges.crowdin.net/badge/light/crowdin-on-dark.png 1x,

https://badges.crowdin.net/badge/light/[email protected] 2x" alt="Crowdin | Agile localization for tech companies" width="140" height="40" />

Have you dreamed about having a cyber living being (cyber waifu, digital pet) or digital companion that could play with and talk to you?

With the power of modern large language models like ChatGPT and famous Claude, asking a virtual being to

roleplay and chat with us is already easy enough for everyone. Platforms like Character.ai (a.k.a. c.ai) and

JanitorAI as well as local playgrounds like SillyTavern are already

good-enough solutions for a chat based or visual adventure game like experience.

But, what about the abilities to play games? And see what you are coding at? Chatting while playing games, watching videos, and is capable of doing many other things.

Perhaps you know Neuro-sama already. She is currently the best virtual streamer capable of playing games,

chatting, and interacting with you and the participants. Some also call this kind of being "digital human." **Sadly, as it's not open sourced, you

cannot interact with her after her live streams go offline**.

Therefore, this project, AIRI, offers another possibility here: let you own your digital life, cyber living, easily, anywhere, anytime.

Recent DevLogs & Stories

DevLog @ 2026.03.14: VRM stage lifecycle, cache, and observability - March 14, 2026 - [DevLog

@ 2026.02.16: Dome Keeper data collection and training pipeline](https://airi.moeru.ai/docs/en/blog/DevLog-2026.02.16/) - February 16, 2026 - [DevLog

@ 2026.01.01: AIRI Pocket and FlowChat memory experiments](https://airi.moeru.ai/docs/en/blog/DevLog-2026.01.01/) - January 1, 2026 - [DevLog @

2025.10.20: Electron migration, new models, and Moeru AI updates](https://airi.moeru.ai/docs/en/blog/DevLog-2025.10.20/) - October 20, 2025 - [DevLog

@ 2025.08.26: Pure vision progress for airi-factorio](https://airi.moeru.ai/docs/en/blog/DevLog-2025.08.26/) - August 26, 2025 - [DevLog @ 2025.08.05:

AIRI v0.7 release highlights](https://airi.moeru.ai/docs/en/blog/DevLog-2025.08.05/) - August 5, 2025 - [DevLog @ 2025.08.01: Streaming text animation

and grapheme clusters](https://airi.moeru.ai/docs/en/blog/DevLog-2025.08.01/) - August 1, 2025 - [DevLog @ 2025.07.18: Rethinking airi-factorio with

Factorio Learning Environment](https://airi.moeru.ai/docs/en/blog/DevLog-2025.07.18/) - July 18, 2025 - [DreamLog 0x1: The backstory of Project

AIRI](https://airi.moeru.ai/docs/en/blog/DreamLog-0x1/) - June 16, 2025 - More on the documentation site

What's So Special About This Project?

Unlike the other AI driven VTuber open source projects, アイリ was built with support of many Web technologies such as

WebGPU, WebAudio, [Web

Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers), WebAssembly,

WebSocket, etc. from the first day.

[!TIP] > Worrying about the performance drop since we are using Web related technologies? > > Don't worry, while the Web browser version is meant to

give an insight into how much we can push and do inside browsers and webviews, we will never fully rely on this. The desktop version of AIRI is

capable of using native NVIDIA CUDA and Apple Metal by default

(thanks to HuggingFace & the beloved candle project), without any complex dependency management. Considering

the tradeoff, it is partially powered by Web technologies for graphics, layouts, animations, and the WIP plugin system for everyone to integrate

things.

This means that アイリ is capable of running on modern browsers and devices and even on mobile devices (already done with PWA support). This brings a

lot of possibilities for us (the developers) to build and extend the power of アイリ VTuber to the next level, while still leaving the flexibility for

users to enable features that require TCP connections or other non-Web technologies such as connecting to a Discord voice channel or playing Minecraft

and Factorio with friends.

[!NOTE] > > We are still in the early stage of development where we are seeking out talented developers to join us and help us to make アイリ a

reality. > > It's ok if you are not familiar with Vue.js, TypeScript, and devtools required for this project, you can join us as an artist, designer,

or even help us to launch our first live stream. > > Even if you are a big fan of React, Svelte or even Solid, we welcome you. You can open a

sub-directory to add features that you want to see in アイリ, or would like to experiment with. > > Fields (and related projects) that we are looking

for: > > - Live2D modeller > - VRM modeller > - VRChat avatar designer > - Computer Vision > - Reinforcement Learning > - Speech Recognition > -

Speech Synthesis > - ONNX Runtime > - Transformers.js > - vLLM > - WebGPU > - Three.js > - WebXR ([checkout the another

project](https://github.com/moeru-ai/chat) we have under the @moeru-ai organization) > > **If you are interested, why not introduce yourself here?

Would like to join part of us to build AIRI?**

Current Progress & Roadmap

Capable of

available](https://github.com/moeru-ai/airi-factorio)) - [x] Play Kerbal Space Program (announcement TBD) - [ ]

Co-play Helldivers 2 (WIP) - [x] Chat in Telegram - [x] Chat in

Discord - [ ] Memory - [x] Pure in-browser database support (DuckDB WASM | pglite) - [ ] Memory Alaya (WIP) - [ ] Pure

in-browser local (WebGPU) inference - [x] Ears - [x] Audio input from browser - [x] Audio input from Discord - [x] Client side

speech recognition - [x] Client side talking detection - [x] Mouth - [x] Multi-provider voice synthesis, including

ElevenLabs, Microsoft/Azure Speech, OpenAI-compatible TTS, Alibaba Cloud Model Studio, and local Kokoro TTS - [x] Body - [x]

VRM support - [x] Control VRM model - [x] VRM model animations - [x] Auto blink - [x] Auto look at - [x] Idle eye movement - [x] Live2D support - [x]

Control Live2D model - [x] Live2D model animations - [x] Auto blink - [x] Auto look at - [x] Idle eye movement

Development

For detailed instructions to develop this project, follow CONTRIBUTING.md

[!NOTE] > By default, pnpm dev will start the development server for the Stage Web (browser version). If you would > like to try developing the

desktop version, please make sure you read CONTRIBUTING.md > to setup the environment correctly.

pnpm i
pnpm dev

Stage Web (Browser Version at airi.moeru.ai)

pnpm dev

Stage Tamagotchi (Desktop Version)

pnpm dev:tamagotchi

A Nix package for Tamagotchi is included. To run airi with Nix, first make sure to enable flakes, then run:

nix run github:moeru-ai/airi

NixOS

Electron requires shared libraries that aren't in standard paths on NixOS. Use the FHS shell defined in flake.nix:

nix develop .#fhs
pnpm dev:tamagotchi

Stage Pocket (Mobile Version)

Start the development server for the capacitor:

pnpm dev:pocket:ios --target <DEVICE_ID_OR_SIMULATOR_NAME>
# Or
CAPACITOR_DEVICE_ID_IOS=<DEVICE_ID_OR_SIMULATOR_NAME> pnpm dev:pocket:ios

You can see the list of available devices and simulators by running pnpm exec cap run ios --list.

If you need to connect server channel on pocket in wireless mode, you need to start tamagotchi as root:

sudo pnpm dev:tamagotchi

Then enable secure websocket in tamagotchi settings/connections.

Documentation Site

pnpm dev:docs

Publish

Run bumpp to update the monorepo version:

npx bumpp --no-commit --no-tag

Support of LLM API Providers (powered by xsai)

vLLM - [x] SGLang - [x] Ollama -

[x] 302.AI (sponsored) - [x] OpenAI - [x] [Azure

OpenAI API](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference) - [x] Anthropic Claude - [ ] [AWS

Claude](https://docs.anthropic.com/en/api/claude-on-amazon-bedrock) (PR welcome) - [x] DeepSeek - [x]

Qwen - [x] Google Gemini - [x] xAI

Zhipu - [x] SiliconFlow - [x] Stepfun - [x]

Baichuan - [x] Minimax - [x] Moonshot AI - [x]

ModelScope - [x] Player2 - [x] [Tencent

Cloud](https://cloud.tencent.com/document/product/1729) - [ ] Sparks (PR welcome) - [ ] [Volcano

Engine](https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=2QXCA1VI) (PR welcome) - [x] [Xiaomi

Mimo](https://platform.xiaomimimo.com)

Sub-projects Born from This Project

unspeech: Universal endpoint proxy server for /audio/transcriptions and /audio/speech, like LiteLLM but

for any ASR and TTS - hfup: tools to help on deploying, bundling to HuggingFace Spaces -

xsai-transformers: Experimental 🤗 Transformers.js

provider for xsAI. - WebAI: Realtime Voice Chat: Full

example of implementing ChatGPT's realtime voice from scratch with VAD + STT + LLM + TTS. -

@proj-airi/drizzle-duckdb-wasm: Drizzle ORM driver for DuckDB

WASM - @proj-airi/duckdb-wasm: Easy to use wrapper for

@duckdb/duckdb-wasm - AIRI Factorio: Allow AIRI to play Factorio. - [AIRI

DomeKeeper](https://github.com/proj-airi/game-playing-ai-dome-keeper): Allow AIRI to play DomeKeeper. - [Factorio RCON

API](https://github.com/nekomeowww/factorio-rcon-api): RESTful API wrapper for Factorio headless server console -

autorio: Factorio automation library -

tstl-plugin-reload-factorio-mod: Reload Factorio mod

when developing - Velin: Use Vue SFC and Markdown to write easy to manage stateful prompts for LLM -

demodel: Easily boost the speed of pulling your models and datasets from various of inference runtimes. -

inventory: Centralized model catalog and default provider configurations backend service - [MCP

Launcher](https://github.com/moeru-ai/mcp-launcher): Easy to use MCP builder & launcher for all possible MCP servers, just like Ollama for models! -

🥺 SAD: Documentation and notes for self-host and browser running LLMs.

```mermaid %%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%

flowchart TD Core("Core") Unspeech("unspeech") DBDriver("@proj-airi/drizzle-duckdb-wasm") MemoryDriver("[WIP] Memory Alaya")

DB1("@proj-airi/duckdb-wasm") SVRT("@proj-airi/server-runtime") Memory("Memory") STT("STT") Stage("Stage") StageUI("@proj-airi/stage-ui")

UI("@proj-airi/ui")

subgraph AIRI DB1 --> DBDriver --> MemoryDriver --> Memory --> Core UI --> StageUI --> Stage --> Core Core --> STT Core --> SVRT end

subgraph UI_Components UI --> StageUI UITransitions("@proj-airi/ui-transitions") --> StageUI UILoadingScreens("@proj-airi/ui-loading-screens") -->

StageUI FontCJK("@proj-airi/font-cjkfonts-allseto") --> StageUI FontXiaolai("@proj-airi/font-xiaolai") --> StageUI end

subgraph Apps Stage --> StageWeb("@proj-airi/stage-web") Stage --> StageTamagotchi("@proj-airi/stage-tamagotchi") Core -->

RealtimeAudio("@proj-airi/realtime-audio") Core --> PromptEngineering("@proj-airi/playground-prompt-engineering") end

subgraph Server_Components Core --> ServerSDK("@proj-airi/server-sdk") ServerShared("@proj-airi/server-shared") --> SVRT ServerShared --> ServerSDK end

STT -->|Speaking| Unspeech SVRT -->|Playing Factorio| F_AGENT SVRT -->|Playing Minecraft| MC_AGENT

subgraph Factorio_Agent F_AGENT("Factorio Agent") F_API("Factorio RCON API") factorio-server("factorio-server") F_MOD1("autorio")

F_AGENT --> F_API -.-> factorio-server F_MOD1 -.-> factorio-server end

subgraph Minecraft_Agent MC_AGENT("Minecraft Agent") Mineflayer("Mineflayer") minecraft-server("minecraft-server")

MC_AGENT --> Mineflayer -.-> minecraft-server end

XSAI("xsAI") --> Core XSAI --> F_AGENT XSAI --> MC_AGENT

Memory_PGVector("@proj-airi/memory-pgvector") --> Memory

style Core fill:#f9d4d4,stroke:#333,stroke-width:1px style AIRI fill:#fcf7f7,stroke:#333,stroke-width:1px style UI

fill:#d4f9d4,stroke:#333,stroke-width:1px style Stage fill:#d4f9d4,stroke:#333,stroke-width:1px style UI_Components

fill:#d4f9d4,stroke:#333,stroke-width:1px style Server_Components fill:#d4e6f9,stroke:#333,stroke-width:1px style Apps

fill:#d4d4f9,stroke:#333,stroke-width:1px style Factorio_Agent fill:#f9d4f2,stroke:#333,stroke-width:1px style Minecraft_Agent

fill:#f9d4f2,stroke:#333,stroke-width:1px

style DBDriver fill:#f9f9d4,stroke:#333,stroke-width:1px style MemoryDriver fill:#f9f9d4,stroke:#333,stroke-width:1px style DB1

fill:#f9f9d4,stroke:#333,stroke-width:1px style Memory fill:#f9f9d4,stroke:#333,stroke-width:1px style Memory_PGVector

fill:#f9f9d4,stroke:#333,stroke-width:1px ```

Similar Projects

Open sourced ones

semperai/amica: Great at VRM, WebXR - elizaOS/eliza: Great examples and

software engineering on how to integrate agent into various of systems and APIs -

ardha27/AI-Waifu-Vtuber: Great about Twitch API integrations -

InsanityLabs/AIVTuber: Nice UI and UX - IRedDragonICY/vixevia

Non-open-sourced ones

  • https://clips.twitch.tv/WanderingCaringDeerDxCat-Qt55xtiGDSoNmDDr https://www.youtube.com/watch?v=8Giv5mupJNE -

https://clips.twitch.tv/TriangularAthleticBunnySoonerLater-SXpBk1dFso21VcWD - https://www.youtube.com/@NOWA_Mirai

Project Status

Repobeats analytics image

Acknowledgements

  • Reka UI: for designing the documentation site, the new landing page is based on this, as well as implementing a

massive amount of UI components. (shadcn-vue is using Reka UI as the headless, do checkout!) - pixiv/ChatVRM -

[josephrocca/ChatVRM-js: A JS conversion/adaptation of parts of the ChatVRM (TypeScript) code for standalone use in OpenCharacters and

elsewhere](https://github.com/josephrocca/ChatVRM-js) - Design of UI and style was inspired by

Cookard, UNBEATABLE, and [Sensei! I

like you so much!](https://store.steampowered.com/app/2957700/_/), and artworks of [Ayame by Mercedes

Bazan](https://dribbble.com/shots/22157656-Ayame) with Wish by Mercedes Bazan -

mallorbc/whisper_mic - xsai: Implemented a decent amount of packages

to interact with LLMs and models, like Vercel AI SDK but way small.

Supporters

Thank you for supporting Project AIRI through OpenCollective, Patreon, and Ko-fi.

Project AIRI supporters

Special Thanks

Special thanks to all contributors for their contributions to Project AIRI ❤️

Star History

<source media="(prefers-color-scheme: dark)"

srcset="https://api.star-history.com/svg?repos=moeru-ai/airi&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)"

srcset="https://api.star-history.com/svg?repos=moeru-ai/airi&type=Date" /> <img alt="Star History Chart"

src="https://api.star-history.com/svg?repos=moeru-ai/airi&type=Date" />