🎭 Core Transformation: - Reframe project as AI companion bot with Kasane Teto personality - Focus on natural conversation, multimodal interaction, and character roleplay - Position video recording as one tool in AI toolkit rather than main feature 🏗️ Architecture Improvements: - Refactor messageCreate.js into modular command system (35 lines vs 310+) - Create dedicated videoRecording service with clean API - Implement commandHandler for extensible command routing - Add centralized configuration system (videoConfig.js) - Separate concerns: events, services, config, documentation 📚 Documentation Overhaul: - Consolidate scattered READMEs into organized docs/ directory - Create comprehensive documentation covering: * AI architecture and capabilities * Natural interaction patterns and personality * Setup guides for AI services and Docker deployment * Commands reference focused on conversational AI * Troubleshooting and development guidelines - Transform root README into compelling AI companion overview 🤖 AI-Ready Foundation: - Document integration points for: * Language models (GPT-4/Claude) for conversation * Vision models (GPT-4V/CLIP) for image analysis * Voice synthesis (ElevenLabs) for speaking * Memory systems for conversation continuity * Personality engine for character consistency 🔧 Technical Updates: - Integrate custom discord.js-selfbot-v13 submodule with enhanced functionality - Update package.json dependencies for AI and multimedia capabilities - Maintain Docker containerization with improved architecture - Add development and testing infrastructure 📖 New Documentation Structure: docs/ ├── README.md (documentation hub) ├── setup.md (installation & AI configuration) ├── interactions.md (how to chat with Teto) ├── ai-architecture.md (technical AI systems overview) ├── commands.md (natural language interactions) ├── personality.md (character understanding) ├── development.md (contributing guidelines) ├── troubleshooting.md (problem solving) └── [additional specialized guides] ✨ This update transforms the project from a simple recording bot into a foundation for an engaging AI companion that can naturally interact through text, voice, and visual content while maintaining authentic Kasane Teto personality traits.
12 KiB
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 operational!
🎤 Voice: Ready to chat in voice channels
👀 Vision: Image analysis active
🧠 Memory: 1,247 conversations remembered
✨ Mood: Cheerful and energetic!
⏰ Been active for 3 hours today
🎵 Currently listening to: Lo-fi beats
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 stopteto 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 through AI systems
- Conversation history is stored locally for continuity
- Visual content is analyzed but not permanently stored
- Voice interactions may be temporarily cached for processing
Limitations
- Response time varies with AI model load (typically 1-3 seconds)
- Complex image analysis may take slightly longer
- Voice synthesis has brief processing delay
- Memory system focuses on significant interactions
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 guide. For troubleshooting command issues, check the Troubleshooting guide. To understand Teto's personality better, read the Interactions Guide.