Update app.py

app.py

@@ -1,7 +1,12 @@
-# File: app.py
+# File: app_SeoPlan2Article.py
 import gradio as gr
 import google.generativeai as genai
 import textstat
+import os
+# from dotenv import load_dotenv # Optional: if you want to use .env files for API key
+
+# Optional: Load environment variables if you use a .env file
+# load_dotenv()
 
 # Humanizer helper
 def humanize_text(text):
@@ -11,78 +16,167 @@ def humanize_text(text):
         "It is important to note": "Here's what you need to know",
         "Furthermore": "Also",
         "However": "But",
-        "Therefore": "So"
+        "Therefore": "So",
+        "In the realm of": "When it comes to",
+        "The landscape of": "Thinking about",
+        "It's crucial to": "You'll want to"
     }
+    # Using regex for case-insensitive replacement and whole word matching for some
+    import re
     for old, new in replacements.items():
+        # Basic replacement for most
         text = text.replace(old, new)
+        # Case-insensitive for some common ones if needed
+        # text = re.sub(r'\b' + re.escape(old) + r'\b', new, text, flags=re.IGNORECASE)
     return text
 
 # Readability analysis
 def analyze_readability(text):
-    flesch = textstat.flesch_kincaid_grade(text)
-    sentence_length = round(sum(len(sent.split()) for sent in text.split('.')) / len(text.split('.')), 1)
-    return f"Readability Analysis:\n- Flesch-Kincaid Grade Level: {flesch}\n- Average Sentence Length: {sentence_length} words"
-
-# Title variations
-def generate_title_variations():
-    return [
-        "Kombucha Brewing 101: No Mold, No Stress",
-        "The 7-Day Kombucha Recipe Even Newbies Can Master",
-        "DIY Kombucha: Step-by-Step Guide to Brew Like a Pro"
-    ]
+    try:
+        flesch = textstat.flesch_kincaid_grade(text)
+        # Robust sentence splitting and counting
+        sentences = [s for s in text.split('.') if s.strip()]
+        num_sentences = len(sentences) if len(sentences) > 0 else 1 # Avoid division by zero
+        words = text.split()
+        num_words = len(words)
+        sentence_length = round(num_words / num_sentences, 1) if num_sentences > 0 else 0
+        return f"Readability Analysis:\n- Flesch-Kincaid Grade Level: {flesch}\n- Average Sentence Length: {sentence_length} words"
+    except Exception as e:
+        return f"Readability Analysis: Error ({e})"
+
+
+# Dynamic Title variations
+def generate_title_variations(api_key, primary_keyword, tone, pov):
+    if not primary_keyword:
+        return ["Please provide a primary keyword for title generation."]
+    try:
+        # genai.configure(api_key=api_key) # Configure if not already configured globally
+        model = genai.GenerativeModel('gemini-1.5-pro-latest') # Using latest
+        prompt = f"""
+        Generate 3 compelling, SEO-friendly H1 title variations for an article about "{primary_keyword}".
+        The tone should be {tone} and from a {pov} perspective.
+        Keep them concise and engaging.
+        Format as a numbered list. Ensure each title is on a new line starting with number and period.
+        Example:
+        1. Title Variation 1
+        2. Title Variation 2
+        3. Title Variation 3
+        """
+        response = model.generate_content(prompt)
+        titles = []
+        # Improved parsing for Gemini's potential list format
+        for line in response.text.strip().split('\n'):
+            if '. ' in line and line.strip()[0].isdigit(): # Check if line starts with "1. ", "2. " etc.
+                try:
+                    titles.append(line.split('. ', 1)[1])
+                except IndexError:
+                    titles.append(line) # Fallback if split fails unexpectedly
+            elif line.strip(): # Add non-empty lines if parsing fails
+                titles.append(line.strip())
+
+        return titles if titles else ["Could not generate titles. Gemini response was empty or unparseable."]
+    except Exception as e:
+        return [f"Error generating titles: {str(e)}"]
 
 # Main generation function
-def generate_article(api_key, seo_plan, pov, tone, length, emotion, include_titles, include_readability, internal_links, keywords):
+def generate_article(api_key_input, primary_keyword_text, seo_plan, pov, tone, length, emotion,
+                     include_titles, include_readability, target_keywords_raw, links_to_include_raw, cta_text=""):
     try:
-        # Configure Gemini API dynamically
-        genai.configure(api_key=api_key.strip())
+        api_key_to_use = os.getenv("GEMINI_API_KEY")
+        if api_key_input: # Prioritize textbox input if provided
+            api_key_to_use = api_key_input.strip()
+
+        if not api_key_to_use:
+            return "🚨 Error: API Key not provided. Please enter it in the field or set the GEMINI_API_KEY environment variable."
         
