🐹 Hypotrophy - AI-Powered Personal Growth
Built for hackUMBC2025 🏆 - A 24-hour hackathon project
Meet Biscuit, your friendly AI hamster companion for personal growth!
Transform your basic to-do lists into engaging conversations with Biscuit, your AI hamster assistant! Hypotrophy makes personal growth fun and motivating through real-time encouragement, progress celebration, and intelligent insights.
🏆 hackUMBC2025 Achievement
This project was built during hackUMBC2025, a 24-hour hackathon, showcasing:
- ⚡ Rapid Development: Full-featured app built in 24 hours
- 🤖 AI Integration: Google Gemini API for intelligent insights
- 🎨 Creative UX: Personality-driven design with Biscuit the hamster
- 💻 Modern Tech Stack: Next.js 15, TypeScript, Tailwind CSS
- 🚀 Production Ready: Deployed and fully functional
Timeline: 24 hours | Event: hackUMBC2025 | Result: Complete AI companion app
🌟 What Makes Hypotrophy Special
🐹 Meet Biscuit - Your AI Companion
- Real-time Conversations: Chat with Biscuit through typing animations
- Personalized Encouragement: Celebrates every achievement with unique messages
- Intelligent Insights: Provides contextual motivation and suggestions
- Emotional Support: Makes personal growth feel like a friendship
🎯 Smart Task & Goal Management
- Task Creation: Add tasks with categories, priorities, and descriptions
- Goal Tracking: Set long-term goals with progress visualization and deadlines
- Completion Celebration: Biscuit cheers you on with every completed task
- Delete & Modify: Full task management with confirmation dialogs
📊 Visual Progress Tracking
- Progress Bars: Beautiful visual indicators for goal completion
- Smart Analytics: "Ask Biscuit for Analysis" button for progress insights
- Deadline Awareness: Color-coded status for overdue, due today, or upcoming goals
- Category Organization: Track progress across life areas (health, career, personal, etc.)
✨ Delightful User Experience
- Smooth Animations: Float, slide-up, fade-in, and wiggle effects
- Glassmorphism Design: Modern backdrop-blur effects and transparency
- Responsive Layout: Perfect experience on desktop, tablet, and mobile
- Accessibility First: Keyboard navigation and screen reader friendly
🚀 Coming Soon
🔮 Advanced AI Integration
- Google Gemini API: Enhanced AI analysis and recommendations
- Image Analysis: Track habits through photos and visual progress
- Smart Scheduling: AI-powered time optimization suggestions
- Goal Refinement: Intelligent goal adjustment based on your success patterns
📸 Visual Habit Tracking
- Photo Progress: Upload images to track physical changes or achievements
- Visual Verification: AI-powered habit completion verification
- Progress Galleries: See your transformation over time
- Achievement Celebrations: Visual milestones and rewards
🎯 Advanced Goal Management
- SMART Goals: AI helps create Specific, Measurable, Achievable goals
- Milestone Tracking: Break large goals into manageable steps
- Dependency Management: Understanding how goals connect and build upon each other
- Success Prediction: AI analyzes likelihood of goal completion
🛠️ Technology Stack
- Frontend: Next.js 15 with React 19
- Styling: Tailwind CSS with custom design system
- TypeScript: Full type safety and developer experience
- Storage: Local storage (with planned database integration)
- AI Integration: Google Gemini API (planned)
- Image Processing: Free image analysis services (planned)
📦 Installation
-
Clone the repository
git clone https://github.com/developer-az/hypotrophy.git
cd hypotrophy
-
Install dependencies
npm install
-
Run the development server
npm run dev
-
Open your browser
Navigate to http://localhost:3000
🎮 Usage
Getting Started
- Add Your First Task: Use the task form to create your first personal growth goal
- Choose Categories: Organize tasks by life areas (health, career, personal, etc.)
- Set Priorities: Mark tasks as low, medium, or high priority
- Track Progress: Complete tasks and watch your progress dashboard update
- Get AI Insights: Receive personalized recommendations and encouragement
Categories Available
- 👤 Personal: Self-care, habits, personal development
- 💪 Health & Fitness: Exercise, nutrition, wellness goals
- 💼 Career: Professional development, skills, networking
- 📚 Learning: Education, new skills, knowledge acquisition
- ❤️ Relationships: Social connections, communication, family
- 💰 Finance: Budgeting, savings, financial planning
- 🎨 Creativity: Art, writing, creative projects
- 🏠 Home & Environment: Organization, living space improvements
Tips for Success
- Start Small: Begin with achievable daily tasks
- Be Consistent: Regular small actions lead to big transformations
- Use AI Insights: Pay attention to patterns and recommendations
- Celebrate Wins: Acknowledge every completed task, no matter how small
- Stay Flexible: Adjust your goals based on what you learn about yourself
🛡️ Privacy & Data
Hypotrophy respects your privacy:
- Local Storage: Your data stays on your device
- No Account Required: Start using immediately without registration
- Open Source: Transparent code you can review and modify
- Future Cloud Sync: Optional, secure cloud backup planned for premium features
🤝 Contributing
We welcome contributions! Here's how you can help:
- Report Bugs: Use GitHub issues to report problems
- Suggest Features: Share ideas for new functionality
- Submit PRs: Contribute code improvements
- Share Feedback: Tell us about your experience using Hypotrophy
📜 License
This project is licensed under the ISC License - see the LICENSE file for details.
🌟 Vision
Hypotrophy aims to revolutionize personal growth by making self-improvement:
- Intelligent: AI-powered insights that adapt to your unique patterns
- Effortless: Streamlined technology that enhances rather than complicates
- Insightful: Deep understanding of your progress and potential
- Empowering: Tools that help you become the best version of yourself
Start your growth journey today! 🌱
Made with ❤️ for personal transformation
