teto_ai/docs/commands.md
Mikolaj Wojciech Gorski 44b45b7212 Major refactor: Transform into AI-powered Kasane Teto companion bot
🎭 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.
2025-07-26 13:08:47 +02:00

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 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

  • 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.