-        # Build prompt
+        genai.configure(api_key=api_key_to_use)
+
+        if not primary_keyword_text:
+            return "🚨 Error: Primary Keyword is required."
+        if not seo_plan:
+            return "🚨 Error: SEO Plan / Article Outline is required."
+
+        # Process links (internal & external)
+        parsed_links_for_prompt = []
+        if links_to_include_raw:
+            for line in links_to_include_raw.strip().split('\n'):
+                line = line.strip()
+                if ':' in line:
+                    anchor, url = line.split(':', 1)
+                    anchor = anchor.strip()
+                    url = url.strip()
+                    if anchor and url: # Ensure both parts are non-empty
+                         parsed_links_for_prompt.append(f"- Anchor Text: \"{anchor}\", URL: {url}")
+        links_instruction = "\n".join(parsed_links_for_prompt) if parsed_links_for_prompt else "No specific links provided; link naturally if opportunities arise to relevant internal or external resources."
+
+        # Process target keywords
+        target_keywords_list = [kw.strip() for kw in target_keywords_raw.split(',') if kw.strip()] if target_keywords_raw else []
+        target_keywords_instruction = f"Subtly integrate these target keywords where they fit naturally: {', '.join(target_keywords_list)}." if target_keywords_list else "No additional target keywords provided."
+
+
         prompt = f"""
-        You are a human guide who wants to help readers solve real problems. 
-        Write a {length} article in {pov} POV with a {tone} tone.  
-
-        INSTRUCTIONS:
-        1. Structure:
-           - Use H1: "[H1 TITLE]"
-           - Include all H2/H3 headings from the SEO plan
-           - Add FAQs with simple, conversational answers
-           - Embed internal links at natural points (use exact anchor text)
-
-        2. Style Rules:
-           - Avoid AI clichés
-           - Use contractions (you're, don't, it's)
-           - Add 1 relatable anecdote
-           - Keep paragraphs short (<3 sentences)
-
-        3. Emotional Tone: {emotion}
-           - Example: If "Confidence", say "You've got this!"
-
-        4. Keywords:
-           - Primary keyword: "[PRIMARY KEYWORD]" (2-3x)
-           - Semantic keywords: {keywords} (sprinkle naturally)
-
-        SEO PLAN: {seo_plan}
+        You are an expert human writer, skilled in creating engaging, SEO-friendly content that solves real problems for readers.
+
+        ARTICLE TASK:
+        Write a {length} article in {pov} POV with a {tone} tone. The central focus is the primary keyword: "{primary_keyword_text}".
+
+        CORE INSTRUCTIONS:
+        1.  Headline (H1): Create an H1 title that is compelling, unique, and naturally incorporates the primary keyword: "{primary_keyword_text}". Do NOT just repeat the primary keyword as the H1.
+        2.  Structure: Adhere strictly to the headings (H2s, H3s, etc., as indicated by ##, ###) provided in the 'SEO PLAN / OUTLINE' section below. If no H-tags are in the outline, structure it logically based on the content.
+        3.  Content Style:
+            *   Adopt a {emotion} emotional tone. For example, if "Confidence", use phrases like "You've got this!" or "Rest assured...".
+            *   Write conversationally and engagingly. Use contractions (e.g., you're, it's, don't).
+            *   Incorporate one brief, relatable anecdote relevant to the topic.
+            *   Keep paragraphs short and highly readable (generally 1-3 sentences).
+            *   Strictly AVOID AI clichés, robotic phrasing, and overly formal language (e.g., "In conclusion", "Furthermore", "It is important to note", "The realm of", "The digital landscape"). Be original.
+        4.  Keyword Integration:
+            *   Primary Keyword: "{primary_keyword_text}". Ensure this is used naturally 2-4 times throughout the article, including the H1 (or a close variation), introduction, and conclusion where appropriate.
+            *   Target/Semantic Keywords: {target_keywords_instruction}
+        5.  Link Integration:
+            *   The following links (which may be internal or external) should be embedded at natural and relevant points in the text. Use the exact anchor text and corresponding URL provided for each. Make the integration seamless.
+            Links to Incorporate:
+            {links_instruction}
+        6.  FAQs: If appropriate for the topic (or if specified in the outline), include a Frequently Asked Questions (FAQ) section at the end with 2-4 relevant questions and clear, concise, conversational answers.
+        {f"7. Call to Action: Conclude the article with this specific call to action: \"{cta_text}\"" if cta_text else "7. Call to Action: Conclude with a natural and relevant call to action (e.g., inviting comments, suggesting a next step, or encouraging sharing)."}
+
+        SEO PLAN / OUTLINE:
+        ---
+        {seo_plan}
+        ---
+
+        Begin the article directly with the H1 heading.
         """
 
-        # Gemini API call
-        model = genai.GenerativeModel('gemini-1.5-pro')
+        model = genai.GenerativeModel('gemini-1.5-pro-latest')
         response = model.generate_content(prompt)
