app.py

import os
import gradio as gr

def generate_scaffold(tech_stack: str) -> str:
    """
    Simulate a detailed step-by-step guide for setting up a project using the given tech stack.
    The output includes installation instructions, a suggested project structure, and clickable markdown links
    to the official documentation for each technology.
    
    Parameters:
        tech_stack (str): A comma-separated list of technologies (e.g., "React, Node.js, MongoDB")
    
    Returns:
        str: A markdown-formatted guide.
    """
    tech_list = [tech.strip() for tech in tech_stack.split(",") if tech.strip()]
    if not tech_list:
        return "No tech stack provided. Please enter at least one technology."
    
    guide = "## Project Setup Guide\n\n"
    guide += "### Installation Instructions\n"
    
    for idx, tech in enumerate(tech_list, start=1):
        # Create a clickable markdown link that searches for the official documentation.
        doc_link = f"[Official {tech} Documentation](https://www.google.com/search?q={tech}+official)"
        guide += f"{idx}. **Install {tech}:**\n   - Follow instructions here: {doc_link}\n\n"
    
    guide += "### Recommended Project Structure\n"
    guide += "- `src/` : Contains your source code\n"
    guide += "- `public/` : Contains public assets (e.g., images, static files)\n"
    guide += "- `package.json` or `requirements.txt` : Project configuration and dependencies\n"
    guide += "- `README.md` : Project documentation\n\n"
    
    guide += "### Setup Steps\n"
    guide += "1. Install the above technologies using the provided commands/instructions.\n"
    guide += "2. Create your project structure as suggested.\n"
    guide += "3. Initialize your project (e.g., using `npm init` for Node.js projects or creating a virtual environment for Python projects).\n\n"
    
    guide += "---\n"
    guide += "*Thank you for using our Automated Tech Stack Setup Assistant! Feel free to try another tech stack or provide feedback.*"
    
    return guide

def gradio_interface(tech_stack_input: str) -> str:
    """Interface function to generate the project guide from the tech stack input."""
    return generate_scaffold(tech_stack_input)

# Friendly welcome message and instructions.
title = "Welcome to the Automated Tech Stack Setup Assistant!"
description = (
    "Hello there! This is your friendly assistant to help you quickly set up a development project. "
    "Enter your desired tech stack below (e.g., **React, Node.js, MongoDB**) and get a step-by-step guide "
    "with installation instructions, project structure recommendations, and clickable links to official documentation.\n\n"
    "### How to Use:\n"
    "1. Type your tech stack in the input box.\n"
    "2. Click the **Submit** button.\n"
    "3. View your detailed project setup guide in markdown format.\n"
    "4. Click on any link to visit the official website for more information.\n\n"
    "Enjoy your coding journey!"
)

# Build the Gradio interface with examples.
iface = gr.Interface(
    fn=gradio_interface,
    inputs=gr.Textbox(lines=2, placeholder="Enter tech stack (e.g., React, Node.js, MongoDB)"),
    outputs="markdown",
    title=title,
    description=description,
    examples=[["React, Node.js, MongoDB"], ["Next.js, Express, PostgreSQL"], ["Vue, Django, Redis"]]
)

if __name__ == "__main__":
    iface.launch(share=True)