토모토모 (Tomotomo)

내가 만든 캐릭터 친구와 이야기하며 언어를 익히는 앱. 대화는 기기 안의 AI가 처리하고, 첫 실행에서 모델을 한 번 받으면 그 뒤로는 인터넷 없이 동작합니다.

배우는 언어 일본어 · 한국어 · 영어 · 중국어 앱 화면 언어 한국어 · 日本語 · English · 中文

스크린샷

주요 기능

• 친구를 직접 만들기 — 이름·성격·말투·수준을 정하고, 친구마다 배울 언어를 따로 지정합니다. 기본 제공 친구도 수정하거나 삭제할 수 있습니다.
• 문장 해설 — 친구 말 옆의 ⓘ를 누르면 번역과 그 문장에서 뽑은 단어가 나옵니다.
• 단어장과 카드 복습 — 마음에 드는 표현을 담아 카드로 넘기며 복습하고, 홈 화면 위젯으로도 볼 수 있습니다.
• 오프라인 동작 — 대화·문장 분석·페르소나 생성이 모두 온디바이스입니다. 대화 내용은 기기 밖으로 나가지 않습니다.
• 매일 무료 포인트 — 하루 첫 실행에 50포인트를 광고 없이 지급합니다. 더 필요하면 리워드 광고로 50포인트씩, 하루 10회까지 받을 수 있습니다.
• X 프로필로 친구 만들기 — 공개 프로필 URL을 넣으면 말투를 잡고 언어와 수준을 자동으로 추정합니다.
• 꾸미기 — 대화 배경을 갤러리에서 고르고, 테마를 시스템·라이트·다크에서 선택합니다.
• 신고 — 부적절한 AI 응답을 메일로 신고할 수 있습니다.

기술 스택

• Flutter (iOS · Android)
• Gemma 4 E2B + LiteRT-LM — flutter_gemma, 온디바이스 추론
• Provider — 상태 관리
• Hive CE — 로컬 저장소 (대화는 청크로 나눠 저장)
• background_downloader — 모델 다운로드(재개·진행 알림)
• Google Mobile Ads — 리워드 광고
• home_widget — 홈 화면 단어 위젯
• webview_flutter · url_launcher — 약관 표시, 메일 신고

설치 방법

1. Flutter 개발 환경 확인

   flutter doctor

2. 의존성 설치

   flutter pub get

3. 환경 변수 — 로컬 개발에서는 필요 없습니다.

   • AI API 키가 필요하지 않고, .env 파일도 사용하지 않습니다.
   • 디버그 빌드는 Google 테스트 광고 단위를 씁니다.
   • 릴리스 광고 설정은 SETTINGS.md를 참고하세요.

4. 앱 실행

   • iPhone 실기기는 profile 모드를 사용합니다.

     ./run_on_iphone.sh

   • 시뮬레이터와 Android는 flutter run을 사용할 수 있습니다.

5. 최초 실행 시 Gemma 4 E2B 모델(2.59GB)을 다운로드합니다.

   • 고정된 Hugging Face 리비전에서 받고 크기와 SHA-256을 검증합니다.
   • 네트워크를 쓰는 곳은 이 다운로드, X 프로필 가져오기, 리워드 광고, 업데이트 확인뿐입니다.

테스트

flutter analyze
flutter test

빌드 방법

프로덕션 빌드는 release 브랜치에 머지하면 GitHub Actions가 처리합니다 (AAB → Google Play, IPA → App Store Connect). 버전 이름은 pubspec.yaml, 빌드 번호는 CI가 정합니다.

로컬에서 만들 때:

flutter build appbundle --release   # Android
flutter build ipa --release         # iOS

스토어 준수 사항

• 대상 연령대는 만 13세 이상입니다. 온디바이스 생성형 AI 대화 앱이므로 아동 대상(Families) 프로그램에는 포함하지 않습니다.
• 광고는 요청 단위로 G 등급으로 제한하고 아동 대상 취급을 no로 선언합니다 (ad_config.dart). 이 값은 test/core/ads/ad_content_rating_test.dart가 고정합니다.

문서

• 지원 · 자주 묻는 질문
• 개인정보처리방침
• 이용약관
• 마케팅·알림 수신 안내

버전 정보

• 현재 버전: 2.0.0

라이선스

© 2026 토모토모. All rights reserved.