{"id":51042084,"url":"https://github.com/snowch/mentor-me","last_synced_at":"2026-06-22T11:31:51.858Z","repository":{"id":325351199,"uuid":"1094972876","full_name":"snowch/mentor-me","owner":"snowch","description":"An intelligent mentor and coach for goal tracking, habit building, and personal development.","archived":false,"fork":false,"pushed_at":"2026-02-09T13:51:17.000Z","size":6459,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-09T16:25:04.815Z","etag":null,"topics":["ai-assistant","android","claude-api","claude-code","edge-ai","flutter","litert","mentor","productivity-app"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snowch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES_SUMMARY.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-12T12:26:10.000Z","updated_at":"2026-02-09T13:51:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/snowch/mentor-me","commit_stats":null,"previous_names":["snowch/mentor-me"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/snowch/mentor-me","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowch%2Fmentor-me","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowch%2Fmentor-me/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowch%2Fmentor-me/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowch%2Fmentor-me/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snowch","download_url":"https://codeload.github.com/snowch/mentor-me/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowch%2Fmentor-me/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34647747,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","android","claude-api","claude-code","edge-ai","flutter","litert","mentor","productivity-app"],"created_at":"2026-06-22T11:31:48.889Z","updated_at":"2026-06-22T11:31:51.851Z","avatar_url":"https://github.com/snowch.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MentorMe\n\n\u003cdiv align=\"center\"\u003e\n\n**AI-Powered Personal Growth Companion**\n\nAn intelligent mentor and coach for goal tracking, habit building, and personal development.\n\n[![Flutter](https://img.shields.io/badge/Flutter-3.0+-02569B?logo=flutter\u0026logoColor=white)](https://flutter.dev)\n[![Dart](https://img.shields.io/badge/Dart-3.0+-0175C2?logo=dart\u0026logoColor=white)](https://dart.dev)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)\n\n[Features](#features) • [Getting Started](#getting-started) • [Documentation](#documentation) • [Contributing](#contributing)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nMentorMe is a comprehensive personal growth application that combines goal tracking, habit building, and journaling with AI-powered coaching. Choose between Claude's advanced cloud-based language models or privacy-focused local AI running entirely on your device. MentorMe provides personalized guidance, insights, and motivation to help you achieve your goals.\n\n### Key Highlights\n\n- **Flexible AI Options**: Choose between cloud-based Claude API or on-device local AI models\n- **Intelligent Mentoring**: AI analyzes your progress and provides contextual coaching\n- **Goal Management**: Track goals with milestones, deadlines, and progress monitoring\n- **Habit Building**: Build lasting habits with streak tracking and smart reminders\n- **Reflective Journaling**: Capture thoughts, moods, and energy levels with guided prompts\n- **Pulse Check-ins**: Quick mood and energy tracking throughout the day\n- **Chat Interface**: Natural conversations with your AI mentor\n- **Privacy-First**: All data stored locally, with optional offline AI for complete privacy\n\n---\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### Onboarding Experience\n\u003cimg src=\"docs/screenshots/onboarding_1.jpg\" width=\"200\" alt=\"Welcome Screen\"\u003e \u003cimg src=\"docs/screenshots/onboarding_2.jpg\" width=\"200\" alt=\"Set Goals\"\u003e \u003cimg src=\"docs/screenshots/onboarding_3.jpg\" width=\"200\" alt=\"Build Habits\"\u003e \u003cimg src=\"docs/screenshots/onboarding_4.jpg\" width=\"200\" alt=\"AI Configuration\"\u003e\n\n### Home \u0026 Core Features\n\u003cimg src=\"docs/screenshots/home_screen.jpg\" width=\"200\" alt=\"Home Screen\"\u003e \u003cimg src=\"docs/screenshots/new_goal_screen.jpg\" width=\"200\" alt=\"Create Goals\"\u003e \u003cimg src=\"docs/screenshots/habit_screen.jpg\" width=\"200\" alt=\"Track Habits\"\u003e \u003cimg src=\"docs/screenshots/journal_screen.jpg\" width=\"200\" alt=\"Journaling\"\u003e\n\n### AI Configuration\n\u003cimg src=\"docs/screenshots/ai_provider_screen_1.jpg\" width=\"200\" alt=\"AI Settings - Cloud\"\u003e \u003cimg src=\"docs/screenshots/ai_provider_screen_2.jpg\" width=\"200\" alt=\"AI Settings - Local\"\u003e\n\n\u003c/div\u003e\n\n---\n\n## Features\n\n### 🎯 Goal Tracking\n- Create and organize goals with categories (Health, Career, Personal, etc.)\n- Break down goals into actionable milestones\n- Set deadlines and track progress\n- Visual progress indicators\n- Goal analytics and insights\n\n### ✅ Habit Building\n- Daily habit tracking with streak monitoring\n- Smart reminders to maintain consistency\n- Habit analytics showing patterns and trends\n- Celebration of milestones (7-day, 30-day streaks)\n- Flexible habit scheduling\n\n### 📔 Journaling\n- Free-form and guided journaling options\n- Mood and energy level tracking\n- Link journal entries to goals\n- Search and filter past entries\n- AI-powered insights from your journal\n\n### 💬 AI Coaching\n- Personalized coaching cards based on your activity\n- Context-aware advice and motivation\n- Pattern detection (stalled goals, broken streaks, etc.)\n- Natural language chat with AI mentor\n- Goal decomposition and planning assistance\n\n### 📊 Pulse Tracking\n- Quick check-ins throughout the day\n- Custom pulse types (mood, energy, stress, focus, etc.)\n- Historical trends and visualizations\n- Identify patterns affecting your progress\n\n### 🔔 Smart Reminders\n- Adaptive notification system\n- Morning and evening check-in prompts\n- Habit reminders at optimal times\n- Streak protection alerts\n- Deadline notifications\n\n### 🔒 Privacy \u0026 Data Control\n- Local-first data storage\n- Export/import functionality for backups\n- No cloud sync required (optional)\n- Full control over your data\n\n---\n\n## Tech Stack\n\n### Core Technologies\n- **Flutter** - Cross-platform UI framework (web + mobile)\n- **Dart 3.0+** - Modern, null-safe programming language\n- **Provider** - State management\n- **SharedPreferences** - Local data persistence\n\n### AI Integration\n\nMentorMe offers flexible AI options to suit your privacy and performance needs:\n\n**Remote AI (Claude API)**\n- Anthropic's advanced language models via cloud API\n- Support for multiple models (Opus 4, Sonnet 4.5, Sonnet 4, Haiku 4)\n- Requires internet connection and API key\n- Custom proxy server for web CORS handling\n\n**Local AI (On-Device)**\n- Privacy-first: All processing happens on your device\n- No internet required for AI features\n- Google LiteRT LLM (AI Edge) for local model execution\n- Gemma 3-1B-IT model optimized for on-device inference\n- Downloadable models run entirely offline\n- Requires Android 12+ with 4GB+ RAM (6GB+ recommended)\n\n### Key Dependencies\n- `http` - API communication\n- `intl` - Internationalization and date formatting\n- `android_alarm_manager_plus` - Precise alarm scheduling\n- `flutter_local_notifications` - Local notification system\n- `path_provider` \u0026 `universal_io` - File system access\n- `share_plus` - Data sharing capabilities\n\n---\n\n## Getting Started\n\n### 📱 Quick Start: Download APK (Android)\n\n**Don't want to build from source?** Download the latest APK directly:\n\n**⚠️ Requirements:**\n- **Android 12.0 or higher** (check Settings → About Phone → Android version)\n- ARMv8 64-bit processor\n- 4GB+ RAM\n\n**Installation:**\n1. Go to [Releases](https://github.com/snowch/mentor-me/releases/latest)\n2. Download `mentor-me-vX.X.X.apk`\n3. Install on your Android device (requires enabling \"Install from Unknown Sources\")\n4. Open the app and start your personal growth journey! 🎉\n\n**⚠️ Important:** If you see \"App not installed\" or \"Package invalid\" error, check your Android version. This app requires Android 12 or higher due to the LiteRT LLM library used for on-device AI features.\n\n**For detailed installation instructions and troubleshooting**, see the [APK Download Guide](docs/APK_DOWNLOAD_GUIDE.md).\n\n---\n\n### Prerequisites\n\n- **Flutter SDK** 3.0.0 or higher ([Install Flutter](https://docs.flutter.dev/get-started/install))\n- **Dart SDK** 3.0.0 or higher (included with Flutter)\n- **Node.js** 14+ (for web proxy server - web development only)\n- **Claude API Key** (optional - only needed for remote AI) ([Get API Key](https://console.anthropic.com/))\n\n**Note**: You can use MentorMe completely offline with local AI models (Android only), or use Claude's cloud API for more advanced capabilities.\n\n#### Device Requirements for Local AI\n\n**Minimum Requirements:**\n- Android 12+ (API level 31 or higher) - **Required by LiteRT LLM library**\n- 4GB RAM minimum (6GB+ strongly recommended)\n- 2GB free storage for Gemma 3-1B-IT model\n- ARMv8 64-bit processor\n\n**Recommended for Best Performance:**\n- Android 13+\n- 6-8GB RAM\n- Modern mid-range to flagship devices (e.g., Pixel 6+, Samsung Galaxy S21+, OnePlus 9+, or equivalent)\n- GPU acceleration support for faster inference\n\n**Note**: Local AI performance varies by device. Newer devices with more RAM and better processors will provide faster, more responsive AI interactions. The Gemma 3-1B-IT model is optimized for on-device use and works well on modern mid-range Android devices.\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/snowch/habits.git\n   cd habits\n   ```\n\n2. **Install Flutter dependencies**\n   ```bash\n   flutter pub get\n   ```\n\n3. **Set up the proxy server** (for web development)\n   ```bash\n   cd proxy\n   npm install\n   ```\n\n4. **Configure AI Provider** (Optional)\n   - **For Remote AI**: Enter your Claude API key on first launch or via Settings \u003e AI Settings\n   - **For Local AI**: Skip the API key and select \"Local AI\" in Settings \u003e AI Settings\n   - You can switch between remote and local AI anytime in settings\n\n### Running the Application\n\n#### Web Development\n```bash\n# Terminal 1: Start the proxy server (required for web)\ncd proxy\nnpm start\n\n# Terminal 2: Run Flutter web app\nflutter run -d chrome\n```\n\nThe proxy server runs at `http://localhost:3000` and handles CORS for Claude API calls.\n\n#### Mobile Development (Android)\n```bash\n# Run on connected device or emulator\nflutter run\n\n# List available devices\nflutter devices\n```\n\n**Note**: Mobile builds don't require the proxy server (direct API calls).\n\n### Building for Production\n\n#### Web\n```bash\nflutter build web\n# Output: build/web/\n```\n\n#### Android\n```bash\n# Using the provided build script\n./build_android.sh\n\n# Or manually\nflutter build apk --release\nflutter build appbundle --release\n```\n\n---\n\n## Project Structure\n\n```\nlib/\n├── main.dart                 # App entry point\n├── models/                   # Data models\n│   ├── goal.dart\n│   ├── habit.dart\n│   ├── journal_entry.dart\n│   ├── checkin.dart\n│   ├── pulse_entry.dart\n│   ├── pulse_type.dart\n│   └── chat_message.dart\n├── providers/                # State management\n│   ├── goal_provider.dart\n│   ├── habit_provider.dart\n│   ├── journal_provider.dart\n│   ├── checkin_provider.dart\n│   ├── pulse_provider.dart\n│   └── chat_provider.dart\n├── screens/                  # UI screens\n│   ├── home_screen.dart\n│   ├── goals_screen.dart\n│   ├── habits_screen.dart\n│   ├── journal_screen.dart\n│   ├── mentor_screen.dart\n│   ├── chat_screen.dart\n│   └── settings_screen.dart\n├── services/                 # Business logic\n│   ├── ai_service.dart\n│   ├── storage_service.dart\n│   ├── notification_service.dart\n│   ├── mentor_intelligence_service.dart\n│   └── backup_service.dart\n├── widgets/                  # Reusable widgets\n├── theme/                    # App theming\n└── constants/                # Constants and strings\n    └── app_strings.dart\n\nproxy/                        # CORS proxy for web\n├── server.js\n└── package.json\n\ndocs/                         # Documentation\n└── MENTOR_LOGIC.md          # AI mentor logic details\n```\n\n---\n\n## Configuration\n\n### AI Model Selection\n\nMentorMe supports both remote and local AI models. Configure via Settings \u003e AI Settings:\n\n**Remote Models (Claude API)**\n- **Claude Opus 4** - Most capable, best for complex coaching\n- **Claude Sonnet 4.5** - Balanced performance and capability\n- **Claude Sonnet 4** - Fast and efficient (default)\n- **Claude Haiku 4** - Quick responses, lower cost\n\n**Local Models (On-Device)**\n- **Gemma 3-1B-IT** - Google's instruction-tuned language model running via LiteRT\n- **Complete Offline Operation** - No internet required after initial download\n- **Privacy-First** - All data and processing stays on your device\n- **Optimized for Mobile** - Efficient model designed for on-device performance\n\nTo use local AI:\n1. Navigate to Settings \u003e AI Settings\n2. Select \"Local AI\" as your AI provider\n3. Download the Gemma 3-1B-IT model (~2GB, one-time download)\n4. Accept the HuggingFace license agreement\n5. Wait for download to complete\n6. Start using AI features completely offline\n\n**Technology**: Powered by Google LiteRT LLM (AI Edge library) with the Gemma 3-1B-IT model from HuggingFace.\n\n**Device Requirements**: Requires Android 12+ with at least 4GB RAM (6GB+ recommended). See [Prerequisites](#device-requirements-for-local-ai) for detailed requirements.\n\n### Notification Settings\n\nConfigure check-in reminders and habit notifications:\n\n1. Navigate to Settings \u003e Mentor Reminders\n2. Enable/disable morning and evening check-ins\n3. Set preferred notification times\n4. Configure habit-specific reminders\n\n### Data Backup\n\nExport your data for safekeeping:\n\n1. Settings \u003e Backup \u0026 Restore\n2. Export Data → Downloads JSON backup\n3. Import Data → Restore from backup file\n\n---\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\nflutter test\n\n# Run with coverage\nflutter test --coverage\n\n# Run specific test file\nflutter test test/models/goal_test.dart\n```\n\n### Code Quality\n\n```bash\n# Analyze code\nflutter analyze\n\n# Format code\nflutter format lib/\n\n# Clean build artifacts\nflutter clean\n```\n\n### Developer Documentation\n\nFor detailed development guidelines, architecture decisions, and best practices, see:\n\n- **[CLAUDE.md](CLAUDE.md)** - Complete developer guide\n- **[docs/MENTOR_LOGIC.md](docs/MENTOR_LOGIC.md)** - AI mentor intelligence system\n- **[proxy/README.md](proxy/README.md)** - Proxy server documentation\n\n---\n\n## Roadmap\n\n### Upcoming Features\n- [ ] Multi-language support (i18n)\n- [ ] Cloud sync (optional)\n- [ ] Team/shared goals\n- [ ] Advanced analytics dashboard\n- [ ] Integration with calendar apps\n- [ ] Voice journaling\n- [ ] Goal templates library\n\n---\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n\n- Follow Flutter best practices outlined in [CLAUDE.md](CLAUDE.md)\n- Write tests for new features\n- Update documentation as needed\n- Use the `AppStrings` class for user-facing text\n- Ensure null safety compliance\n- Run `flutter analyze` before submitting\n\n---\n\n## Troubleshooting\n\n### Web: API calls failing\n\n**Problem**: CORS errors when calling Claude API from web\n\n**Solution**: Ensure the proxy server is running:\n```bash\ncd proxy\nnpm start\n```\n\n### Mobile: Notifications not working\n\n**Problem**: Reminders not appearing on Android\n\n**Solution**:\n1. Check Settings \u003e Mentor Reminders - ensure enabled\n2. Grant notification permissions in device settings\n3. Disable battery optimization for MentorMe app\n\n### Build failures\n\n**Problem**: Build errors after `git pull`\n\n**Solution**:\n```bash\nflutter clean\nflutter pub get\nflutter pub run build_runner build --delete-conflicting-outputs\n```\n\n---\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\nCopyright (C) 2025 Chris Snow\n\n---\n\n## Acknowledgments\n\n- **Anthropic** - Claude API for AI capabilities\n- **Flutter Team** - Excellent cross-platform framework\n- **Open Source Community** - All the amazing packages used in this project\n\n---\n\n## Contact\n\n**Chris Snow**\n\nFor bugs, feature requests, or questions, please open an issue on GitHub.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ using Flutter and Claude AI**\n\n[⬆ Back to top](#mentorme)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowch%2Fmentor-me","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnowch%2Fmentor-me","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowch%2Fmentor-me/lists"}