Vivi-Speech/.planning/PROJECT.md

Vivi Speech Translator

What This Is

A Discord bot that translates Vivi's emoji-based communication into text so her community understands what she's saying without prior knowledge. Works with PluralKit/Tupperbox to detect Vivi's messages, learns emoji meanings over time, and can be adopted by other plural systems with mute members who use emojis to communicate.

Core Value

Vivi posts emojis and others instantly understand her without needing to know what each emoji means.

Requirements

Validated

(None yet — ship to validate)

Active

• Bot detects Vivi's messages via PluralKit/Tupperbox integration
• Bot translates emoji sequences into natural language
• Bot learns new emoji meanings when taught (by Vivi or other alters)
• Bot can update/correct existing emoji meanings
• Translation mode can toggle between automatic and on-demand
• Unknown emojis are shown with meanings for known emojis only
• Bot works in Discord channels and DMs
• Emoji meanings are global across all servers
• Bot works in any Discord server without per-server installation friction
• Translation format adapts based on emoji sequences (natural language where possible)

Out of Scope

• Real-time learning from context (emoji meanings learned explicitly, not inferred)
• Voice/speech synthesis (text translation only)
• Mobile app (Discord bot only)
• Moderation or safety features beyond Discord's built-in tools
• Support for non-emoji communication methods (focus on emoji first)

Context

About Vivi:

• Vivi is mute and communicates through custom emoji sequences
• Vivi has Dysgraphia (writing difficulty), making emoji communication more accessible than text
• Vivi can read normally, so she understands text translations
• Vivi is one alter in a plural system; other alters can speak and help manage emoji meanings

Emoji Language:

• Emojis are compositional and read left-to-right, but meanings vary based on sequence
• Includes both standard emojis (😷, ❌) and custom server emojis (:me1:)
• Example: :me1:😷 2️⃣ 🍑 ❌ 🤧 = "Vivi is sick, but not in the sinuses"

Integration:

• Must integrate with PluralKit or Tupperbox to detect when Vivi is the active communicator
• These bots proxy messages through a shared account, but Vivi should be recognizable

Broader Vision:

• Initially built for Vivi's community
• Designed to be generalizable so other plural systems with mute members can adopt it
• Global emoji dictionary allows different systems to maintain their own emoji meanings

Constraints

• Platform: Discord bot only (no web, mobile, or other platforms)
• Integration: Must work seamlessly with PluralKit or Tupperbox
• Accessibility: Must be low-friction for Vivi and other alters to teach/update emoji meanings
• Multi-server: Should work in any Discord server without requiring complex per-server setup
• Global scope: Emoji meanings are global, not per-server (but per-server overrides could be added later)

Key Decisions

Decision	Rationale	Outcome
Global emoji dictionary	Vivi's emoji language is consistent across communities; other systems will benefit from shared knowledge	— Pending
Learning-based system	Vivi uses many emojis; manual mapping would be unsustainable. Bot learns when taught.	— Pending
Auto + on-demand modes	Auto is natural but can be noisy; on-demand is explicit but requires action. Both options respect server preferences.	— Pending
PluralKit/Tupperbox integration	These are standard plural system tools; integrating with them lets us detect Vivi's messages accurately	— Pending

---

Last updated: 2026-01-29 after initialization