shreya-PA 1.0.0

AI-powered personal coding and wellbeing assistant for Shreya — powered by Groq LLM.

🚀 shreya-PA

AI-powered personal coding & wellbeing assistant for Shreya — powered by Groq LLM.

---

✨ Features

Module	What it does
dsa	Progressive DSA hints (no solutions, no code!)
leetcode	Daily practice topic suggestion + motivation
tech	Surprising tech & CS facts
health	Break & sleep reminders for developer wellbeing
motivation	Inspiring quotes for programmers solving DSA
focus	Pomodoro-style timer with AI start/break messages
surprise	Heartfelt birthday messages with coding encouragement

All responses are AI-generated via Groq LLM — no hardcoded data.

---

📦 Installation

pip install shreya-PA

Set your Groq API key

# Linux / macOS
export GROQ_API_KEY="your-api-key-here"

# Windows (PowerShell)
$env:GROQ_API_KEY = "your-api-key-here"

# Windows (CMD)
set GROQ_API_KEY=your-api-key-here

Get a free API key at console.groq.com.

---

🚀 Quick Start

from shreya_devbuddy import dsa, tech, leetcode, health, motivation, surprise

# Get a DSA hint (level 1–3)
print(dsa.hint("binary search", level=1))

# Daily LeetCode reminder
print(leetcode.daily_reminder())

# Random tech fact
print(tech.fact())

# Health reminders
print(health.break_reminder())
print(health.sleep_reminder())

# Motivational quote
print(motivation.quote())

# Birthday surprise message
print(surprise.message("Shreya"))

Focus Session (Pomodoro Timer)

from shreya_devbuddy import focus

# 25-minute focus session (default)
focus.session()

# Custom duration
focus.session(minutes=10)

---

📁 Project Structure

shreya_devbuddy/
├── __init__.py      # Package exports
├── ai.py            # Core Groq LLM integration
├── dsa.py           # DSA hint system
├── leetcode.py      # Daily practice reminder
├── tech.py          # Tech facts
├── health.py        # Break & sleep reminders
├── motivation.py    # Motivational quotes
├── focus.py         # Focus timer with AI messages
└── surprise.py      # Birthday message generator

---

🧠 DSA Hint Levels

Level	What you get
1	High-level direction / concept hint
2	Approach / strategy suggestion
3	Optimization tip / edge-case insight

dsa.hint("two sum", level=1)  # "Think about using a hash-based structure…"
dsa.hint("two sum", level=2)  # "Try a single-pass approach with a dictionary…"
dsa.hint("two sum", level=3)  # "Consider the trade-off between time and space…"

⚠️ The AI will NEVER give full solutions or code — only guided thinking.

---

🔧 Requirements

• Python 3.10+
• groq Python SDK
• A valid GROQ_API_KEY environment variable

---

📄 License

MIT License — see LICENSE for details.

---

💜 Made with love for Shreya's coding journey.