https://github.com/juninmd/quiz-shorts-generator

https://github.com/juninmd/quiz-shorts-generator

Last synced: 3 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/juninmd/quiz-shorts-generator
• Owner: juninmd
• Created: 2026-03-11T03:00:49.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2026-07-21T05:02:53.000Z (7 days ago)
• Last Synced: 2026-07-23T10:18:13.732Z (4 days ago)
• Language: TypeScript
• Size: 30.5 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Roadmap: ROADMAP.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# 🚀 Quiz Shorts Generator

[![Status: Active](https://img.shields.io/badge/Status-Active-brightgreen.svg)]()

[![Protocol: Antigravity](https://img.shields.io/badge/Protocol-Antigravity-orange.svg)]()

> A modern, high-performance project built with **Python 3.x**. Orchestrated under the Antigravity protocol.

## ✨ Features

- **High Performance**: Optimized for speed and low resource usage using hardware acceleration and parallel processing.

- **Clean Architecture**: Built following strict Antigravity guidelines with a fully asynchronous core.

- **Automated**: Integrated with modern CI/CD and verification scripts.

## 🚀 Performance & Architecture

The project has been heavily optimized for throughput and reliability:

- **Asynchronous Engine**: All heavy operations (FFmpeg, TTS, I/O) are non-blocking, ensuring maximum CPU utilization.

- **Parallel Pipeline**: Asset preparation (TTS, background, metadata) runs in parallel using `Promise.all`.

- **Hardware Acceleration**: Automatic FFmpeg hardware acceleration (`-hwaccel auto`) for faster video encoding.

- **Full Coverage**: 100% test coverage ensured with an asynchronous-first testing suite.

## 🛠️ Tech Stack

- **Primary Technology**: Python 3.x / Node.js

- **Architecture**: Modular and domain-driven.

## 🔑 Environment Variables

To fully run the project, including the automated YouTube Shorts post logic, make sure to set up the following environment variables:

- `OLLAMA_HOST`: The host URL for Ollama (default: `http://localhost:11434`).

- `OLLAMA_MODEL`: The Ollama model to use (default: `qwen2.5:1.5b`).

- `TELEGRAM_TOKEN`: Bot token for uploading the video via Telegram.

- `TELEGRAM_CHAT_ID`: The chat ID for the destination in Telegram.

- `YOUTUBE_CLIENT_ID`: OAuth2 Client ID for YouTube API.

- `YOUTUBE_CLIENT_SECRET`: OAuth2 Client Secret for YouTube API.

- `YOUTUBE_REFRESH_TOKEN`: OAuth2 Refresh Token that is authorized for your channel.

- `YOUTUBE_CHANNEL_NAME`: (Optional) The name of the target channel to help Ollama generate personalized metadata.

## 🛡️ Antigravity Protocol

This project follows the **Antigravity** code standards:

- **150-Line Limit**: Applied to all logic modules.

- **Strict Typing**: Avoiding dynamic/any types.

- **Clean Code**: DRY, KISS, and SOLID principles applied rigorously.

---

*"Simplicity is the ultimate sophistication."*