Metadata-Version: 2.4
Name: shreya-PA
Version: 1.0.0
Summary: AI-powered personal coding and wellbeing assistant for Shreya — powered by Groq LLM.
Author-email: Sarthak <sarthak@example.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/sarthak/shreya-PA
Project-URL: Repository, https://github.com/sarthak/shreya-PA
Project-URL: Issues, https://github.com/sarthak/shreya-PA/issues
Keywords: ai,assistant,dsa,leetcode,groq,coding,wellbeing,motivation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: groq>=0.4.0
Dynamic: license-file

# 🚀 shreya-PA

**AI-powered personal coding & wellbeing assistant for Shreya** — powered by [Groq](https://groq.com/) LLM.

[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/shreya-PA)](https://pypi.org/project/shreya-PA/)

---

## ✨ 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

```bash
pip install shreya-PA
```

### Set your Groq API key

```bash
# 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](https://console.groq.com/).

---

## 🚀 Quick Start

```python
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)

```python
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  |

```python
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](LICENSE) for details.

---

## 💜 Made with love for Shreya's coding journey.
