Skip to content
/ vml Public

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

License

Notifications You must be signed in to change notification settings

Cstrp/vml

Repository files navigation

🎬 VML - Video Maker Library

License: MIT Node.js TypeScript Nuxt 4 PRs Welcome GitHub stars

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

# 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


Built with ❀️ by @Cstrp


Stargazers over time

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published