What is Desktop Homunculus?
Desktop Homunculus is a cross-platform desktop mascot application built with the Bevy game engine. It features VRM-based character creation, WebView-based UI overlays, and high extensibility through a MOD system.
Key Features
- VRM 3D character rendering — Characters render on your desktop, blending seamlessly with your workspace
- MOD system — Install and create MODs to add characters, animations, sound effects, UI panels, and custom behaviors. MODs are npm packages managed with pnpm
- AI integration via MCP — Connect AI assistants (such as Claude) to control your character through the Model Context Protocol (MCP) server
- WebView-based UI overlays — Settings panels, context menus, and custom UIs are React apps rendered inside the engine via Chromium Embedded Framework (CEF)
- Extensible TypeScript SDK — The
@hmcs/sdkpackage gives MOD developers control over characters, WebView UI, audio, and settings
What is VRM?
VRM is an open file format for 3D humanoid avatars. Desktop Homunculus uses VRM 1.0 models as its character format. You can create VRM models with tools like VRoid Studio or find them on platforms like VRoid Hub.
What You Need
| Requirement | Version |
|---|---|
| OS | macOS 12+ / Windows 10+ |
| Node.js | 22 or later |
| pnpm | 10.x |
Alpha Status
Desktop Homunculus is currently in alpha. APIs and MOD specifications may change between releases. We welcome feedback and contributions.
Next Steps
- Installation — Download the app and set up your MOD environment
- Quick Start — Get up and running in minutes: configure settings, interact with your character, and explore official MODs
- MOD Development — Build your own MODs with the TypeScript SDK
- AI Integration — Connect AI assistants to your character via MCP