Playa-0v0/Cyrene-Agent

git clone https://github.com/Playa-0v0/Cyrene-Agent.git && cd Cyrene-Agent
npm ci (or npm install)
npm run build:screenshot-helper && npm run build && npm start (builds Rust native screenshot helper, then Electron app)
Windows users can run setup.bat / start.bat; packaged releases in GitHub Releases don't need Rust/VS Build Tools
Optional: download BGE-M3 embedding model from Releases; optional music feature needs uv and NetEase Cloud Music desktop client

Usage

• •Prerequisites: Windows 10/11 64-bit, Node.js 24 LTS, npm 10+, Rust stable and Visual Studio 2022 Build Tools (source builds only)
• •After launch, click the tray icon -> Settings to configure the LLM provider (API key, Base URL, model) - required for chat; optional TTS (Mossland/MiniMax/MiMo/GPT-SoVITS), ASR (Aliyun), and Feishu/WeChat iLink channels
• •Five modes: Chat (pure character chat), Work (full agent workflow with tool calls), Code (Cline-based coding agent bound to a trusted directory), Learn (Obsidian Vault tutoring), Daily (general tool sessions)
• •MCP extension ecosystem supports stdio/SSE/HTTP transports, managed in settings

Key features

• ✓Live2D desktop companion: pinned desktop pet, expressions, actions, moods, chat bubbles, sticker semantic matching (needs BGE-M3)
• ✓Work mode uses LangGraph StateGraph with CITA -> Action Gate -> Native FC -> Execution Policy -> Tool Runtime -> Soul trusted execution chain; code verification loops
• ✓Personalized memory: L0/L1/L2 layered memory, DMAE Worldbook, relationship profile; RAG knowledge base (experimental) with hybrid vector+BM25 retrieval and reranker
• ✓Voice interaction: multi-engine TTS, real-time ASR (Aliyun), full voice calls with VAD silence detection
• ✓Multi-channel access: desktop, Feishu (Lark) WebSocket, WeChat iLink (experimental); proactive chat with do-not-disturb policy

Best for

Honkai: Star Rail fans on Windows who want an AI-powered Live2D desktop companion that also does real agent work, coding, and learning accompaniment.

Caveats

• ⚠Windows 10/11 is the primary tested platform; macOS and Linux are not fully verified (transparent windows, mouse-through, window layers may have issues)
• ⚠Most credentials stored in plaintext in <userData>/ (model-settings.json, app-settings.json, weixin credentials, mcp-servers.json); Feishu and NetEase music use Electron safeStorage; not recommended on shared/untrusted machines
• ⚠Unofficial fan work - no affiliation with HoYoverse; character IP, Live2D models, and art assets are not MIT-licensed and derivatives are prohibited for commercial use
• ⚠Local/unknown model endpoints only get generic D-tier compatibility - not guaranteed to work with Structured Output or Function Calling
• ⚠RAG, WeChat iLink, MCP ecosystem, and proactive chat are marked experimental
• ⚠MCP third-party server stability depends on each server's implementation