Spaces:
Sleeping
Sleeping
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) | |