Airu

Pixel-art Felyne (Monster Hunter) desktop pet with AI chat, available as a standalone Tauri app or a DeepSeek Harness plugin.

DSH Plugin

A floating pixel-art Felyne pet for DeepSeek Harness web UI. The pet idles on your page, reacts to AI conversations, and can be dragged around.

Prerequisites

• Node.js >= 18
• DeepSeek Harness installed:

  npm i -g @deepseek-ai/dsh

Install

From GitHub:

dsh plugin --profile web add github:TinyAlmond/Airu/dsh-plugin-airu

From source (local development):

git clone https://github.com/TinyAlmond/Airu.git
cd Airu/dsh-plugin-airu
pnpm install
pnpm build
cd ..
dsh plugin --profile web add "link:./dsh-plugin-airu"

Usage

dsh --profile web

Open http://127.0.0.1:3080 in your browser. The Felyne pet will appear in the bottom-left corner, draggable to any position. It automatically switches to a wave animation when the AI is responding.

Uninstall

dsh plugin --profile web remove dsh-plugin-airu

Tauri Desktop App

A standalone transparent borderless desktop pet for macOS and Windows.

Prerequisites

• Node.js >= 18
• Rust >= 1.77.2
• pnpm

Development

git clone https://github.com/TinyAlmond/Airu.git
cd Airu
pnpm install
pnpm tauri dev

Features

• Transparent always-on-top window
• Pixel-art Felyne with idle/walk/sleep/talk/blink animations
• Drag to move anywhere on screen
• AI chat via DeepSeek API (click pet to open input)
• System tray menu

Build

pnpm tauri build

Produces .dmg (macOS) or .msi (Windows) in src-tauri/target/release/bundle/.

License

MIT