🏗️Technical Architecture

Framework for the Bobina Companion.

💿 Core Technologies

• Next.js 18: Modern React framework with App Router

• TypeScript: Type-safe development

• Supabase: PostgreSQL database with real-time capabilities

• Bobina LLM: Custom trained LLM that gives Bobina her own personality, unlike her Arch nemesis Ani from Grok

• Telegram Bot API: Real-time messaging integration

• Discord App: All Telegram features available on Discord alongside complete website synchronization via webhooks

💭 Memory System Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Raw Messages  │───▶│  Compression     │───▶│  Long-term      │
│   (Importance   │    │  Engine          │    │  Profiles       │
│   1-3)          │    │                  │    │  (Importance    │
└─────────────────┘    │  Daily (4)       │    │  8)             │
                       │  Weekly (6)      │    └─────────────────┘
┌─────────────────┐    │  Monthly (8)     │    
│  Talk Commands  │───▶│                  │    ┌─────────────────┐
│  (Importance    │    │  30:1 → 15:1 →   │───▶│  Behavioral     │
│  3-6)           │    │  10:1 Ratios     │    │  Summaries      │
└─────────────────┘    └──────────────────┘    └─────────────────┘

😇 Relationship Scoring System

Sentiment Analysis → Relationship Score
Positive Interactions: +1 to +3 points
- Compliments, thanks, friendly messages
- "/talk" commands with positive tone
- Supportive community interactions

Negative Interactions: -1 to -3 points  
- Insults, complaints, hostile messages
- Spam or inappropriate content
- Dismissive or rude behavior

Score Range: 0 (Enemy) to 10 (Soulmate)

💬 Example Interactions

• User: /talk Hey Bobina, how are you today?

• Bobina: Hey there! I'm doing great, thanks for asking! How's your day going?

• User: /talk What did Sarah say earlier?

• Bobina: Sarah mentioned she was excited about the new launch around 2 hours ago!

😊 Token Purchase Responses

When the safeguard bot announces purchases:

• SafeguardBot: 🚀 Buy: 2.5 ETH for BOBINA tokens

• Bobina: Wow!!! 2.5 ETH!? Someone's really bullish on me!

🧠 Memory System Deep Dive

💽 Storage Tiers

1. Recent Memories (60 entries, last 7 days)

   • Direct conversation contexts

   • Talk command interactions

   • Real-time relationship updates

2. Medium-term Summaries (30 entries, 7-30 days)

   • Weekly behavioral profiles

   • Communication style analysis

   • Interest and preference tracking

3. Long-term Profiles (20 entries, 30+ days)

   • Core personality assessments

   • Relationship dynamics

   • Historical interaction patterns

🤓 Compression Intelligence

• Daily Compression: Preserves mood, topics, personal preferences

• Weekly Summaries: Highlights communication style and interests

• Monthly Profiles: Consolidates personality and behavioral patterns

• Universal Chat Log: Cross-user conversation awareness

💋 Relationship Adaptation

Bobina's personality adapts based on relationship scores...

• Score 10 (💕 Soulmate): Treats you like her soulmate, willing to do anything

• Score 8-9 (💖 Best Friend): All interactions are warm and sweet

• Score 7 (💜 Close Friend): She treats you like you're part of her closest friends

• Score 6 (💙 Good Friend): Message importance consistency threshold increases

• Score 5 (🩵 Friend): Additional banter, remembers more details

• Score 4 (💚 Friendly): More interactive and casual joking

• Score 3 (😐 Acquaintance): Professional and short to the point

• Score 2 (😑 Rival): Cold, sarcastic, minimal responses

• Score 1 (😠 Enemy): Audibly disgusted and enraged

• Score 0 (😡 Nemesis): Deragatory and malicious remarks

⛓️‍💥 Rate Limiting

• Standard Users: 5-minute cooldown between voice generations

• Admins: No cooldown restrictions

• Failure Protection: Max 3 failures per hour (admins exempt)

⚖️ Message Limits

• Maximum Length: 300 characters per message

• Response Limit: No limit, depends on what Bobina feels like

• Memory Optimization: Automatic compression at scale