Skip to content

HyunkyuKim

Meaningful relationships are built on deep conversations.

Core trick

Records couple dialogue, has Gemini separate speakers and transcribe it, then answers questions over saved conversation history.

Tags

Description

Meaningful relationships are built on deep conversations. But many people struggle to have them naturally. Heart2Heart is a web app that helps couples have richer, more intentional conversations. It presents one thoughtful question at a time from curated card decks (including Arthur Aron's 36 Questions That Lead to Love), automatically records the dialogue, and uses Gemini to separate speakers, transcribe the conversation, and generate per-speaker and overall summaries. Every conversation is saved to a history log, and a Gemini-powered chat agent lets couples revisit and reflect on what they've shared; recalling specific answers, spotting patterns, or simply reliving a meaningful exchange.
minus31/heart2heart★ 00 forksTypeScriptCreated Feb 28, 2026 · last push Feb 28, 2026

README excerpt

# Hack Gemini3 Project

이 프로젝트는 Frontend(Next.js)와 Backend(FastAPI)로 구성되어 있습니다.
아래의 명령어를 통해 각각의 서버를 실행할 수 있습니다.

## 🖥 Frontend 실행 방법

Frontend는 `npm`을 패키지 매니저로 사용합니다.

```bash
cd frontend
npm install
npm run dev
```

- 로컬 서버: [http://localhost:3000](http://localhost:3000)

## ⚙️ Backend 실행 방법

Backend는 `uv`기반의 Python FastAPI 환경입니다. (API Key가 필요한 경우 `.env` 파일을 설정해주세요.)

```bash
cd backend
uv sync # (선택사항) 패키지 설치/동기화
uv run uvicorn main:app --reload
```

- 로컬 서버: [http://localhost:8000](http://localhost:8000) (기본 포트)
- Swagger API 문서: [http://localhost:8000/docs](http://localhost:8000/docs)

Team