init

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,22 @@
+### AL ###
+#Template for AL projects for Dynamics 365 Business Central
+#launch.json folder
+.vscode/
+#Cache folder
+.alcache/
+#Symbols folder
+.alpackages/
+#Snapshots folder
+.snapshots/
+#Testing Output folder
+.output/
+#Extension App-file
+*.app
+#Rapid Application Development File
+rad.json
+#Translation Base-file
+*.g.xlf
+#License-file
+*.flf
+#Test results file
+TestResults.xml

README.md

@@ -0,0 +1,24 @@
+---
+title: Prompt2Project
+emoji: 🚀
+colorFrom: indigo
+colorTo: purple
+sdk: gradio
+sdk_version: 4.44.1
+app_file: app.py
+pinned: false
+license: mit
+---
+
+# 🚀 Prompt2Project
+
+An AI-powered project idea generator that creates detailed, structured project plans as downloadable PDFs.
+
+**Powered by Google Gemini 1.5 Flash** — enter a topic, pick your skill level, and get a complete project blueprint including a ready-to-use Master Prompt you can feed into any AI assistant.
+
+## Features
+
+- 📝 **Structured Project Plans** — title, description, goals, step-by-step instructions, tools, tips, bonus challenges
+- 🧠 **Master Prompt** — a detailed, 1000+ word prompt you can copy into ChatGPT, Claude, or Gemini for hands-on help
+- 📄 **PDF Export** — beautifully formatted, downloadable PDF with cover page and UTF-8 support
+- 🎯 **Customizable** — choose topic, skill level (Beginner/Intermediate/Advanced), and difficulty (1–10)

app.py

