How drakollla/recipescribe works
RecipeScribe turns video URLs or manually entered recipes into structured, searchable recipes, with a Web UI as the recommended interface and a Telegram bot as an additional client. Video extraction follows the documented fallback sequence: video description, pinned author comments, then yt-dlp audio download and Whisper transcription; LLM parsing structures the result. The API also supports recipe scaling, substitutions, step rewriting, exports, meal planning, and LLM profile management. The graph reflects README capabilities and indexed source references; several implementation paths are unsampled, so uncertain links are omitted.
Main entry points: RecipesController.cs Recipe endpoints · Program.cs HTTP API · RecipeExtractorService.cs Extraction coordinator · RecipeRepository.cs Recipe repository
Components 29
Web API
- Web UI
RecipeScribeApi/wwwroot/app.js - HTTP API
RecipeScribeApi/Program.cs - Recipe endpoints
RecipeScribeApi/Controllers/RecipesController.cs - Meal plan endpoints
RecipeScribeApi/Controllers/MealPlansController.cs - LLM profile endpoints
RecipeScribeApi/Controllers/LlmProfilesController.cs
Telegram client
- Telegram bot
TelegramBot/TelegramBotService.cs - Bot workflows
TelegramBot/TelegramRecipeFlow.cs - Recipe API client
TelegramBot/ApiClients/RecipeApiClient.cs - Meal plan API client
TelegramBot/ApiClients/MealPlanApiClient.cs
Recipe extraction
- Extraction coordinator
Infrastructure/Services/RecipeExtractorService.cs - YouTube downloader
Infrastructure/YouTubeDownloader.cs - Whisper transcriber
Infrastructure/WhisperTranscriber.cs - LLM recipe parser
Infrastructure/RecipeParser.cs - LLM provider
Infrastructure/Providers/OpenAiProvider.cs
Recipe services
- LLM retry helper
Infrastructure/Helpers/LlmRetryHelper.cs - Meal planning
Infrastructure/Services/MealPlannerService.cs - Recipe scaling
Infrastructure/Services/ScalingService.cs - Ingredient substitutions
Infrastructure/Services/LlmSubstitutionService.cs - Step rewriting
Infrastructure/Services/StepRewriteService.cs - Markdown export
Infrastructure/Exporters/MarkdownRecipeExporter.cs
Persistence
- Recipe repository
Infrastructure/Database/RecipeRepository.cs - Meal plan repository
Infrastructure/Database/MealPlanRepository.cs - SQLite database
Infrastructure/Database/RecipeDbContext.cs - LLM profile store
Infrastructure/Services/LlmProfileStore.cs
Other components
- Web user
- Telegram user
- YouTube
- LLM endpoint
- Whisper
Connections 34
- Web user → Web UI: uses
README.md - Web UI → HTTP API: calls
README.md - Telegram user → Telegram bot: messages
README.md - Telegram bot → Bot workflows: dispatches
TelegramBot/TelegramBotService.cs - Bot workflows → Recipe API client: requests recipes
TelegramBot/Extensions/TgServiceCollectionExtensions.cs - Bot workflows → Meal plan API client: requests plans
TelegramBot/Extensions/TgServiceCollectionExtensions.cs - Recipe API client → HTTP API: HTTP requests
TelegramBot/ApiClients/RecipeApiClient.cs - Meal plan API client → HTTP API: HTTP requests
TelegramBot/ApiClients/MealPlanApiClient.cs - HTTP API → Recipe endpoints: routes
- HTTP API → Meal plan endpoints: routes
- HTTP API → LLM profile endpoints: routes
- Recipe endpoints → Extraction coordinator: extracts recipes
RecipeScribeApi/Controllers/RecipesController.cs - Recipe endpoints → Recipe repository: reads and saves
RecipeScribeApi/Controllers/RecipesController.cs - Recipe endpoints → Recipe scaling: rescales
RecipeScribeApi/Controllers/RecipesController.cs - Recipe endpoints → Ingredient substitutions: gets suggestions
RecipeScribeApi/Controllers/RecipesController.cs - Recipe endpoints → Step rewriting: rewrites steps
RecipeScribeApi/Controllers/RecipesController.cs - Recipe endpoints → Meal plan repository: reads user settings
RecipeScribeApi/Controllers/RecipesController.cs - Meal plan endpoints → Meal planning: plans meals
RecipeScribeApi/Controllers/MealPlansController.cs - Meal plan endpoints → Recipe repository: reads recipes
RecipeScribeApi/Controllers/MealPlansController.cs - LLM profile endpoints → LLM profile store: manages profiles
RecipeScribeApi/Controllers/LlmProfilesController.cs - Extraction coordinator → YouTube downloader: downloads audio
README.md - Extraction coordinator → Whisper transcriber: transcribes audio
README.md - Extraction coordinator → LLM recipe parser: structures recipe
README.md - YouTube downloader → YouTube: fetches media
README.md - Whisper transcriber → Whisper: recognizes speech
README.md - LLM recipe parser → LLM provider: prompts
Infrastructure/RecipeParser.cs - LLM provider → LLM endpoint: sends prompts
- LLM recipe parser → LLM retry helper: retries calls
Infrastructure/RecipeParser.cs - Ingredient substitutions → LLM retry helper: retries calls
Infrastructure/Services/LlmSubstitutionService.cs - Meal planning → Meal plan repository: reads and updates
Infrastructure/Services/MealPlannerService.cs - Meal planning → Recipe repository: uses scaling
Infrastructure/Services/MealPlannerService.cs - Recipe repository → SQLite database: queries and saves
Infrastructure/Database/RecipeRepository.cs - Meal plan repository → SQLite database: queries and saves
Infrastructure/Database/MealPlanRepository.cs - Recipe endpoints → Markdown export: exports markdown