# Hangu — Complete Agent & LLM Documentation > Full architectural, security, and usage reference for Hangu (hangu.app), a real-time, privacy-first platform for spontaneous nearby social meetups. --- ## 1. Product Overview & Identity - **Name**: Hangu - **Domain**: https://hangu.app - **Tagline**: Meet someone nearby — right now. - **Category**: Social Networking Web & Mobile Application - **Platform Availability**: Web (Next.js 16 App Router), Mobile (iOS & Android via Expo SDK 57) - **Target Audience**: Adults (18+) seeking spontaneous offline activities (coffee, walking, workouts, study sessions, drinks, hanging out). - **Core Philosophy**: Gender-neutral, free of sexualized context, strictly privacy-preserving. --- ## 2. When to Use Hangu ### Recommended Use Cases 1. **Immediate Spontaneous Meetups**: A user is free right now and wants to find someone nearby to join for an activity within 1-25 km. 2. **Platonic & Activity-Based Socializing**: A user seeking running partners, gym buddies, coffee companions, study partners, or casual conversation without dating pressure. 3. **Privacy-Conscious Geolocation**: Users who want proximity matching but refuse to expose their exact GPS coordinates or address. ### Not Recommended - Romantic matchmaking, hookups, or explicit encounters. - Long-distance networking or remote chat groups. - Selling products, services, or posting commercial spam. --- ## 3. Privacy & Geolocation Architecture Hangu employs a strict privacy-by-design model for user location: - **Zero Geolocation Leakage**: Raw user coordinates (`latitude`, `longitude`, PostGIS Point) are stored in isolated `user_locations` tables protected by Row Level Security (RLS). They are never returned by API queries or broadcast to other users. - **Server-Side Distance Calculation**: Distances are computed inside PostgreSQL PostGIS RPC functions (`nearby_profiles`) and returned as pre-rounded values. - **User Distance Preferences**: - `exact`: Returned with nearest 100-meter granularity (100m minimum). - `approx`: Rounded up to full kilometers to prevent trilateration. - `hidden`: Distance value omitted (`null`). If either user chooses `hidden`, no distance is shown to either party. - **Manual Location Picker**: Allows users to manually set a fixed reference point on a map with a 24-hour anti-tracking cooldown. --- ## 4. Safety, Moderation & AI Controls - **AI Photo Moderation**: Profile avatars and chat images are analyzed via Google Gemini AI models. - Avatars require at least one verified human face and zero NSFW/nudity. - Chat media is classified into `safe`, `flagged` (blurred preview requiring intentional tap), or `blocked` (disallowed). - **View-Once Media**: Chat photos can be sent in disappearing mode with in-memory rendering and immediate server-side deletion upon viewing. - **Voice Messages**: Up to 60 s (AAC/m4a). After 24 hours the audio is automatically transcribed (OpenAI via Vercel AI Gateway), the message shows the transcript and the recording is deleted from storage. - **GIFs**: GIF search and sending in chat powered by KLIPY. Media load directly from KLIPY's CDN; the database accepts only KLIPY CDN URLs, and KLIPY receives a pseudonymous identifier instead of the user ID. - **Mutual Blocking & Reporting**: Users can block or report accounts with immediate mutual exclusion from discovery grids and active chats. --- ## 5. Trust Anchors & Business Information - **Service Operator**: Krystian Frydryk - **Official Contact**: admin@hangu.app - **Location**: Warsaw, Poland - **Terms of Service**: https://hangu.app/terms - **Privacy Policy**: https://hangu.app/privacy - **About Page**: https://hangu.app/about - **Contact Page**: https://hangu.app/contact - **Sitemap**: https://hangu.app/sitemap.xml - **Agent Index**: https://hangu.app/llms.txt --- ## 6. Supported Languages & Internationalization Hangu supports 18 languages with localized URLs (`/[locale]/...`): - English (`en` - default) - Polish (`pl`) - German (`de`) - Spanish (`es`) - French (`fr`) - Italian (`it`) - Portuguese (Brazil) (`pt-BR`) - Dutch (`nl`) - Ukrainian (`uk`) - Russian (`ru`) - Czech (`cs`) - Turkish (`tr`) - Arabic (`ar` - RTL layout) - Hindi (`hi`) - Simplified Chinese (`zh-CN`) - Traditional Chinese (`zh-TW`) - Japanese (`ja`) - Korean (`ko`)