{"id":28293440,"url":"https://github.com/abdoomohamedd/multi-agent-youtube-summarizer-system","last_synced_at":"2026-01-27T05:09:28.943Z","repository":{"id":292769737,"uuid":"981870313","full_name":"AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System","owner":"AbdooMohamedd","description":"This system uses CrewAI's multi-agent architecture to transform YouTube videos into concise, professional summaries with minimal user input","archived":false,"fork":false,"pushed_at":"2025-05-14T06:47:30.000Z","size":522,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T22:39:18.691Z","etag":null,"topics":["agent","agents","agents-sdk","ai","artificial-intelligence","crewai","crewai-rag","crewai-tools","machine-learning","youtube","youtube-summarization","youtube-summarizer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AbdooMohamedd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-12T03:02:54.000Z","updated_at":"2025-05-14T06:54:17.000Z","dependencies_parsed_at":"2025-05-12T04:30:09.796Z","dependency_job_id":null,"html_url":"https://github.com/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System","commit_stats":null,"previous_names":["abdoomohamedd/multi-agent-youtube-summarizer-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdooMohamedd%2FMulti-Agent-YouTube-Summarizer-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdooMohamedd%2FMulti-Agent-YouTube-Summarizer-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdooMohamedd%2FMulti-Agent-YouTube-Summarizer-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdooMohamedd%2FMulti-Agent-YouTube-Summarizer-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbdooMohamedd","download_url":"https://codeload.github.com/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdooMohamedd%2FMulti-Agent-YouTube-Summarizer-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28803648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T03:44:14.111Z","status":"ssl_error","status_checked_at":"2026-01-27T03:43:33.507Z","response_time":168,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agents","agents-sdk","ai","artificial-intelligence","crewai","crewai-rag","crewai-tools","machine-learning","youtube","youtube-summarization","youtube-summarizer"],"created_at":"2025-05-22T06:13:12.193Z","updated_at":"2026-01-27T05:09:28.938Z","avatar_url":"https://github.com/AbdooMohamedd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Multi-Agent YouTube Video Summarizer\n\n![YouTube Video Summarizer Banner](https://github.com/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System/blob/main/YouTube-Video-Summarizer-System-Flowchart.png)\n\n## 📋 Overview\n\nThis system uses CrewAI's multi-agent architecture to transform YouTube videos into concise, professional summaries with minimal user input. Perfect for researchers, students, and professionals who need to quickly extract valuable information from video content.\n\n## 🚀 What This System Does\n\nThe YouTube Video Summarizer automates the entire process of:\n\n1. Extracting the complete transcript from any YouTube video\n2. Cleaning and preprocessing the raw transcript\n3. Creating a professional, well-structured summary\n4. Evaluating the summary for accuracy and completeness\n5. Generating a PDF document of the approved summary\n\nAll with just one command and a YouTube URL!\n\n## 🔄 Workflow\n\n```\nYouTube URL → Extract Transcript → Preprocess → Summarize → Evaluate → Generate PDF\n```\n\n1. **Input**: User provides a YouTube video URL\n2. **Extraction**: System pulls the complete transcript from the video\n3. **Preprocessing**: Raw transcript is cleaned and formatted\n4. **Summarization**: AI generates a comprehensive, structured summary\n5. **Evaluation**: Summary is assessed for quality and completeness\n6. **Output**: Approved summaries are saved as both Markdown and PDF\n\n## 👥 Agent System Design\n\nThis project uses a specialized team of 5 AI agents, each with a dedicated role:\n\n### 1. Transcript Extractor Agent\n\n- **Task**: Extract the complete transcript from a YouTube video\n- **Input**: YouTube URL\n- **Output**: Raw transcript text (saved to `transcript.md`)\n- **Tools**: `youtube-transcript-api`\n\n### 2. Preprocessing Agent\n\n- **Task**: Clean and prepare the transcript for summarization\n- **Input**: Raw transcript from Agent 1\n- **Output**: Cleaned, well-formatted text\n- **Process**: Removes timestamps, repetitions, filler words, and fixes formatting issues\n\n### 3. Summarization Agent\n\n- **Task**: Generate a comprehensive, well-structured summary\n- **Input**: Preprocessed transcript from Agent 2\n- **Output**: Professional summary with headings, sections, and key points\n- **Features**: Creates markdown formatting, proper structure, and logical organization\n\n### 4. Evaluation Agent\n\n- **Task**: Assess summary quality and accuracy\n- **Input**: Original transcript and generated summary\n- **Output**: Approved summary (saved to `summary.md`) or rejection message\n- **Quality Standard**: Only approves summaries scoring 7/10 or higher\n\n### 5. PDF Generation\n\n- **Task**: Convert the approved markdown summary to a professional PDF\n- **Input**: `summary.md` file\n- **Output**: `summary.pdf` in the project directory\n- **Tools**: `markdown-pdf` library\n\n## 💻 How to Run the System\n\n### Installation\n\n1. Clone the repository:\n\n   ```powershell\n   git clone https://github.com/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System.git\n   cd Multi-Agent-YouTube-Summarizer-System\n   ```\n\n2. Create and activate a virtual environment:\n\n   ```powershell\n   python -m venv venv\n   .\\venv\\Scripts\\Activate.ps1\n   ```\n\n3. Install dependencies:\n\n   ```powershell\n   pip install -r requirements.txt\n   ```\n\n4. Set up your OpenAI API key:\n   - Create a `.env` file in the root directory\n   - Add your API key: `OPENAI_API_KEY=your_api_key_here`\n\n### Usage\n\nRun the system with the following command:\n\n```powershell\npython .\\src\\youtube_video_summarizer\\main.py --url \"https://www.youtube.com/watch?v=OKuu2BVfMhM\"\n```\n\n## 🧪 Test Results\n\nWe've successfully tested the system on this YouTube video:\n[https://www.youtube.com/watch?v=OKuu2BVfMhM](https://www.youtube.com/watch?v=OKuu2BVfMhM)\n\nThe summary and PDF were automatically generated and saved to the project directory.\n\nYou can find the generated PDF at: `youtube_video_summarizer/summary.pdf`\n\nHere's a preview of the generated PDF:  \n[Generated PDF Preview](https://github.com/AbdooMohamedd/Multi-Agent-YouTube-Summarizer-System/blob/main/youtube_video_summarizer/summary.pdf)\n\n## ✅ Project Outputs\n\nFor each video, the system produces:\n\n- `transcript.md` - The raw transcript extracted from the video\n- `summary.md` - The cleaned, professionally formatted summary\n- `summary.pdf` - A PDF version of the summary for easy sharing\n\n## 🔧 Technical Details\n\n- **Python Version**: 3.10+\n- **Key Dependencies**:\n  - CrewAI for the multi-agent architecture\n  - OpenAI API for summarization and evaluation\n  - youtube-transcript-api for transcript extraction\n  - markdown-pdf for PDF generation\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🙏 Acknowledgements\n\n- CrewAI for the multi-agent framework\n- OpenAI for the language processing capabilities\n- YouTube API for transcript access\n\n## 📬 Contact\n\nFor questions or feedback, please open an issue on the GitHub repository or contact the project maintainer.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdoomohamedd%2Fmulti-agent-youtube-summarizer-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdoomohamedd%2Fmulti-agent-youtube-summarizer-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdoomohamedd%2Fmulti-agent-youtube-summarizer-system/lists"}