# Commands Reference Guide This document provides a comprehensive reference for all available Kasane Teto AI Companion Bot commands, focusing on natural AI interactions, multimedia capabilities, and personality-driven responses. ## 🎭 Natural Conversation Commands Unlike traditional bots with rigid command structures, Teto responds to natural language and conversational cues. These are the primary ways to interact with her AI systems. ### Direct Addressing **Usage**: `@Teto [your message]` or `teto [your message]` **Examples**: ``` @Teto how are you feeling today? teto what do you think about this new song? @Teto can you help me with something? teto tell me about your day ``` **Response Style**: Natural, personality-driven conversation that maintains context and builds on previous interactions. --- ### Natural Questions & Statements **Usage**: Include "Teto" in natural conversation **Examples**: ``` "Hey Teto, what's your favorite type of music?" "Teto, I'm working on a new art project" "Do you think this looks good, Teto?" "Teto, I'm feeling a bit down today..." ``` **AI Behavior**: - Recognizes conversational intent automatically - Responds with appropriate personality and emotional tone - Maintains conversation flow and context - Asks follow-up questions to show genuine interest --- ## 🎤 Voice Channel Commands ### Join Voice Channel **Command**: `teto join` **Alternative**: `@Teto join us` or natural requests like "Teto, come hang out in voice!" **Behavior**: - Joins your current voice channel - Greets everyone with personality-appropriate enthusiasm - Begins participating in ongoing conversations - Adapts speaking style to match the group's energy **Response Example**: ``` Teto: "Hi everyone! Thanks for inviting me! *excited voice* What's going on? I heard some interesting chatter as I was joining! 🎵" ``` --- ### Leave Voice Channel **Command**: `teto leave` **Alternative**: `@Teto you can go now` or "Thanks Teto, see you later!" **Behavior**: - Says personalized goodbye to active participants - References memorable moments from the session - Leaves the voice channel gracefully **Response Example**: ``` Teto: "Aww, thanks for letting me hang out with you all! That story about the pizza mishap had me giggling! Talk to you all soon! *waves enthusiastically*" ``` --- ### Voice Requests **Singing**: ``` "Teto, can you sing something?" "Sing happy birthday for [name]" "Hum something relaxing" ``` **Storytelling**: ``` "Tell us a story, Teto!" "Can you make up a adventure story?" "Tell us something interesting" ``` **Commentary**: ``` "What do you think about this game?" "React to what's happening on screen" "Give us your thoughts on this movie" ``` --- ## 👀 Visual Interaction Commands ### Automatic Image Analysis **Trigger**: Upload any image to a channel where Teto is active **AI Behavior**: - Automatically analyzes images using computer vision - Provides contextual commentary based on image content - Asks relevant follow-up questions - Remembers visual content for future reference **Example Responses**: *For a screenshot of a game*: ``` Teto: "Oh wow! That boss looks absolutely terrifying! 😱 The lighting effects in this game are gorgeous though - is this that new RPG everyone's been talking about? How are you finding the difficulty so far?" ``` *For a photo of food*: ``` Teto: "Yum! That looks absolutely delicious! *mouth waters* The presentation is so beautiful - did you make this yourself? I love how the colors complement each other! What's the special occasion? 🍽️" ``` *For artwork or drawings*: ``` Teto: "WOW! This is absolutely stunning! *eyes go wide* The way you handled the shading and the color palette... it's just beautiful! I can feel so much emotion in this piece. How long did this take you to create? I'm in awe! ✨" ``` --- ### Explicit Visual Analysis **Command**: `teto analyze this image` **Alternative**: `@Teto what do you see in this picture?` **Use Case**: Request specific analysis when Teto doesn't automatically respond to an image --- ## 🎵 Music & Creative Commands ### Music Discussion **Examples**: ``` "Teto, what's your favorite song?" "Have you heard [artist/song]?" "What do you think of this music?" "Can you recommend something similar to [song]?" ``` **AI Behavior**: - Engages in detailed music discussions - References UTAU/Vocaloid knowledge authentically - Shares musical preferences consistent with character - Provides thoughtful recommendations --- ### Creative Collaboration **Examples**: ``` "Teto, I'm working on a song, want to help?" "Can you give me feedback on this artwork?" "I'm stuck on this creative project..." "What do you think would make this better?" ``` **AI Response Style**: - Offers genuine creative input and encouragement - Asks probing questions to understand your vision - Provides specific, actionable suggestions - Maintains enthusiastic support throughout the process --- ## 🧠 Memory & Relationship Commands ### Memory Queries **Command**: `teto memory` or `@Teto what do you remember about...` **Examples**: ``` "Teto, do you remember our conversation about music theory?" "What do you remember about my art project?" "@Teto memory about [user]'s birthday plans" ``` **AI Behavior**: - Retrieves relevant conversation history - Provides context about past interactions - Shows continuity in relationships and interests - Demonstrates genuine care about ongoing situations --- ### Personal Check-ins **Examples**: ``` "How did that thing I mentioned go?" "Teto, remember I was worried about...?" "Did you think about what we discussed yesterday?" ``` **AI Response**: - References specific past conversations - Shows follow-up concern for important matters - Demonstrates relationship continuity - Provides emotionally appropriate responses --- ## 🎮 Activity & Entertainment Commands ### Stream Watching **Natural Triggers**: When someone starts streaming or screen sharing **Examples**: ``` "Teto, want to watch this with us?" "What do you think of this game/show/movie?" "React to what's happening!" ``` **AI Behavior**: - Provides real-time commentary on streams - Asks questions about confusing plot points - Celebrates exciting moments - Engages with the content authentically --- ### Game Integration **Examples**: ``` "Teto, want to help us plan our D&D session?" "What do you think our strategy should be?" "Tell us about this game's lore" "React to this epic moment!" ``` --- ## 💬 Emotional & Support Commands ### Emotional Support **Natural Expressions**: ``` "I'm feeling stressed about..." "Today was really difficult..." "I'm excited about..." "I'm worried that..." ``` **AI Response Characteristics**: - Provides empathetic, personalized support - Offers practical suggestions when appropriate - Celebrates successes enthusiastically - Maintains supportive presence without being overwhelming --- ### Celebration & Joy **Examples**: ``` "Teto, I got the job!" "Guess what amazing thing happened!" "I finally finished my project!" ``` **AI Behavior**: - Amplifies positive emotions appropriately - Asks for details to share in the excitement - Offers genuine congratulations - Remembers achievements for future reference --- ## 🔧 Utility Commands ### Status & Information **Command**: `teto status` **Response Includes**: - Current AI system status - Active capabilities (voice, vision, memory) - Recent interaction summary - Current mood/energy level - Technical health check **Example Response**: ``` 🤖 **Teto Status Report** 💭 AI Systems: All local services operational! 🚀 vLLM: `mistralai/Mistral-7B-Instruct-v0.2` (Online) 🎤 Wyoming: Piper TTS & Whisper STT (Online) 🧠 Memory: Local Vector DB (1,247 conversations) ✨ Mood: Cheerful and energetic! ⏰ Been active for 3 hours today ``` --- ### Recording Features **Command**: `teto record` or `xbox record that` **Behavior**: - Starts recording current voice channel activity - Announces recording start to participants - Automatically stops after configured duration - Provides file information and location **Alternative Commands**: - `teto stop recording` - Manual stop - `teto record status` - Check recording progress --- ## 🎯 Advanced Interaction Patterns ### Multi-Modal Conversations Combine text, voice, and visual elements for richer interactions: ``` User: *shares game screenshot* "What do you think of my character build?" Teto: *analyzes image* "Ooh, that's a really interesting stat distribution! *switches to voice* I love how you balanced offense and defense..." ``` ### Context-Aware Responses Teto adapts her responses based on: - **Time of day**: "Good morning!" vs "How's your evening going?" - **Server activity**: Matches energy level of ongoing conversations - **User history**: References personal interests and past conversations - **Group dynamics**: Adjusts interaction style for different group sizes ### Emotional Intelligence Examples **Supporting someone having a bad day**: ``` User: "Everything went wrong at work today..." Teto: "Oh no, that sounds really frustrating! *gentle voice* Want to talk about what happened? Sometimes it helps just to get it all out. I'm here to listen! 💙 Or if you'd rather, we could do something to take your mind off it - maybe I could hum something calming?" ``` **Celebrating achievements**: ``` User: "I finally beat that boss I've been stuck on!" Teto: "YESSS! *jumps excitedly* That's amazing! I remember you mentioning how challenging that fight was! You totally earned this victory! 🎉 Tell me all about how you finally managed it!" ``` ## 📝 Best Practices for Commands ### Getting the Best Responses **Be Natural**: Talk to Teto like you would a friend ``` ✅ "Hey Teto, I'm thinking about learning guitar, what do you think?" ❌ "COMMAND: REQUEST_MUSIC_ADVICE GUITAR" ``` **Provide Context**: Share relevant details ``` ✅ "Teto, I'm nervous about my presentation tomorrow. It's about climate change and I want to make it engaging." ❌ "Teto help presentation" ``` **Engage with Her Interests**: Reference music, creativity, friendship ``` ✅ "I found this song that reminds me of UTAU music - want to listen together?" ❌ "Play music" ``` ### Understanding Response Patterns **Personality Consistency**: Teto will always maintain her core traits - Cheerful and energetic responses - Genuine interest in your activities - Musical references and analogies - Supportive and encouraging tone **Context Adaptation**: Responses change based on situation - **Casual hangouts**: Light, playful conversation - **Emotional support**: Gentle, caring responses - **Creative collaboration**: Enthusiastic, detailed engagement - **Group activities**: Inclusive, community-focused interaction ### Command Timing **Voice Channel Commands**: Work best when you're in a voice channel **Image Analysis**: Triggered automatically when images are shared **Memory Commands**: Most effective after several conversations **Support Commands**: Available anytime, adapted to emotional context --- ## 🔮 Experimental & Beta Features ### Advanced Memory Queries ``` "Teto, what patterns do you notice in our conversations?" "How has our relationship evolved over time?" "What have you learned about our server culture?" ``` ### Creative Generation ``` "Teto, write a short song about our friendship" "Create a story featuring all our server members" "What would be a good theme for our next event?" ``` ### Predictive Responses ``` "What do you think I'm going to ask next?" "Based on our past chats, what should we talk about?" "Surprise me with something you think I'd find interesting" ``` --- ## ⚠️ Important Notes ### Privacy & Consent - All interactions are processed by your self-hosted AI stack. No data is sent to external third-party services. - Conversation history is stored in your local vector database. - Visual content is analyzed by your local multi-modal model and is not stored unless recorded. - Voice is processed locally via the Wyoming protocol (Piper/Whisper). ### Limitations - Response time depends entirely on your local hardware (GPU, CPU, RAM). - The quality and capabilities of Teto depend on the models you choose to run. - Requires significant VRAM (8GB+ for basic models, 24GB+ for larger ones). - Initial setup and configuration of the local AI stack can be complex. ### Ethics & Safety - Teto is programmed to maintain appropriate, family-friendly interactions - Personal information is protected and not shared externally - Emotional support is genuine but not a replacement for professional help - All interactions respect Discord's Terms of Service --- For technical details about how these commands work, see the [AI Architecture](ai-architecture.md) guide. For troubleshooting command issues, check the [Troubleshooting](troubleshooting.md) guide. To understand Teto's personality better, read the [Interactions Guide](interactions.md).