DEVCONSISTENT — Django Habit & Consistency Tracker with Real AI Insights
DevConsistent is a complete Django source code project that helps users track daily tasks, build streaks, set goals, and get real AI-generated feedback on their progress. Built for developers who want a ready-to-use tracking app they can launch as-is, customize for clients, or use as a learning reference for real-world Django patterns.
Unlike most habit trackers that use static, hardcoded messages, DevConsistent connects to the Groq AI API to generate genuine, personalized insights based on each user's actual data — their streak, completion rate, and weekly trends.
KEY FEATURES

Real AI Insights — Every dashboard visit generates a fresh, personalized insight using the Groq API (Llama 3.3), built from the user's real stats. Includes automatic fallback logic if the API is unavailable, so the app never breaks.
Daily Task Logging — Simple form to log completed and uncompleted tasks for any date, with automatic consistency score calculation.
Streak Tracking — Visual current-streak counter that updates automatically based on daily logging activity.
Goal Tracking — Users can create custom goals with a target consistency percentage and a date range. Progress is calculated automatically from real logged data.
Data Export (CSV + PDF) — Download Daily Logs, Summary Stats, and Goals as CSV or professionally formatted PDF reports, generated with ReportLab.
7-Day Consistency Graph — Interactive Chart.js line chart visualizing the user's consistency trend.
Onboarding Flow, Dark/Light Theme Toggle, Full Authentication, Task Management (CRUD), and Mobile Responsive design.

TECH STACK
Django · Python · SQLite · Chart.js · Groq AI API (Llama 3.3) · ReportLab
WHAT'S INCLUDED

Full Django source code • requirements.txt • Detailed README with setup instructions • Clear inline code comments

REQUIREMENTS

Python 3.10+ • A free Groq API key (instructions in README) — works even without one via built-in fallback

GREAT FOR
Developers launching a ready-made tracker, freelancers building similar tools for clients, and students learning real-world Django patterns.

Real AI insights powered by Groq API (Llama 3.3)
Daily task logging with automatic consistency scoring
Visual streak tracking
Goal creation with auto-calculated progress
Export data as CSV or PDF (Logs, Summary, Goals)
Interactive 7-day consistency graph (Chart.js)
Onboarding flow for new users
Dark / light theme toggle
Full authentication (signup, login, logout)
Task management with full CRUD
Mobile responsive design
Clean, well-documented Django codebase

Python 3.10 or higher
pip (Python package manager)
Django 5.x (included in requirements.txt)
A code editor (VS Code recommended)
A free Groq API key for AI insights (optional — app works without it using a built-in fallback)
Basic command line / terminal usage
SQLite (included by default, no separate installation needed)

1. Extract the downloaded ZIP file
2. Open the project folder in your terminal or code editor
3. Create a virtual environment: python -m venv venv
4. Activate it:
   - Windows: venvScriptsactivate
   - Mac/Linux: source venv/bin/activate
5. Install dependencies: pip install -r requirements.txt
6. (Optional) Add your free Groq API key in consistdev/settings.py for AI insights
7. Run migrations: python manage.py migrate
8. Create an admin account (optional): python manage.py createsuperuser
9. Start the server: python manage.py runserver
10. Open http://127.0.0.1:8000/ in your browser
11. Sign up, complete onboarding, and start tracking your progress!

Full step-by-step setup instructions are also included in the README.md file inside the download.