패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소hsoyal-dot/Utavine

Utavine

Wear OS의 실시간 심박수를 기반으로 곡을 추천하는 AI 기반 음악 앱. 감정 감지에 Gemini AI를 사용하고, 개인화된 음악 추천에는 Spotify API를 활용합니다.

Utavine 프로젝트 이미지
스타
1
포크
0
최근 푸시(UTC)
2026. 2. 13.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

Utavine: Mood-based Music App

Utavine is an AI-powered smart music app that recommends music based on your real-time heart rate (from Wear OS smartwatches). By analyzing your BPM through a companion app, VineHeart, and generating mood keywords using Gemini, it provides personalized music experiences.


📱 Features

  • 🔒 Firebase Authentication for user login
  • ❤️ Real-time Heart Rate tracking via VineHeart (WearOS companion app)
  • 🧠 Gemini API to generate mood keywords based on heart rate
  • 🎧 Spotify API integration to search & recommend songs
  • ☁️ Supabase for storing user-specific heart rate data
  • 🌐 Flutter + Dart + Firebase Auth + Supabase

💭 How It Works

  1. Heart Rate Tracking: VineHeart (a Wear OS app) tracks heart rate using SensorManager.
  2. Supabase Sync: Every 60s, it pushes the data (bpm, timestamp, user_id) to Supabase.
  3. User Login: Users log into Utavine using Firebase Authentication.
  4. Fetch BPM: Utavine fetches the latest BPM using the logged-in Firebase UID.
  5. AI Mood Matching: Gemini API converts BPM into keywords (e.g., "calm", "focus").
  6. Spotify Suggestions: Spotify API returns song suggestions for those keywords.

🧱 Tech Stack

Layer Tech
UI Flutter
Mobile Companion VineHeart- Kotlin-based Wear OS App
Backend Dart, Node.js
Auth Firebase
Database Supabase (PostgreSQL)
AI Google Gemini API
Music Spotify API

📂 Folder Structure (Flutter)

utavine/
├── lib/
│   ├── data/
│   │   ├── models/
│   │   └── sources/
│   │       ├── api/
│   │       └── services/
│   ├── presentation/
│   │   └── vine_sense/
│   │       ├── bloc/
│   │       └── screens/
│   └── main.dart
└── .env

⚙️ Setup

🧩 Firebase Auth (Shared by both apps)
  1. Set up Firebase project.
  2. Enable Email/Password sign-in method.
  3. Add google-services.json to both apps.
  4. Ensure firebase_core & firebase_auth are initialized in both apps.
📲 VineHeart (Wear OS App)
  1. Uses SensorManager to read heart rate.
  2. Pushes data to Supabase via REST using OkHttp.
  3. Requires .env setup inside local.properties:
    SUPABASE_URL=https://your-instance.supabase.co/rest/v1
    SUPABASE_API_KEY=your-key
    
🌐 Utavine Mobile App
  1. Uses Firebase Auth for login/signup.
  2. Reads user UID to fetch bpm data from Supabase.
  3. Converts BPM to keywords via Gemini.
  4. Fetches Spotify songs.
.env (for Utavine)
SUPABASE_URL=https://your-instance.supabase.co/rest/v1
SUPABASE_API_KEY=your-key
SPOTIFY_BASE_URL=http://localhost:3000
GEMINI_API_KEY=your-gemini-key

🚀 Roadmap

  • [x] Real-time HR sync via VineHeart
  • [x] Firebase Auth login for both apps
  • [x] Gemini keyword mapping
  • [x] Spotify integration
  • [ ] UI/UX polish for VineSense screen
  • [ ] Add playlists and like/save feature
  • [ ] Push notifications for mood-based music

👤 Author

Hemraj Soyal (MCA Student at Vellore Institute of Technology)


Hemraj Soyal GitHub avatar
GitHub 작성자

Hemraj Soyal ↗

언어DartC++CMakeRubySwiftJavaScriptCHTMLKotlinObjective-C

분류

사용 중인 의존성

의존성 목록 17 개

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