+        article_text = response.text
 
-        # Post-processing
-        humanized = humanize_text(response.text)
+        humanized_article = humanize_text(article_text)
         
-        if include_readability:
-            humanized += "\n\n" + analyze_readability(humanized)
-            
+        final_output_parts = []
         if include_titles:
-            titles = generate_title_variations()
-            humanized = "Title Variations:\n" + "\n".join([f"{i+1}. {t}" for i, t in enumerate(titles)]) + "\n\n" + humanized
+            titles = generate_title_variations(api_key_to_use, primary_keyword_text, tone, pov) 
+            final_output_parts.append("✨ **Suggested Title Variations:**\n" + "\n".join([f"    {i+1}. {t}" for i, t in enumerate(titles)]))
+        
+        final_output_parts.append("✍️ **Generated Article:**\n" + humanized_article)
+
+        if include_readability:
+            final_output_parts.append("📊 **Readability Analysis:**\n" + analyze_readability(humanized_article).replace("\n-", "\n    -")) # Indent list items
 
-        return humanized
+        return "\n\n---\n\n".join(final_output_parts)
 
     except Exception as e:
-        return f"🚨 Error: {str(e)}\n\nPlease check your API key or try again later."
+        import traceback
+        print(f"Detailed Error: {traceback.format_exc()}") # Print full traceback to console for debugging
+        error_message = f"🚨 **Critical Error:** {str(e)}\n\n"
+        error_message += "This might be due to:\n"
+        error_message += "- Invalid or expired API Key.\n"
+        error_message += "- Issues with the Gemini API service.\n"
+        error_message += "- Malformed input in the SEO Plan or other fields.\n"
+        error_message += "- An unexpected problem during generation.\n\n"
+        error_message += "Please check your API key, ensure your inputs are correct, and try again. If the issue persists, review the console logs for more details."
+        return error_message
+
 # Enhanced theme
 custom_theme = gr.themes.Soft(
     primary_hue="blue",
@@ -98,70 +192,113 @@ custom_theme = gr.themes.Soft(
 )
 
 # Gradio Interface
-with gr.Blocks(title="SEO Article Generator", theme=custom_theme) as demo:
+with gr.Blocks(title="SEO Article Generator", theme=custom_theme, css=".gradio-container {max-width: 1000px !important; margin: auto;} footer {display: none !important}") as demo:
     gr.Markdown("# SEO-to-Article Generator 🚀")
-    gr.Markdown("Enter your Gemini API key and paste an SEO plan to generate humanized, SEO-optimized content.")
+    gr.Markdown("Transform your SEO plan into humanized, optimized content. Provide your Gemini API key, primary keyword, outline, and linking strategy.")
     
     with gr.Row():
         with gr.Column(scale=1):
-            api_key = gr.Textbox(label="🔑 Gemini API Key", type="password", placeholder="AIzaSy...your-key-here...")
+            api_key_input_ui = gr.Textbox(
+                label="🔑 Gemini API Key",
+                type="password",
+                placeholder="AIzaSy... (or leave blank if GEMINI_API_KEY env var is set)",
+                info="Your Google Gemini API Key. Can also be set as an environment variable."
+            )
             
-            pov = gr.Dropdown(
-                label="📖 Point of View",
-                choices=["First Person", "Second Person", "Third Person"],
-                value="First Person"
+            primary_keyword_ui = gr.Textbox(
+                label="🎯 Primary Keyword (Required)",
+                placeholder="e.g., how to make kombucha",
+                info="The main keyword for the article."
             )
             
-            tone = gr.Dropdown(
-                label="🎨 Blog Tone",
-                choices=["Friendly Guide", "Professional Expert", "Step-by-Step Teacher", "Curious Explorer"],
-                value="Friendly Guide"
+            target_keywords_ui = gr.Textbox( # RENAMED and PURPOSE CLARIFIED
+                label="➕ Target/Semantic Keywords (Optional)",
+                placeholder="e.g., SCOBY, probiotics, fermentation, homebrew kombucha benefits",
+                lines=3,
+                info="Comma-separated list of additional keywords to include naturally."
+            )
+
+            links_to_include_ui = gr.Textbox( # RENAMED and PURPOSE CLARIFIED
+                label="🔗 Internal & External Links to Include (Optional)",
+                placeholder="Benefit of Kombucha: https://example.com/kombucha-benefits\nAuthoritative Fermentation Guide: https://trusted-site.org/fermentation",
+                lines=4,
+                info="Format: Anchor Text: URL (one link per line). Both internal and external links."
             )
             
-            length = gr.Dropdown(
-                label="📄 Content Length",
-                choices=["Short (500)", "Standard (800)", "Long (1200+)"],
-                value="Standard"
+            pov_ui = gr.Dropdown(
+                label="📖 Point of View",
+                choices=["First Person (I/We)", "Second Person (You/Your)", "Third Person (He/She/It/They)"],
+                value="Second Person (You/Your)"
             )
             
-            emotion = gr.Dropdown(
-                label="🧠 Emotional Tone",
-                choices=["Trust", "Clarity", "Confidence", "Curiosity"],
-                value="Trust"
+            tone_ui = gr.Dropdown(
+                label="🎨 Article Tone",
+                choices=["Friendly Guide", "Professional Expert", "Step-by-Step Teacher", "Curious Explorer", "Inspirational Motivator", "Witty & Humorous"],
+                value="Friendly Guide"
             )
             
-            internal_links = gr.Textbox(
-                label="🔗 Internal Links",
-                placeholder="https://example.com/page1 \nhttps://example.com/page2 ",
-                lines=3
+            length_ui = gr.Dropdown(
+                label="📄 Content Length",
+                choices=["Short (~400-600 words)", "Standard (~700-1000 words)", "Long (~1100-1500+ words)"],
+                value="Standard (~700-1000 words)"
             )
             
-            keywords = gr.Textbox(
-                label="🔑 Extra Keywords",
-                placeholder="SCOBY, probiotics, fermentation",
-                lines=3
+            emotion_ui = gr.Dropdown(
+                label="🧠 Desired Emotional Impact",
+                choices=["Trust", "Clarity", "Confidence", "Curiosity", "Excitement", "Empathy", "Reassurance"],
+                value="Confidence"
+            )
+
+            cta_text_ui = gr.Textbox(
+                label="📢 Call to Action (Optional)",
+                placeholder="e.g., Share your kombucha brewing experiences in the comments below!",
+                info="A specific CTA for the end of the article. If blank, AI will generate one."
             )
             
-            include_titles = gr.Checkbox(label="Generate Title Variations", value=True)
-            include_readability = gr.Checkbox(label="Show Readability Analysis", value=True)
+            include_titles_ui = gr.Checkbox(label="Suggest 3 Title Variations", value=True)
+            include_readability_ui = gr.Checkbox(label="Show Readability Analysis", value=True)
             
         with gr.Column(scale=2):
-            seo_plan = gr.Textbox(
-                label="📄 Paste Your SEO Plan",
-                placeholder="Primary Keyword: how to make kombucha\nSecondary Keywords: kombucha recipe...\n...",
-                lines=15
+            seo_plan_ui = gr.Textbox(
+                label="📋 SEO Plan / Article Outline (Required)",
+                placeholder=(
+                    "Example:\n"
+                    "## What is Kombucha?\n"
+                    "### Brief History\n"
+                    "### Why Drink It?\n\n"
+                    "## Key Ingredients for Homemade Kombucha\n"
+                    "### SCOBY Explained\n"
+                    "### Best Tea for Kombucha\n\n"
+                    "## Step-by-Step Kombucha Brewing Guide\n"
+                    "### First Fermentation (F1)\n"
+                    "### Second Fermentation (F2) for Flavor & Fizz\n\n"
+                    "## Common Kombucha Problems & Solutions\n"
+                    "### Preventing Mold\n\n"
+                    "## FAQs\n"
+                    "   - How long does kombucha last?\n"
+                    "   - Can I use a different sugar?"
+                ),
+                lines=20, # Increased lines
+                info="Paste your detailed article outline. Use ## for H2, ### for H3. Include specific questions for FAQs if desired."
             )
             
-            submit_btn = gr.Button("✨ Generate Article", variant="primary")
+            submit_btn = gr.Button("✨ Generate Article", variant="primary", elem_id="generate_button") # Added elem_id for potential CSS
             
-            output = gr.Textbox(label="📝 Generated Article", lines=20)
+            output_ui = gr.Markdown(label="📝 Generated Output", elem_id="output_markdown") # Changed to Markdown for better formatting of titles/readability
 
     submit_btn.click(
         fn=generate_article,
-        inputs=[api_key, seo_plan, pov, tone, length, emotion, include_titles, include_readability, internal_links, keywords],
-        outputs=output
+        inputs=[
+            api_key_input_ui, primary_keyword_ui, seo_plan_ui, pov_ui, tone_ui,
+            length_ui, emotion_ui, include_titles_ui, include_readability_ui,
+            target_keywords_ui, links_to_include_ui, cta_text_ui
+        ],
+        outputs=output_ui,
+        # show_progress="full" # Uncomment for Gradio's built-in progress indicator
     )
+    gr.Markdown("--- \n *Powered by Google Gemini. Ensure your API key has the Generative Language API enabled.*")
+
 
 # Launch app
 if __name__ == "__main__":
-    demo.launch()
+    demo.launch(share=False) # Set share=True to get a public link if needed (for temporary sharing)