Skip to content

README.md

Latest commit

 

History

History
112 lines (91 loc) · 4.87 KB

README.md

File metadata and controls

112 lines (91 loc) · 4.87 KB

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.