https://github.com/cstrp/vml

🎬 Open-source video generator using FFmpeg, Whisper, and Kokoro TTS — REST-ready and optimized for automation.
https://github.com/cstrp/vml

ai audio ffmpeg instagram-reels langchain nodejs nuxt tiktok typescript video whisper-cpp youtube-shorts

Last synced: 3 months ago
JSON representation

🎬 Open-source video generator using FFmpeg, Whisper, and Kokoro TTS — REST-ready and optimized for automation.

• Host: GitHub
• URL: https://github.com/cstrp/vml
• Owner: Cstrp
• License: mit
• Created: 2025-08-01T10:32:38.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-08-04T15:59:10.000Z (11 months ago)
• Last Synced: 2025-08-04T19:31:20.238Z (11 months ago)
• Topics: ai, audio, ffmpeg, instagram-reels, langchain, nodejs, nuxt, tiktok, typescript, video, whisper-cpp, youtube-shorts
• Language: TypeScript
• Homepage:
• Size: 591 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🎬 VML - Video Maker Library

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)

[![TypeScript](https://img.shields.io/badge/TypeScript-5.8%2B-blue.svg)](https://www.typescriptlang.org/)

[![Nuxt 4](https://img.shields.io/badge/Nuxt-4.0-00C58E.svg)](https://nuxt.com/)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

[![GitHub stars](https://img.shields.io/github/stars/Cstrp/vml?style=social)](https://github.com/Cstrp/vml/stargazers)

> **AI-powered video creation platform for TikTok, Instagram Reels, and YouTube Shorts**

## ✨ Features

🎥 **Short-form Video Generation** • Create engaging videos for social platforms  

🎵 **AI Text-to-Speech** • 9 high-quality voices with Kokoro TTS  

📝 **Auto Captions** • Speech-to-text with Whisper.cpp  

🎬 **Stock Video Integration** • HD footage from Pexels API  

⚡ **REST API** • Full programmatic access  

🔍 **Health Monitoring** • Real-time service status

## 🚀 Quick Start

```bash

# Clone and install

git clone https://github.com/Cstrp/vml.git

cd vml && pnpm install

# Setup AI models

pnpm setup

# Configure environment

cp .env.example .env

# Add your PEXELS_API_KEY

# Start development server

pnpm dev

```

Visit `http://localhost:3000` 🎉

## 🏗️ Tech Stack

**Frontend:** Nuxt 4 • Vue 3 • TypeScript • Tailwind CSS  

**Backend:** Nitro • H3 • Pino  

**AI/Media:** Whisper.cpp • Kokoro TTS • FFmpeg • Pexels API

## 📸 Demo

> Screenshots and demo videos coming soon!

## 🎯 Roadmap

- [ ] **Video Pipeline** - Complete end-to-end rendering

- [ ] **Batch Processing** - Multiple video generation

- [ ] **Custom Templates** - Pre-built video templates

- [ ] **Docker Support** - Containerized deployment

## 🤝 Contributing

1. Fork the repo

2. Create feature branch: `git checkout -b feature/name`

3. Commit changes: `git commit -m 'Add feature'`

4. Push branch: `git push origin feature/name`

5. Open Pull Request

## 📄 License

MIT [LICENSE](LICENSE)

---



  Built with ❤️ by @Cstrp



---

[![Stargazers over time](https://starchart.cc/Cstrp/vml.svg?variant=adaptive)](https://starchart.cc/Cstrp/vml)