🏋️‍♂️ Fitness Freak AI – Your Smart Health & Fitness Companion:

♠️ Purpose:

Empowering fitness enthusiasts, trainers, and beginners to achieve their health goals through personalized AI-driven insights, workout recommendations, and nutrition tracking.

📖 Table of Contents:

1. 🔬 About FitnessFreak
2. 🛠 Features
3. 📸 Screenshots
4. 🚀 Tech Stack
5. 📦 Installation
6. 🔧 Usage
7. 🤝 Contributing
8. 📜 License
9. 📬 Contact

🔬 About FitnessFreak:

Fitness Freak AI is an open-source health and fitness platform designed to transform workouts and nutrition planning using AI. Whether you’re a beginner starting your fitness journey or a professional trainer managing clients, the platform offers intelligent recommendations, progress tracking, and real-time engagement. Mainly for: ✅ For Fitness Enthusiasts – Personalized workout & diet plans ✅ For Trainers – Manage multiple clients & monitor progress ✅ For Beginners – Guided routines & easy-to-follow diet tracking ✅ For Open-source Contributors – Build AI-powered fitness innovations

🛠 Features:

• 🤖 AI-Powered Recommendations – Smartly generated workout & meal plans based on goals (weight loss, muscle gain, endurance).
• 📊 Progress Tracker – Track calories, workouts, steps, and body metrics.
• 🥗 Nutrition Guide – Log meals & receive balanced diet insights.
• 💬 AI Chatbot Coach – Get instant answers on fitness, health, and exercises.
• 🧘 Customizable Routines – Create or adapt workout programs.
• 📱 Responsive Dashboard – Mobile & web-friendly interface.
• 🔗 Open Contribution – Community-driven fitness enhancements.

📸 Screenshots:

Dashboard:

Generate Program:

📑 Comprehensive Profile Records:

🚀 Tech Stack:

📦 Installation:

Follow these steps to set up the project locally on your machine.

🔧 Prerequisites:

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

⬇ Clone Repository:

git clone https://github.com/your-username/FitnessFreakAI.git
cd FitnessFreakAI

📌 Install Dependencies:

Install the project dependencies using npm:

npm install

Set Up Environment Variables

Create a new file named .env in the root of your project and add the following content:

NEXT_PUBLIC_NVIDIA_API_KEY=your-nvidia-api-key

VAPI_API_KEY='your-vapi-api-key'

MONGODB_URL='your-mongodb-url'

NEXT_PUBLIC_API_BASE_URL= http://localhost:3000

RESEND_KEY= 'your-resend-api-key'

NEXT_CLERK_URL=your-clerk-url

🚀 Start the Application:

npm run dev
Open [http://localhost:3000](http://localhost:3000) in your browser to view the project.

🔧 Usage:

1️⃣ Sign up & set your fitness goals. 2️⃣ Receive AI-powered workout & meal plans. 3️⃣ Track your daily activities, workouts, and calories. 4️⃣ Chat with the AI coach for instant fitness guidance. 5️⃣ Contribute by sharing new workouts, diets, or AI models.

🤝 Contributing:

🔬 Contributions are highly encouraged! We welcome contributions from developers, trainers, and health enthusiasts 🚀

Fork the repository.
Create a new branch (git checkout -b feature-name).
Commit your changes (git commit -m "Added new feature").
Push to your branch (git push origin feature-name).
Open a Pull Request.

🛂 Contribution Guidelines:

📌Reporting Issues:

Search for existing issues: Before creating a new issue, search the issue tracker to see if the problem has already been reported. Provide clear and concise information: When creating a new issue, please include as much detail as possible, such as: Clear description of the problem Steps to reproduce the issue Expected behavior Actual behavior Screenshots or logs (if applicable) Use issue templates: If available, use the provided issue templates to structure your report.

📌Submitting Pull Requests:

Fork the repository: Create a fork of the project on your GitHub account. Create a new branch: Create a new branch based on the main branch or a feature branch. Make changes: Implement your changes and commit them with clear commit messages. Push changes to your fork: Push your changes to your forked repository. Open a Pull Request: Create a pull request from your branch to the main repository. Provide details: Clearly describe the changes you've made and the benefits they bring. Address code review feedback: Be open to feedback and make necessary changes.

📌Testing:

Write unit tests for any new features or bug fixes. Ensure existing tests pass after your changes.

📜 License:

Fitness Freak AI is licensed under the MIT License – open for personal and educational use.

🚀 Let’s revolutionize health & fitness with AI-driven personalization! 💪🔥

📬 Contact:

🔗 GitHub: CodeWithRajDeep

🌐 Website: https://deepraj-portfolio-red.vercel.app