---
title: YouTube Tutorial to Step-by-Step Guide
emoji: 🎬
colorFrom: blue
colorTo: yellow
sdk: gradio
sdk_version: 5.22.0
app_file: app.py
pinned: false
license: mit
short_description: Convert YouTube tutorials into editable step-by-step guides
---

# YouTube Tutorial to Step-by-Step Guide Generator

This Hugging Face Space application converts YouTube tutorials into editable, time-stamped step-by-step guides. The application extracts key instructions from tutorial videos and presents them in a clean, user-friendly format that can be easily modified.

## Features

- Extract and process video transcripts with timestamps
- Generate structured step-by-step instructions
- Include accurate timestamps for each instruction
- Detect and format code snippets
- Provide a lightweight editor for customization
- Export guides as Markdown

## Usage

1. Enter a YouTube video URL in the input field
2. Click "Generate Guide"
3. View the generated guide with timestamps
4. Edit the guide as needed
5. Export as Markdown

## Limitations

- Works best with videos that have accurate captions
- Processing large videos may take longer
- Code detection is basic and may miss some snippets

## Technical Details

This application is optimized to run efficiently on a Hugging Face Space with 2 vCPU and 16 GB RAM (free tier). It uses:

- SmoLAgent framework for lightweight, efficient processing
- YouTube's transcript API for text extraction
- Intelligent content segmentation based on YouTube chapters
- Client-side processing for UI enhancements

## License

This project is licensed under the MIT License.

## Acknowledgements

- Built with Gradio and SmoLAgent
- Hosted on Hugging Face Spaces