Wingman

Your private, on-device dating coach powered by local AI.

What is Wingman?

A micro-app that runs 100% on your device - no cloud, no data sharing. Just you and a local AI wingman helping you navigate dating conversations.

Core Flow

┌──────────────────────┐         ┌──────────────────────────────┐
│  Dating Apps         │         │      Wingman App             │
│  (Tinder, Bumble,    │         │                              │
│   Hinge, etc.)       │         │  ┌────────────────────────┐  │
│                      │         │  │    Tactical HUD        │  │
│  ┌────────────────┐  │         │  │                        │  │
│  │  Conversation  │──screenshot─►│  • Analyze convo       │  │
│  │  with Match    │  │         │  │  • Strategic advice    │  │
│  └────────────────┘  │         │  │  • Translate (EN↔ES)   │  │
│         ▲            │         │  │  • Generate response   │  │
│         │            │         │  │  • [COPY]              │  │
│      paste           │         │  └────────────────────────┘  │
│         │            │         │             │                │
│  ┌──────┴─────────┐  │         │             ▼                │
│  │  Send Message  │◄─copy──────│  ┌────────────────────────┐  │
│  └────────────────┘  │         │  │      Dossier           │  │
│                      │         │  │  (Intel on each match) │  │
└──────────────────────┘         │  │  • Name, age, facts    │  │
                                 │  │  • Wingman's notes     │  │
                                 │  │  • Conversation history│  │
                                 │  └────────────────────────┘  │
                                 └──────────────────────────────┘

Screens

Screen	Purpose
Home	Dashboard with your matches/targets
Tactical HUD	Chat with Wingman - share screenshots, get advice
Dossier	Per-person profile with notes and intel
Settings	Model download and preferences

Features

🤖 On-Device AI (5 Curated Models)

Model	Context	Capabilities
Gemma 3n E2B 📷	32K	Vision + Audio + Tools
DeepSeek R1 🧠	32K	Reasoning + Thinking + Tools
Phi-4 Mini 🔬	128K	Best context window + Tools
Gemma 3 1B 💎	32K	Recommended chat quality
Qwen 2.5 1.5B 🌍	32K	Multilingual + Tools

🔒 100% Private

• All AI runs on-device via LiteRT (MediaPipe).
• No data leaves your phone. No accounts. No cloud.

🎯 Strategic Coaching

• Emotional intelligence insights & pattern tracking.
• Cultural translation (Latino/Slang context).
• "WINGMAN" persona: Direct, WITTY, and honest.

Tech Stack

• Flutter - Cross-platform UI.
• flutter_gemma - On-device inference engine.
• LiteRT (TFLite) - Modern edge ML runtime.
• Hive - Secure local database for dossier intel.
• Riverpod - Enterprise state management.

Getting Started

Prerequisites

• iOS 17.2+ (Recommended for best LiteRT support).
• 4GB+ RAM (8GB+ for Heavyweight models).
• ~3GB free storage.

Setup

1. Clone the repo and run flutter pub get.
2. Ensure you have your HF_TOKEN in a .env file.
3. Launch the app and head to Settings.
4. Download Gemma 3 1B ⭐ (Recommended) for the best balance of speed and vibe.

Architecture

lib/
├── main.dart              # App entry, routing
├── screens/
│   ├── home_screen.dart       # Dashboard
│   ├── tactical_hud_screen.dart   # Chat with AI
│   ├── dossier_screen.dart    # Target profiles
│   └── settings_screen.dart   # Model & prefs
├── services/
│   ├── llm_service.dart       # Gemma 3n E2B wrapper
│   └── speech_service.dart    # Voice input/output
└── models/
    └── model_config.dart      # AI model config

Future Ideas

• Screenshot detection/auto-import
• Dating app integrations (if APIs available)
• Multi-language expansion
• Profile photo analysis
• Voice conversation mode

---

Built with ❤️ for nerds who want to level up their dating game.