https://github.com/guillaumeast/mentorai
Turn any YouTube channel into a full Custom GPT (avatar, settings, transcripts)
https://github.com/guillaumeast/mentorai
automation bash cli gpt llm prompt-engineering text-processing transcripts youtube
Last synced: 2 months ago
JSON representation
Turn any YouTube channel into a full Custom GPT (avatar, settings, transcripts)
- Host: GitHub
- URL: https://github.com/guillaumeast/mentorai
- Owner: guillaumeast
- Created: 2025-06-21T15:07:24.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-10-04T19:59:10.000Z (9 months ago)
- Last Synced: 2025-10-04T21:29:35.116Z (9 months ago)
- Topics: automation, bash, cli, gpt, llm, prompt-engineering, text-processing, transcripts, youtube
- Language: Shell
- Homepage:
- Size: 63.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧠 `mentorai` v0.1.0
Minimal YouTube-to-GPT generator – converts any YouTube channel into a ready-to-upload Custom GPT package, **in one CLI command**.
> **`mentorai`** creates a complete Custom GPT pack from any YouTube channel, including profile, prompt, and transcript knowledge –
> so you can talk to your favorite creator, expert, or guru… as if they were right there with you.
[](https://www.gnu.org/software/bash/)
[]()
[](https://en.wikipedia.org/wiki/Unix-like)
[](https://github.com/guillaumeast/mentorai/releases)
---
## ✨ Features
- Fully local – no API keys or cloud services needed
- Only requires [`yt-dlp`](https://github.com/yt-dlp/yt-dlp)
- Supports full channel URLs or YouTube handles (e.g. `@GoogleDevelopers`)
- Outputs everything needed to configure a GPT via [chat.openai.com/gpts](https://chat.openai.com/gpts):
- 🖼️ Profile picture
- 🧠 Cleaned and chunked transcripts (20 files max)
- 🪄 Pre-prompt and GPT settings (name, description, instructions)
- Friendly file structure in `output//`
---
### 🚀 Usage
```bash
./mentorai.bash https://www.youtube.com/@GoogleDevelopers
```
or just:
```bash
./mentorai.bash @GoogleDevelopers
```
Output will be created in:
```bash
output/GoogleDevelopers/
├── avatar.jpg
├── settings.txt
├── prompt.txt
├── transcript-1.txt
├── ...
└── transcript-20.txt
```
---
### 📦 Dependencies
- `yt-dlp` – fetches videos, metadata and subtitles
- `jq` – parses JSON output from `yt-dlp`
- `curl` – checks URLs and downloads channel avatar
- `grep` – cleans subtitle `.srt` files
- `sed` – template variable replacement & filename parsing
- `bash`, `wc`, `xargs` – core shell utilities (standard on macOS/Linux)
Install example (macOS) :
```bash
brew install yt-dlp jq curl grep gnu-sed
```
---
## 🧪 Example
```bash
./mentorai.bash https://www.youtube.com/@GoogleDevelopers
```
Then go to [https://chat.openai.com/gpts](https://chat.openai.com/gpts) and:
1. Upload `avatar.jpg`
2. Copy-paste settings from `settings.txt`
3. Upload `transcript-*.txt` files
4. Done.
---
## 🧱 Project structure
```
mentorai/
├── README.md
├── mentorai.bash
├── prompt_template.txt
└── output/
└── /
├── avatar.png
├── settings/
└── knowledge/
```
---
> _"Turn inspiration into conversation — one channel at a time.”_ 🎙️