## ✅ Final Instructions for All Projects (with `uv` Package Manager)
### 🧰 **Tools Students Must Use**
* **Flask** (Web Framework)
* **Peewee** (ORM)
* **Bootstrap 5** (via CDN only)
* **DiceBear** (for avatars)
* **Jinja2** (Templating engine)
* ✅ **`uv` package manager** – instead of `pip`/`venv`
---
## 📦 How to Start a Project Using `uv`
### 🔹 1. Install `uv` (One Time)
```bash
curl -Ls https://astral.sh/uv/install.sh | sh
```
Or via pipx:
```bash
pipx install uv
```
---
### 🔹 2. Create a New Virtual Environment
```bash
uv venv .venv
```
> Activates automatically if shell supports it, else:
```bash
source .venv/bin/activate
```
---
### 🔹 3. Add Dependencies
---
### 🔹 4. Run the Project
Use normal `uv run app.py`, or optionally:
```bash
uv run app.py
```
> No need for `uvicorn` unless running an ASGI app (FastAPI, etc.)
---
### 🗂️ Final Project Folder Structure
```
project_name/
├── static/
├── templates/
├── auth.py
├── operations.py
├── models.py
├── main.py
├── database.db
├── requirements.txt
└── .venv/ (created by uv)
```
---
### 📌 Summary: What to Enforce for All Students
| Requirement | Must |
| ----------------------- | ---- |
| Flask | ✅ |
| Peewee ORM | ✅ |
| Jinja Templates | ✅ |
| Bootstrap via CDN | ✅ |
| DiceBear for avatars | ✅ |
| `uv` package manager | ✅ |
| Clean project structure | ✅ |
| CRUD + Auth | ✅ |
---
# Project Ideas
* **Ethical**
* **Fun + educational**
* **Relevant to social media, AI, and tech**
* **Free of romance/relationship themes**
---
## 🚀 Themed Project Categories
| Theme | Description |
| --------------------- | ------------------------------------------- |
| 🎓 AI & EdTech | Learn + Teach using AI & Flask |
| 📱 Social/Utility | Social-like platforms without relationships |
| 🤖 AI Fun Tools | Smart & playful AI utilities |
| 🧑💻 Developer Tools | Tech-focused tools for teens & students |
---
## 📚 AI + Education Projects
| # | Project Title | Idea Description |
| -- | --------------------------------- | ------------------------------------------------------------- |
| 1 | **AI Vocabulary Trainer** | Students log in, get AI-generated word + usage, mark learned |
| 2 | **Homework Help Hub** | Submit doubt, teacher/admin replies using AI suggestion |
| 3 | **Python Quiz Portal** | Admin uploads Python MCQs, students practice + get scores |
| 4 | **Daily AI Summary App** | Get a 100-word AI summary of any topic from dashboard |
| 5 | **My Study Journal** | Log daily learning & mood, dashboard tracks growth |
| 6 | **Flashcards with AI Tips** | Flashcard CRUD with auto explanation from AI |
| 7 | **Student Goal Tracker** | Set study goals and track them daily, use AI to suggest plans |
| 8 | **AI Study Partner** (Chat Style) | Ask doubts to AI (Gemini/OpenAI), get answers in dashboard |
| 9 | **Subject Notes Manager** | Upload topics, AI generates bullet notes |
| 10 | **Career Suggestion Bot** | Form with interests → AI gives career suggestions |
---
## 📱 Social + Community Style Projects (Safe for Teens)
| # | Project Title | Idea Description |
| -- | --------------------------- | ------------------------------------------------------------- |
| 11 | **Techie Feed** | Post short tech facts/tips, like/comment (CRUD only) |
| 12 | **Show My Setup** | Students post laptop/PC/mobile setups |
| 13 | **Hackathon Tracker** | List ongoing hackathons or contests students can join |
| 14 | **My Project Wall** | Students post projects with GitHub link & tech used |
| 15 | **Quotes Sharing App** | Students post tech/edu motivational quotes |
| 16 | **Teens Mini Forum** | Simple discussion boards with categories (no chat) |
| 17 | **MemeHub Edu Edition** | Users post education/tech-related memes |
| 18 | **Digital Whiteboard Wall** | Post images (DiceBear ID + Title + Description) |
| 19 | **AI Prompt Marketplace** | Share best AI prompts (like ChatGPT/Gemini) for others to use |
| 20 | **Skill Swap Board** | List what you know and what you want to learn — find matchups |
---
## 🤖 AI Fun Utilities for Students
| # | Project Title | Idea Description |
| -- | ----------------------------------- | ---------------------------------------------------------------- |
| 21 | **AI Name Generator** | Generate cool usernames/gamer tags |
| 22 | **Emoji Mood Journal** | Log daily mood + AI suggests emojis |
| 23 | **AI Slogan Maker** | Create taglines for brands or school clubs |
| 24 | **AI Poem or Rap Generator** | User enters topic, AI generates teen-friendly poem/rap |
| 25 | **Text-to-AI Art Prompt Generator** | Give idea → get an AI art prompt for apps like Canva/Sora |
| 26 | **AI Roast Bot (Friendly)** | Light/fun AI-generated roast messages for self or friends |
| 27 | **Exam Excuse Generator** | Enter reason → AI writes a creative but safe excuse |
| 28 | **Fake Tech News Generator** | Input tech keyword → AI makes fun fake headline |
| 29 | **AI Avatar Prompt Tool** | Input traits → generate avatar prompt for Midjourney/DiceBear |
| 30 | **AI Motivator** | “I'm feeling…” → AI gives 3 motivational lines and 1 action step |
---
## 🔧 All Must Use
* Flask
* Peewee ORM
* Bootstrap (CDN)
* DiceBear for avatars
* Folder structure: `/templates`, `app.py`, `models.py`, `auth.py`, `operations.py`
* `uv` package manager
---
Sign in with Wallet
Connect another wallet