oneword-ai 0.1.2

Create viral-style one-word subtitles for Reels, Shorts & TikToks using AI. Perfect for content creators!

🎬 OneWord AI - Cinematic Subtitle Generator

Generate viral-style one-word subtitles from video/audio using Whisper AI

Perfect for creating high-energy reels, shorts, and TikToks! 🚀

Installation • Usage • Features • Credits

---

✨ Features

• 🎯 Three Subtitle Modes: One Word, Two Word Punch, Phrase Mode
• 🌍 Multi-Language Support: Auto-detect or specify (English, Hindi, Urdu, Spanish)
• 🤖 Multiple AI Models:
  • OpenAI Whisper (Medium, Large)
  • Hindi2Hinglish (Oriserve/Whisper-Hindi2Hinglish-Prime) 🇮🇳
• 💻 Dual Interface: CLI for power users, Web UI for visual workflow
• 📦 Easy Installation: One-line pip install
• ☁️ Cloud Ready: Works seamlessly on Google Colab

---

🚀 Installation

pip install oneword-ai

Prerequisites: Install FFmpeg on your system.

---

📖 Usage

Option 1: Web Interface (Easiest)

Start the web server:

python -m onewordai.api.main

Then open http://localhost:8000 in your browser.

Features:

• 📤 Drag & drop file upload
• 📊 Real-time download progress with speed & ETA
• ⏱️ Live transcription status updates
• ❌ Cancel processing anytime
• ⚠️ Reload protection (won't lose progress)
• 📥 Instant SRT download

---

Option 2: Google Colab

Run OneWord AI in the cloud with Web UI or Python API:

The Colab notebook includes:

• 🌐 Option A: Web UI with Gradio (free public URL, no setup required)
• 💻 Option B: Python API for direct code usage

---

Option 3: Command Line (CLI)

For batch processing and automation:

# Basic usage
python -m onewordai.cli -i video.mp4

# With options
python -m onewordai.cli -i video.mp4 -m medium -lang hi -mode oneword

See CLI.md for full documentation.

---

📊 Subtitle Modes

Mode	Description	Best For
oneword	Each word = separate subtitle	High-energy viral content, reels
twoword	Groups of 2 words	Punchy messaging, Instagram posts
phrase	Full sentence segments	YouTube videos, longer content

---

🎨 Model Options

Model	Size	Speed	Quality	Language
medium	~1.5GB	Fast	⭐⭐⭐⭐	Multi-language
large	~3GB	Slower	⭐⭐⭐⭐⭐	Multi-language
Oriserve/Whisper-Hindi2Hinglish-Prime	~1.5GB	Fast	⭐⭐⭐⭐⭐	Hindi → Hinglish

Note: Models are downloaded automatically on first use and cached locally.

---

🤝 Credits

This project wouldn't be possible without these amazing open-source projects:

Core Technologies

• OpenAI Whisper - State-of-the-art speech recognition model
• Oriserve/Whisper-Hindi2Hinglish-Prime - Fine-tuned Hindi to Hinglish transcription
• HuggingFace Transformers - Model loading and inference framework

Backend & UI

• FastAPI - High-performance Python web framework
• Gradio - ML web interface library
• FFmpeg - Multimedia processing toolkit

Special Thanks

• OpenAI team for making Whisper open-source
• Oriserve team for the specialized Hindi model
• All open-source contributors

---

📜 License

MIT License - see license.txt

Free to use for personal and commercial projects!

---

👨‍💻 Author

Built with ❤️ by Ambrish Yadav

💼 Connect: @ambrish.yadav.1

📦 PyPI: oneword-ai

---

⭐ Star this repo if you find it useful! ⭐

Report Bug • Request Feature