nanakura/moeka-project
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: add instruction on running the nix package, chore(nix): update hash (#435)

Browse Source
This commit is contained in:
Weathercold
2025-08-25 11:26:33 +08:00
committed by GitHub
parent d8b5d3f262
commit e91c6101c8
4 changed files with 48 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.github/CONTRIBUTING.md
+10 -7
View File
@@ -12,7 +12,7 @@ Hello! Thank you for your interest in contributing to this project. This guide w
<details> <details>
<summary>Windows setup</summary> <summary>Windows setup</summary>
0. Download [Visual Studio](https://visualstudio.microsoft.com/downloads/), and follow the instructions here: https://rust-lang.github.io/rustup/installation/windows-msvc.html#walkthrough-installing-visual-studio-2022 0. Download [Visual Studio](https://visualstudio.microsoft.com/downloads/) and follow the instructions here: https://rust-lang.github.io/rustup/installation/windows-msvc.html#walkthrough-installing-visual-studio-2022
> Make sure to install Windows SDK and C++ build tools when installing Visual Studio. > Make sure to install Windows SDK and C++ build tools when installing Visual Studio.
@@ -51,7 +51,7 @@ Hello! Thank you for your interest in contributing to this project. This guide w
<details> <details>
<summary>macOS setup</summary> <summary>macOS setup</summary>
0. Open Terminal, (or iTerm2, Ghostty, Kitty, etc.) 0. Open Terminal (or iTerm2, Ghostty, Kitty, etc.)
1. Install `git`, `node` through `brew` 1. Install `git`, `node` through `brew`
```shell ```shell
@@ -70,7 +70,7 @@ Hello! Thank you for your interest in contributing to this project. This guide w
<details> <details>
<summary>Linux setup</summary> <summary>Linux setup</summary>
0. Open Terminal 0. Open terminal
1. Follow [nodesource/distributions: NodeSource Node.js Binary Distributions](https://github.com/nodesource/distributions?tab=readme-ov-file#table-of-contents) to install `node` 1. Follow [nodesource/distributions: NodeSource Node.js Binary Distributions](https://github.com/nodesource/distributions?tab=readme-ov-file#table-of-contents) to install `node`
2. Follow [Git](https://git-scm.com/downloads/linux) to install `git` 2. Follow [Git](https://git-scm.com/downloads/linux) to install `git`
3. Install `pnpm` through `corepack` 3. Install `pnpm` through `corepack`
@@ -78,8 +78,11 @@ Hello! Thank you for your interest in contributing to this project. This guide w
```shell ```shell
corepack enable corepack enable
corepack prepare pnpm@latest --activate corepack prepare pnpm@latest --activate
4. If you would love to help to develop the desktop version, you will need those dependencies:
``` ```
4. If you would love to help to develop the desktop version, you will need those dependencies:
```shell
sudo apt install \ sudo apt install \
libssl-dev \ libssl-dev \
libglib2.0-dev \ libglib2.0-dev \
@@ -94,12 +97,12 @@ Hello! Thank you for your interest in contributing to this project. This guide w
> [!WARNING] > [!WARNING]
> >
> If you haven't clone this repository, skip this section. > If you haven't cloned this repository, skip this section.
Make sure your local repository is up to date with the upstream repository: Make sure your local repository is up to date with the upstream repository:
```shell ```shell
git fetch -all git fetch --all
git checkout main git checkout main
git pull upstream main --rebase git pull upstream main --rebase
``` ```
@@ -336,7 +339,7 @@ You should be able to browse the branch on your fork repository.
> [!NOTE] > [!NOTE]
> >
> If this is your first time contributing with this project, you need to add the upstream repository too: > If this is your first time contributing to this project, you need to add the upstream repository too:
> >
> ```shell > ```shell
> git remote add upstream https://github.com/moeru-ai/airi.git > git remote add upstream https://github.com/moeru-ai/airi.git
.github/PULL_REQUEST_TEMPLATE.md
+2 -2
View File
@@ -1,11 +1,11 @@
## Description ## Description
<!-- Please insert your description here and provide especially info about the "what" this PR is solving --> <!-- Please insert your description here and especially provide info about the "what" this PR is solving -->
## Linked Issues ## Linked Issues
<!-- Optional, if you have any --> <!-- Optional, if you have any -->
## Additional context ## Additional Context
<!-- e.g. is there anything you'd like reviewers to focus on? --> <!-- e.g. is there anything you'd like reviewers to focus on? -->
README.md
+30 -24
View File
@@ -14,7 +14,7 @@
<h1 align="center">Project AIRI</h1> <h1 align="center">Project AIRI</h1>
<p align="center">Re-creating Neuro-sama, a container of souls of AI waifu / virtual characters to bring them into our worlds.</p> <p align="center">Re-creating Neuro-sama, a soul container of AI waifu / virtual characters to bring them into our world.</p>
<p align="center"> <p align="center">
[<a href="https://discord.gg/TgQ3Cu2F7A">Join Discord Server</a>] [<a href="https:///airi.moeru.ai">Try it</a>] [<a href="https://github.com/moeru-ai/airi/blob/main/docs/README.zh-CN.md">简体中文</a>] [<a href="https://github.com/moeru-ai/airi/blob/main/docs/README.ja-JP.md">日本語</a>] [<a href="https://discord.gg/TgQ3Cu2F7A">Join Discord Server</a>] [<a href="https:///airi.moeru.ai">Try it</a>] [<a href="https://github.com/moeru-ai/airi/blob/main/docs/README.zh-CN.md">简体中文</a>] [<a href="https://github.com/moeru-ai/airi/blob/main/docs/README.ja-JP.md">日本語</a>]
@@ -40,21 +40,21 @@
> [!NOTE] > [!NOTE]
> >
> We got a whole dedicated organization [@proj-airi](https://github.com/proj-airi) for all the sub-project that born from Project AIRI, check it out! > We've got a whole dedicated organization [@proj-airi](https://github.com/proj-airi) for all the sub-projects born from Project AIRI. Check it out!
> >
> RAG, memory system, embedded database, icons, Live2D utilities, and more! > RAG, memory system, embedded database, icons, Live2D utilities, and more!
Have you dreamed about having a cyber living being (cyber waifu / husbando, digital pet), or digital companion that could play with and talk to you? Have you dreamed about having a cyber living being (cyber waifu / husbando, digital pet) or digital companion that could play with and talk to you?
With the power of modern large language models like [ChatGPT](https://chatgpt.com), and famous [Claude](https://claude.ai), asking a virtual being able to have role playing and chat with us is already easy enough for everyone. Platforms like [Character.ai (a.k.a. c.ai)](https://character.ai) and [JanitorAI](https://janitorai.com/), and local playgrounds like [SillyTavern](https://github.com/SillyTavern/SillyTavern) is already a well-enough solution for chat based, or visual adventure game like experience. With the power of modern large language models like [ChatGPT](https://chatgpt.com) and famous [Claude](https://claude.ai), 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)](https://character.ai) and [JanitorAI](https://janitorai.com/) as well as local playgrounds like [SillyTavern](https://github.com/SillyTavern/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 capable of doing many other things. > But, what about the abilities to play games? And see what you are coding at? Chatting while playing games, watching videos, and capable of doing many other things.
Perhaps you know [Neuro-sama](https://www.youtube.com/@Neurosama) already, she is currently the best companion capable of playing games, chatting, and interacting with you and the participants (in VTuber community), some call this kind of being, "digital human" too. **Sadly, it's not open sourced, you cannot interact with her after she went offline from live stream**. Perhaps you know [Neuro-sama](https://www.youtube.com/@Neurosama) 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**. Therefore, this project, AIRI, offers another possibility here: **let you own your digital life, cyber living, easily, anywhere, anytime**.
## DevLogs we posted & Recent updates ## DevLogs We Posted & Recent Updates
- [DevLog @ 2025.07.18](https://airi.moeru.ai/docs/blog/DevLog-2025.07.18/) on July 18, 2025 - [DevLog @ 2025.07.18](https://airi.moeru.ai/docs/blog/DevLog-2025.07.18/) on July 18, 2025
- [DreamLog 0x1](https://airi.moeru.ai/docs/blog/dreamlog-0x1/) on June 16, 2025 - [DreamLog 0x1](https://airi.moeru.ai/docs/blog/dreamlog-0x1/) on June 16, 2025
@@ -62,24 +62,24 @@ Therefore, this project, AIRI, offers another possibility here: **let you own yo
- [DevLog @ 2025.05.16](https://airi.moeru.ai/docs/blog/DevLog-2025.05.16/) on May 16, 2025 - [DevLog @ 2025.05.16](https://airi.moeru.ai/docs/blog/DevLog-2025.05.16/) on May 16, 2025
- ...more on [documentation site](https://airi.moeru.ai/docs) - ...more on [documentation site](https://airi.moeru.ai/docs)
## What's so special for this project? ## What's So Special About This Project?
Unlike the other AI driven VTuber open source projects, アイリ VTuber was built with many support of Web technologies such as [WebGPU](https://www.w3.org/TR/webgpu/), [WebAudio](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API), [Web Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers), [WebAssembly](https://webassembly.org/), [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket), etc. from the first day. Unlike the other AI driven VTuber open source projects, アイリ was built with support of many Web technologies such as [WebGPU](https://www.w3.org/TR/webgpu/), [WebAudio](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API), [Web Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers), [WebAssembly](https://webassembly.org/), [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket), etc. from the first day.
> [!TIP] > [!TIP]
> Worry about the performance drop since we are using Web related technologies? > Worrying about the performance drop since we are using Web related technologies?
> >
> Don't worry, while Web browser version meant to give a insight about 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](https://developer.nvidia.com/cuda-toolkit) and [Apple Metal](https://developer.apple.com/metal/) by default (thanks to HuggingFace & beloved [candle](https://github.com/huggingface/candle) project), without any complex dependency managements, considering the tradeoff, it was partially powered by Web technologies for graphics, layouts, animations, and the WIP plugin systems for everyone to integrate things. > Don't worry, while Web browser version is meant to give an insight about 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](https://developer.nvidia.com/cuda-toolkit) and [Apple Metal](https://developer.apple.com/metal/) by default (thanks to HuggingFace & beloved [candle](https://github.com/huggingface/candle) project), without any complex dependency managements, considering the tradeoff, it was partially powered by Web technologies for graphics, layouts, animations, and the WIP plugin systems for everyone to integrate things.
This means that **アイリ VTuber is capable to run on modern browsers and devices**, and even on mobile devices (already done with PWA support), this brought a lot of possibilities for us (the developers) to build and extend the power of アイリ VTuber to the next level, while still left the flexibilities for users to enable features that requires TCP connections or other non-Web technologies such as connect to voice channel to Discord, or playing Minecraft, Factorio with you and your friends. 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 flexibilities for users to enable features that requires TCP connections or other non-Web technologies such as connecting to Discord voice channel or playing Minecraft and Factorio with friends.
> [!NOTE] > [!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 アイリ VTuber a reality. > 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 that required for this project, you can join us as an artist, designer, or even help us to launch our first live stream. > It's ok if you are not familiar with Vue.js, TypeScript, and devtools that required for this project, you can join us as an artist, designer, or even help us to launch our first live stream.
> >
> Even you are a big fan of React or Svelte, even Solid, we welcome you, you can open a sub-directory to add features that you want to see in アイリ VTuber, or would like to experiment with. > Even 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: > Fields (and related projects) that we are looking for:
> >
@@ -95,11 +95,11 @@ This means that **アイリ VTuber is capable to run on modern browsers and devi
> - vLLM > - vLLM
> - WebGPU > - WebGPU
> - Three.js > - Three.js
> - WebXR ([checkout the another project](https://github.com/moeru-ai/chat) we have under @moeru-ai organization) > - WebXR ([checkout the another project](https://github.com/moeru-ai/chat) we have under the @moeru-ai organization)
> >
> **If you are interested in, why not introduce yourself here? [Would like to join part of us to build AIRI?](https://github.com/moeru-ai/airi/discussions/33)** > **If you are interested, why not introduce yourself here? [Would like to join part of us to build AIRI?](https://github.com/moeru-ai/airi/discussions/33)**
## Current progress ## Current Progress
<img src="./docs/content/public/readme-image-pc-preview.avif"> <img src="./docs/content/public/readme-image-pc-preview.avif">
@@ -137,10 +137,10 @@ Capable of
## Development ## Development
> For detailed instructions to develop this project, follow the [CONTRIBUTING.md](./.github/CONTRIBUTING.md) > For detailed instructions to develop this project, follow [CONTRIBUTING.md](./.github/CONTRIBUTING.md)
> [!NOTE] > [!NOTE]
> By default, `pnpm dev` will start the development server for the Stage Web (browser version), if you would > 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](./.github/CONTRIBUTING.md) > like to try developing the desktop version, please make sure you read [CONTRIBUTING.md](./.github/CONTRIBUTING.md)
> to setup the environment correctly. > to setup the environment correctly.
@@ -149,19 +149,25 @@ pnpm i
pnpm dev pnpm dev
``` ```
### Stage Web (Browser version for [airi.moeru.ai](https://airi.moeru.ai)) ### Stage Web (Browser Version at [airi.moeru.ai](https://airi.moeru.ai))
```shell ```shell
pnpm dev pnpm dev
``` ```
### Stage Tamagotchi (Desktop version) ### Stage Tamagotchi (Desktop Version)
```shell ```shell
pnpm dev:tamagotchi pnpm dev:tamagotchi
``` ```
### Documentation site A Nix package for Tamagotchi is included. To run airi with Nix, first make sure to enable flakes, then run:
```shell
nix run github:moeru-ai/airi
```
### Documentation Site
```shell ```shell
pnpm dev:docs pnpm dev:docs
@@ -169,13 +175,13 @@ pnpm dev:docs
### Publish ### Publish
Please update the version in `Cargo.toml` after running the `bumpp`: Please update the version in `Cargo.toml` after running `bumpp`:
```shell ```shell
npx bumpp --no-commit --no-tag npx bumpp --no-commit --no-tag
``` ```
## Supported the following LLM API Providers (powered by [xsai](https://github.com/moeru-ai/xsai)) ## Support of LLM API Providers (powered by [xsai](https://github.com/moeru-ai/xsai))
- [x] [OpenRouter](https://openrouter.ai/) - [x] [OpenRouter](https://openrouter.ai/)
- [x] [vLLM](https://github.com/vllm-project/vllm) - [x] [vLLM](https://github.com/vllm-project/vllm)
@@ -206,7 +212,7 @@ npx bumpp --no-commit --no-tag
- [ ] [Sparks](https://www.xfyun.cn/doc/spark/Web.html) (PR welcome) - [ ] [Sparks](https://www.xfyun.cn/doc/spark/Web.html) (PR welcome)
- [ ] [Volcano Engine](https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=2QXCA1VI) (PR welcome) - [ ] [Volcano Engine](https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=2QXCA1VI) (PR welcome)
## Sub-projects born from this project ## Sub-projects Born from This Project
- [Awesome AI VTuber](https://github.com/proj-airi/awesome-ai-vtuber): A curated list of AI VTubers and related projects - [Awesome AI VTuber](https://github.com/proj-airi/awesome-ai-vtuber): A curated list of AI VTubers and related projects
- [`unspeech`](https://github.com/moeru-ai/unspeech): Universal endpoint proxy server for `/audio/transcriptions` and `/audio/speech`, like LiteLLM but for any ASR and TTS - [`unspeech`](https://github.com/moeru-ai/unspeech): Universal endpoint proxy server for `/audio/transcriptions` and `/audio/speech`, like LiteLLM but for any ASR and TTS
package.nix
+6 -5
View File
@@ -27,7 +27,7 @@
rustPlatform.buildRustPackage (final: { rustPlatform.buildRustPackage (final: {
pname = "airi"; pname = "airi";
version = "0.7.1"; version = "0.7.2-beta.2";
src = ./.; src = ./.;
@@ -39,7 +39,7 @@ rustPlatform.buildRustPackage (final: {
pnpmDeps = pnpm.fetchDeps { pnpmDeps = pnpm.fetchDeps {
inherit (final) pname version src; inherit (final) pname version src;
fetcherVersion = 1; fetcherVersion = 1;
hash = "sha256-XkSqDFiDUH3Z/bykyLcXLlFiIOGtHR/i1ZkErX0GuQk="; # To update, set it to "" hash = "sha256-y28rG+9NADUdwdjIAkYCqmYOKLoEWosAOpiGM4JPQoQ="; # To update, set it to ""
}; };
# Cache of assets downloaded during vite build # Cache of assets downloaded during vite build
@@ -135,9 +135,10 @@ rustPlatform.buildRustPackage (final: {
meta = { meta = {
description = "Self-hostable AI waifu / companion / VTuber"; description = "Self-hostable AI waifu / companion / VTuber";
longDescription = '' longDescription = ''
AIRI is a container of souls of AI waifu / virtual characters to bring them into our worlds, AIRI is a soul container of AI waifu / virtual characters to bring them into our world,
wishing to achieve Neuro-sama's altitude, completely LLM and AI driven, capable of realtime wishing to achieve Neuro-sama's altitude. It's completely LLM and AI driven, capable of
voice chat, Minecraft playing, Factorio playing. It can be run in Browser or Desktop. realtime voice chat, playing Minecraft and Factorio. It can be run in browser or on desktop.
This is the desktop version.
''; '';
homepage = "https://github.com/moeru-ai/airi"; homepage = "https://github.com/moeru-ai/airi";
changelog = "https://github.com/moeru-ai/airi/releases/tag/v${final.version}"; changelog = "https://github.com/moeru-ai/airi/releases/tag/v${final.version}";