@@ -0,0 +1,447 @@
+import io
+import os
+import re
+import tempfile
+import textwrap
+import urllib.request
+import zipfile
+
+import gradio as gr
+import google.generativeai as genai
+from fpdf import FPDF
+
+# ---------------------------------------------------------------------------
+# Gemini setup
+# ---------------------------------------------------------------------------
+GEMINI_API_KEY = os.environ.get("GEMINI_API_KEY", "")
+
+# ---------------------------------------------------------------------------
+# Font helper — bundle DejaVuSans for full UTF-8 PDF support
+# ---------------------------------------------------------------------------
+FONT_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "fonts")
+FONT_PATH = os.path.join(FONT_DIR, "DejaVuSans.ttf")
+FONT_BOLD_PATH = os.path.join(FONT_DIR, "DejaVuSans-Bold.ttf")
+
+DEJAVU_ZIP_URL = (
+    "https://github.com/dejavu-fonts/dejavu-fonts/releases/download/"
+    "version_2_37/dejavu-fonts-ttf-2.37.zip"
+)
+
+
+def _ensure_fonts():
+    """Download DejaVu fonts from the v2.37 release if not already present."""
+    if os.path.exists(FONT_PATH) and os.path.exists(FONT_BOLD_PATH):
+        return
+    os.makedirs(FONT_DIR, exist_ok=True)
+    # Download the release zip and extract just the two TTFs we need
+    data = urllib.request.urlopen(DEJAVU_ZIP_URL).read()
+    with zipfile.ZipFile(io.BytesIO(data)) as zf:
+        for name in zf.namelist():
+            basename = os.path.basename(name)
+            if basename == "DejaVuSans.ttf":
+                with open(FONT_PATH, "wb") as f:
+                    f.write(zf.read(name))
+            elif basename == "DejaVuSans-Bold.ttf":
+                with open(FONT_BOLD_PATH, "wb") as f:
+                    f.write(zf.read(name))
+
+
+_ensure_fonts()
+
+# ---------------------------------------------------------------------------
+# Prompt template
+# ---------------------------------------------------------------------------
+SYSTEM_PROMPT = textwrap.dedent("""\
+You are an expert project mentor and curriculum designer. Given a **topic**, a
+**skill level**, and a **project difficulty** (1-10 scale), generate a complete,
+structured project plan in Markdown with the following sections. Use the EXACT
+headers shown below (including the ## markdown prefix). Do NOT add any extra
+top-level headers.
+
+## Project Title
+A creative, descriptive title for the project.
+
+## Project Description
+A clear 3-5 sentence overview of what the project is and why it matters.
+
+## Goals & Learning Outcomes
+A bulleted list of 5-8 concrete things the learner will achieve.
+
+## Step-by-Step Instructions
+Provide **at least 7** numbered steps. Each step should have a brief title in
+bold followed by 2-4 sentences of detailed explanation.
+
+## Tools & Technologies Needed
+A bulleted list of every tool, library, framework, language, and service the
+learner will use, with a one-line note on what each is used for.
+
+## Tips & Common Mistakes
+A bulleted list of at least 5 practical tips and pitfalls to avoid.
+
+## Bonus Challenges
+A bulleted list of 3-5 stretch goals that push the learner further.
+
+## Master Prompt
+Write a **minimum of 1000 words**. This section is a powerful, detailed,
+ready-to-use AI prompt that the reader can copy and paste into any AI tool
+(ChatGPT, Claude, Gemini, etc.) to get full hands-on help building this exact
+project. The prompt MUST include ALL of the following:
+- Full project context and background
+- Expected inputs and outputs with concrete examples
+- Architecture guidance (folder structure, modules, data flow)
+- Coding style preferences (naming conventions, comments, error handling)
+- Edge cases to handle and how to test them
+- How to ask follow-up questions effectively
+- A checklist the AI can use to verify its own output
+Wrap the entire master prompt content inside a fenced code block so the user
+can copy it easily.
+""")
+
+
+def build_user_prompt(topic: str, level: str, difficulty: int) -> str:
+    return (
+        f"**Topic:** {topic}\n"
+        f"**Skill Level:** {level}\n"
+        f"**Project Difficulty:** {difficulty}/10\n\n"
+        "Generate the full project plan now."
+    )
+
+
+# ---------------------------------------------------------------------------
+# Gemini API call
+# ---------------------------------------------------------------------------
+def call_gemini(topic: str, level: str, difficulty: int) -> str:
+    if not GEMINI_API_KEY:
+        raise gr.Error(
+            "GEMINI_API_KEY is not set. Add it as a Secret in your "
+            "Hugging Face Space settings."
+        )
+
+    genai.configure(api_key=GEMINI_API_KEY)
+    model = genai.GenerativeModel(
+        "gemini-1.5-flash",
+        system_instruction=SYSTEM_PROMPT,
+    )
+    response = model.generate_content(
+        build_user_prompt(topic, level, difficulty),
+        generation_config=genai.GenerationConfig(
+            temperature=0.9,
+            max_output_tokens=8192,
+        ),
+    )
+    return response.text
+
+
+# ---------------------------------------------------------------------------
+# Markdown → section parser
+# ---------------------------------------------------------------------------
+SECTION_TITLES = [
+    "Project Title",
+    "Project Description",
+    "Goals & Learning Outcomes",
+    "Step-by-Step Instructions",
+    "Tools & Technologies Needed",
+    "Tips & Common Mistakes",
+    "Bonus Challenges",
+    "Master Prompt",
+]
+
+
+def parse_sections(md_text: str) -> dict[str, str]:
+    """Split markdown text on ## headers into {title: body} dict."""
+    pattern = r"^##\s+" + r"|^##\s+".join(re.escape(t) for t in SECTION_TITLES)
+    parts = re.split(r"(?m)^##\s+", md_text)
+
+    sections: dict[str, str] = {}
+    for part in parts:
+        if not part.strip():
+            continue
+        first_line, _, body = part.partition("\n")
+        title = first_line.strip().rstrip("#").strip()
+        sections[title] = body.strip()
+    return sections
+
+
+# ---------------------------------------------------------------------------
+# PDF generator
+# ---------------------------------------------------------------------------
+class ProjectPDF(FPDF):
+    """Custom FPDF with DejaVu font and helper methods."""
+
+    DARK = (30, 30, 46)
+    ACCENT = (114, 137, 218)
+    LIGHT = (248, 248, 242)
+    SUBTEXT = (166, 172, 205)
+
+    def __init__(self):
+        super().__init__()
+        self.add_font("DejaVu", "", FONT_PATH, uni=True)
+        self.add_font("DejaVu", "B", FONT_BOLD_PATH, uni=True)
+        self.set_auto_page_break(auto=True, margin=20)
+
+    # -- cover page ----------------------------------------------------------
+    def cover_page(self, title: str, topic: str, level: str, difficulty: int):
+        self.add_page()
+        # Background
+        self.set_fill_color(*self.DARK)
+        self.rect(0, 0, 210, 297, "F")
+
+        # Accent bar
+        self.set_fill_color(*self.ACCENT)
+        self.rect(0, 80, 210, 6, "F")
+
+        # Title
+        self.set_y(100)
+        self.set_font("DejaVu", "B", 26)
+        self.set_text_color(*self.LIGHT)
+        self.multi_cell(0, 14, title, align="C")
+
+        # Metadata
+        self.ln(12)
+        self.set_font("DejaVu", "", 13)
+        self.set_text_color(*self.SUBTEXT)
+        meta = f"Topic: {topic}   |   Level: {level}   |   Difficulty: {difficulty}/10"
+        self.cell(0, 10, meta, align="C", new_x="LMARGIN", new_y="NEXT")
+
+        # Tagline
+        self.ln(6)
+        self.set_font("DejaVu", "", 11)
+        self.cell(0, 10, "Generated by Prompt2Project  —  powered by Google Gemini",
+                  align="C", new_x="LMARGIN", new_y="NEXT")
+
+    # -- section header ------------------------------------------------------
+    def section_header(self, title: str):
+        self.ln(6)
+        self.set_fill_color(*self.ACCENT)
+        self.set_text_color(255, 255, 255)
+        self.set_font("DejaVu", "B", 14)
+        self.cell(0, 10, f"  {title}", fill=True, new_x="LMARGIN", new_y="NEXT")
+        self.ln(4)
+
+    # -- body text -----------------------------------------------------------
+    def body_text(self, text: str):
+        self.set_text_color(50, 50, 50)
+        self.set_font("DejaVu", "", 10)
+        for line in text.split("\n"):
+            stripped = line.strip()
+            if not stripped:
+                self.ln(3)
+                continue
+
+            # Detect bullet points
+            if stripped.startswith(("- ", "* ", "• ")):
+                bullet_text = stripped.lstrip("-*• ").strip()
+                self.cell(6)
+                self.set_font("DejaVu", "B", 10)
+                self.cell(5, 6, "•")
+                self.set_font("DejaVu", "", 10)
+                # Use multi_cell for wrapping, indented
+                x = self.get_x()
+                w = self.w - self.r_margin - x
+                self.multi_cell(w, 6, bullet_text)
+            # Detect numbered steps
+            elif re.match(r"^\d+[\.\)]\s", stripped):
+                num, _, rest = stripped.partition(" ")
+                self.set_font("DejaVu", "B", 10)
+                self.cell(10, 6, num)
+                self.set_font("DejaVu", "", 10)
+                x = self.get_x()
+                w = self.w - self.r_margin - x
+                self.multi_cell(w, 6, rest)
+            # Bold sub‑headings (lines that start and end with **)
+            elif stripped.startswith("**") and "**" in stripped[2:]:
+                clean = stripped.replace("**", "")
+                self.set_font("DejaVu", "B", 11)
+                self.multi_cell(0, 7, clean)
+                self.set_font("DejaVu", "", 10)
+            else:
+                # Remove inline markdown bold markers for cleaner PDF
+                clean = stripped.replace("**", "")
+                self.multi_cell(0, 6, clean)
+
+    # -- code block (for master prompt) --------------------------------------
+    def code_block(self, text: str):
+        self.set_fill_color(240, 240, 240)
+        self.set_text_color(40, 40, 40)
+        self.set_font("DejaVu", "", 9)
+        # Remove fenced code block markers
+        text = re.sub(r"^```[a-zA-Z]*\n?", "", text)
+        text = re.sub(r"\n?```$", "", text)
+        for line in text.split("\n"):
+            bg_w = self.w - self.l_margin - self.r_margin
+            self.cell(bg_w, 5.5, "", fill=True, new_x="LMARGIN", new_y="NEXT")
+            self.set_y(self.get_y() - 5.5)
+            self.cell(3)
+            x = self.get_x()
+            w = self.w - self.r_margin - x - 2
+            self.multi_cell(w, 5.5, line)
+
+
+def generate_pdf(
+    sections: dict[str, str],
+    topic: str,
+    level: str,
+    difficulty: int,
+) -> str:
+    pdf = ProjectPDF()
+
+    title = sections.get("Project Title", "Untitled Project")
+
+    # Cover
+    pdf.cover_page(title, topic, level, difficulty)
+
+    # Content pages
+    pdf.add_page()
+    for sec_title in SECTION_TITLES:
+        if sec_title == "Project Title":
+            continue  # already on cover
+        body = sections.get(sec_title, "")
+        if not body:
+            continue
+
+        # Master Prompt starts on its own page
+        if sec_title == "Master Prompt":
+            pdf.add_page()
+
+        pdf.section_header(sec_title)
+
+        if sec_title == "Master Prompt":
+            # Render the code block portion nicely
+            pdf.body_text(body)
+        else:
+            pdf.body_text(body)
+
+    # Save to temp file
+    tmp = tempfile.NamedTemporaryFile(delete=False, suffix=".pdf",
+                                      prefix="prompt2project_")
+    pdf.output(tmp.name)
+    return tmp.name
+
+
+# ---------------------------------------------------------------------------
+# Main handler
+# ---------------------------------------------------------------------------
+def generate_project(topic: str, level: str, difficulty: int):
+    if not topic or not topic.strip():
+        raise gr.Error("Please enter a topic.")
+
+    md_text = call_gemini(topic.strip(), level, int(difficulty))
+    sections = parse_sections(md_text)
+
+    pdf_path = generate_pdf(sections, topic.strip(), level, int(difficulty))
+
+    return md_text, pdf_path
+
+
+# ---------------------------------------------------------------------------
+# Gradio UI
+# ---------------------------------------------------------------------------
+THEME = gr.themes.Soft(
+    primary_hue=gr.themes.colors.indigo,
+    secondary_hue=gr.themes.colors.purple,
+    font=[gr.themes.GoogleFont("Inter"), "system-ui", "sans-serif"],
+)
+
+CSS = """
+#header {
+    text-align: center;
+    padding: 1.5rem 0 0.5rem;
+}
+#header h1 {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    font-size: 2.4rem;
+    font-weight: 800;
+    margin-bottom: 0.25rem;
+}
+#header p {
+    color: #888;
+    font-size: 1.05rem;
+}
+#generate-btn {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%) !important;
+    color: white !important;
+    font-weight: 700 !important;
+    font-size: 1.1rem !important;
+    border: none !important;
+    padding: 12px 32px !important;
+    border-radius: 10px !important;
+    transition: transform 0.15s, box-shadow 0.15s !important;
+}
+#generate-btn:hover {
+    transform: translateY(-2px) !important;
+    box-shadow: 0 6px 20px rgba(102,126,234,0.4) !important;
+}
+.output-markdown {
+    border: 1px solid #e2e8f0;
+    border-radius: 12px;
+    padding: 1.5rem;
+    background: #fafbff;
+}
+footer { display: none !important; }
+"""
+
+with gr.Blocks(theme=THEME, css=CSS, title="Prompt2Project") as demo:
+    # Header
+    gr.HTML(
+        """
+        <div id="header">
+            <h1>🚀 Prompt2Project</h1>
+            <p>Generate a complete project plan &amp; Master Prompt — powered by Gemini</p>
+        </div>
+        """
+    )
+
+    with gr.Row(equal_height=True):
+        with gr.Column(scale=1, min_width=300):
+            gr.Markdown("### ⚙️ Configuration")
+            topic_input = gr.Textbox(
+                label="📌 Topic",
+                placeholder="e.g. Machine Learning, Web Development, Game Design…",
+                lines=1,
+                max_lines=1,
+            )
+            level_input = gr.Dropdown(
+                label="📊 Skill Level",
+                choices=["Beginner", "Intermediate", "Advanced"],
+                value="Intermediate",
+            )
+            difficulty_input = gr.Slider(
+                label="🎯 Project Difficulty",
+                minimum=1,
+                maximum=10,
+                step=1,
+                value=5,
+            )
+            generate_btn = gr.Button("✨ Generate Project", elem_id="generate-btn")
+
+            gr.Markdown("---")
+            gr.Markdown(
+                "**📥 Download your PDF below** after generating.",
+                elem_classes=["note"],
+            )
+            pdf_output = gr.File(label="📄 Project PDF", interactive=False)
+
+        with gr.Column(scale=2, min_width=500):
+            gr.Markdown("### 📋 Generated Project Plan")
+            md_output = gr.Markdown(
+                value="*Your project plan will appear here…*",
+                elem_classes=["output-markdown"],
+            )
+
+    generate_btn.click(
+        fn=generate_project,
+        inputs=[topic_input, level_input, difficulty_input],
+        outputs=[md_output, pdf_output],
+    )
+
+    gr.Markdown(
+        "<center style='color:#aaa;font-size:0.85rem;margin-top:1rem;'>"
+        "Built with ❤️ using Gradio &amp; Google Gemini &nbsp;|&nbsp; "
+        "Deploy your own on <a href='https://huggingface.co/spaces' target='_blank'>HF Spaces</a>"
+        "</center>"
+    )
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1,3 @@
+gradio>=6.0.0
+google-generativeai>=0.8.3
+fpdf2>=2.8.1