Irori

Your local-first anime AI companion that actually gets work done.

Irori is a local-first desktop companion app built around the Pi coding-agent SDK. It turns agent sessions into character-driven companions: each character has a card, personality, memory surface, model settings, and a workflow role that can help you think, write, code, plan, and follow through.

中文说明

Highlights

• Character companions. Use bundled characters or create your own character cards. A companion can have a distinct voice, backstory, working style, avatar, and prompt composition.
• Workflow support. Characters are designed to understand task context, break down requirements, track progress, organize conclusions, and work like focused collaborators.
• Local memory and context. Preferences, important project details, and collaboration habits can be kept locally so repeated conversations need less setup.
• Model provider presets. The desktop app includes preset provider/model options and OpenAI-compatible configuration fields for common model services.
• Desktop-first experience. Irori is a Tauri + React app with a native desktop shell, local sidecar runtime, safety confirmation gate, and multilingual onboarding.
• Customizable role cards. Swap, edit, or create character cards with your favorite original characters, personas, or working partners.

How Irori Compares

There are great tools for chatting with characters and for talking to a desktop waifu. Irori's difference is that the companion gets work done — it runs on an agent runtime, keeps local memory, and ships as a native desktop app.

	Irori	SillyTavern	Open-LLM-VTuber	OpenClaw
Primary focus	Anime companion that does real work	Roleplay & chat frontend	Voice-interactive VTuber companion	General coding / automation agent
Native desktop app	✅ Tauri shell	⚠️ Local web UI	⚠️ Web / desktop	⚠️ Terminal / CLI-first
Agentic work (write · code · plan · follow-through)	✅ Tuned for code & complex tasks	❌ Chat only	❌ Chat only	✅ General agent
Anime character companion	✅ Core experience	✅	✅	❌
Character cards	✅ Editable schema + prompt composition	✅	✅	❌
Local memory & context	✅ Built-in, local-first	✅ Lorebook / world info	✅	✅
Tool use & safety gate	✅ Confirmation policy + protected paths	❌	❌	✅ Tool use
Voice / Live2D avatar	🔜 On the roadmap	⚠️ Via extensions	✅ Core feature	❌
Multi-channel integrations (Discord, etc.)	🔜 On the roadmap	⚠️ Via extensions	⚠️	⚠️
Companion mobile app	🔜 On the roadmap	⚠️ Mobile browser	⚠️ Mobile browser	❌
Best for	A companion that helps you think, write, and ship	Immersive roleplay	Talking to a desktop waifu	Headless task automation

These are all good tools in their own lanes: SillyTavern for immersive roleplay, Open-LLM-VTuber for a talking Live2D avatar, OpenClaw for headless automation. Irori's niche is pairing a real anime character companion with an agent tuned for code and complex tasks in a native desktop app — with channel integrations and a mobile app on the roadmap.

Roadmap

• Multi-channel access — bring your companion into channels like Discord and other chat surfaces.
• Companion mobile app — keep the same character, memory, and workflow on your phone.
• Voice & Live2D — give companions a face and a voice.

Screens and Flow

Irori starts with a short onboarding flow:

1. Choose the interface language.
2. Meet the companion concept and the role-card system.
3. Select or configure a model provider.
4. Start a local companion workspace.

The app currently includes character assets and cards for several bundled companions, plus package-level tooling for deterministic card parsing and prompt composition.

Workspace

apps/
  desktop/          Tauri + React desktop shell
    src/            React frontend: chat, onboarding, settings, character UI
    src-tauri/      Rust backend for the desktop app
    sidecar/        Node sidecar embedding the Pi SDK runtime
characters/         Bundled character card packages
packages/
  character-card/   Character card schema and prompt composition
  companion-core/   Shared companion session domain types
  memory/           Local-first memory contracts and backends
  pi-runtime/       Adapter layer for Pi SDK sessions and events
  safety/           Tool modes, confirmation policy, protected paths
  ui/               Shared UI surfaces
docs/               Project notes and implementation docs

Getting Started

Prerequisites:

• Node.js 22+
• pnpm
• Rust toolchain for Tauri desktop builds

Install dependencies:

pnpm install

Run the desktop app in development mode:

npm run dev

Useful scripts:

npm run desktop:vite   # Frontend only, Vite dev server on 127.0.0.1:1420
npm run desktop:build  # Production desktop build through Tauri
npm test               # Character-card package tests

Model Setup

Irori supports provider presets in the desktop settings and onboarding flow. You can also configure an OpenAI-compatible provider manually with:

• Base URL
• Model name
• API key

Do not commit personal API keys or local secrets to the repository.

Character Cards

Bundled character cards live in characters/ and are mirrored under apps/desktop/public/characters/ for the desktop app. The card tooling lives in packages/character-card/.

A character card is where Irori keeps the role definition: identity, style, skills, prompt fragments, and assets. This makes companions replaceable and editable instead of being hard-coded into the app.

Testing

npm test

cd apps/desktop/sidecar
node --test test/*.mjs

cd apps/desktop
npm run typecheck

License

Licensed under the Apache License, Version 2.0.