Hermit is a beautifully designed Flutter application to help Malaysians reduce food waste, save money, and build a sustainable community. Hermit empowers you to track your food, discover creative recipes, analyze environmental impact, and share surplus food with your neighbors.
- 🏠 Home Dashboard: Overview of your food inventory, reminders, and impact stats.
- 📦 Food Tracking: Add, edit, and manage your food items with expiry alerts.
- 🤳 Food Scanner: Instantly detect and log food items using your camera.
- 🍳 Recipe Suggestions: Get creative, AI-powered Malaysian recipes based on your leftovers.
- 🌱 Sustainability Analysis: See the carbon footprint and get storage tips for each food item.
- 🤝 Community Sharing: Share surplus food or request items from neighbors to fight waste together.
- 📊 Impact Metrics: Track your environmental savings, money saved, and food shared.
| Home Screen | Community Screen | Scan Screen |
|---|---|---|
 |
 |
 |
| Overview & Stats | Share & Request Food | Detect Food |
| Suggest Recipe | Waste Management | Waste Management Description |
|---|---|---|
 |
 |
 |
| AI Recipes | Waste Sorting | Eco Tips |
- Track Your Food: Add food items, set expiry dates, and get timely reminders.
- Scan & Detect: Use your camera to recognize and log food instantly.
- Get Recipes: Let Hermit suggest delicious Malaysian recipes using your leftovers.
- Analyze Impact: See the environmental footprint of your food and get storage tips.
- Share with Community: Offer surplus food or request what you need from nearby users.
- See Your Impact: Monitor how much waste and money you've saved!
- Flutter SDK (Dart 3.0.0+)
- Android/iOS device or emulator
- Clone the repo:
git clone <your-repo-url> cd hermit
- Install dependencies:
flutter pub get
- Configure environment:
- Add your API keys and settings to
.env(see.env.exampleif provided). - Ensure all assets are listed in
pubspec.yaml.
- Add your API keys and settings to
- Run the app:
flutter run
- If you encounter issues with dependencies, run
flutter cleanthenflutter pub get. - For camera/permissions issues, check your device settings and emulator configuration.
- API Keys: Place your generative AI and Firebase keys in the
.envfile. - Assets: All images and screenshots are in the
assets/directory and referenced inpubspec.yaml.
| Package | Purpose |
|---|---|
| flutter | Core framework |
| cupertino_icons | iOS-style icons |
| http | Networking |
| image_picker | Camera/gallery access |
| google_generative_ai | AI recipe suggestions |
| flutter_dotenv | Environment variables |
| shared_preferences | Local storage |
| path_provider | File system paths |
| firebase_core | Firebase integration |
| cloud_firestore | Cloud database |
Q: Is Hermit free?
A: Yes, Hermit is open-source and free to use.
Q: Does Hermit work offline?
A: Most features work offline, but sharing and AI require an internet connection.
Q: How do I contribute?
A: Fork the repo, make your changes, and open a pull request!
- For issues, open a GitHub issue.
- For feature requests or questions, contact the maintainer at [ariqulwanfina@gmail.com].
- Ariq Ulwan
- Adiba Alya
- Hadi Ilhan
- Nur Aisyah
- Nurul Azween
Special thanks to JomHack Varsity Hackathon for this amazing opportunity! 🚀
This project is licensed under the MIT License.
Made with ❤️ for a greener Malaysia