oneword-ai 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. oneword_ai-0.1.1/PKG-INFO +201 -0
  2. oneword_ai-0.1.1/README.md +169 -0
  3. oneword_ai-0.1.1/oneword_ai.egg-info/PKG-INFO +201 -0
  4. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/pyproject.toml +2 -2
  5. oneword_ai-0.1.0/PKG-INFO +0 -237
  6. oneword_ai-0.1.0/README.md +0 -205
  7. oneword_ai-0.1.0/oneword_ai.egg-info/PKG-INFO +0 -237
  8. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/license.txt +0 -0
  9. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/oneword_ai.egg-info/SOURCES.txt +0 -0
  10. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/oneword_ai.egg-info/dependency_links.txt +0 -0
  11. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/oneword_ai.egg-info/entry_points.txt +0 -0
  12. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/oneword_ai.egg-info/requires.txt +0 -0
  13. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/oneword_ai.egg-info/top_level.txt +0 -0
  14. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/__init__.py +0 -0
  15. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/api/__init__.py +0 -0
  16. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/api/main.py +0 -0
  17. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/cli.py +0 -0
  18. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/core/__init__.py +0 -0
  19. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/core/engine.py +0 -0
  20. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/web/app.js +0 -0
  21. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/web/index.html +0 -0
  22. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/web/style.css +0 -0
  23. {oneword_ai-0.1.0 → oneword_ai-0.1.1}/setup.cfg +0 -0
oneword_ai-0.1.1/PKG-INFO ADDED
@@ -0,0 +1,201 @@
1
+ Metadata-Version: 2.4
2
+ Name: oneword-ai
3
+ Version: 0.1.1
4
+ Summary: Create viral-style one-word subtitles for Reels, Shorts & TikToks using AI. Perfect for content creators!
5
+ Author-email: Ambrish <ambrishyadav1110@gmail.com>
6
+ License: Copyright 2025 Ambrish
7
+
8
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
9
+
10
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
11
+
12
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
13
+ Project-URL: Homepage, https://github.com/Ambrishyadav-byte/OnewordAI
14
+ Project-URL: Bug Tracker, https://github.com/Ambrishyadav-byte/OnewordAI/issues
15
+ Keywords: subtitles,ai,whisper,content-creation,video-editing
16
+ Requires-Python: >=3.9
17
+ Description-Content-Type: text/markdown
18
+ License-File: license.txt
19
+ Requires-Dist: openai-whisper>=20231117
20
+ Requires-Dist: torch>=2.0.0
21
+ Requires-Dist: fastapi>=0.100.0
22
+ Requires-Dist: uvicorn[standard]>=0.23.0
23
+ Requires-Dist: python-multipart>=0.0.6
24
+ Requires-Dist: ffmpeg-python>=0.2.0
25
+ Requires-Dist: gradio>=4.0.0
26
+ Requires-Dist: tqdm>=4.65.0
27
+ Requires-Dist: aiofiles>=23.0.0
28
+ Requires-Dist: transformers>=4.30.0
29
+ Requires-Dist: accelerate>=0.20.0
30
+ Requires-Dist: huggingface_hub>=0.16.0
31
+ Dynamic: license-file
32
+
33
+ # 🎬 OneWord AI - Cinematic Subtitle Generator
34
+
35
+ <div align="center">
36
+
37
+ **Generate viral-style one-word subtitles from video/audio using Whisper AI**
38
+
39
+ [![PyPI](https://img.shields.io/pypi/v/oneword-ai)](https://pypi.org/project/oneword-ai/)
40
+ [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
41
+ [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
42
+
43
+ Perfect for creating high-energy reels, shorts, and TikToks! 🚀
44
+
45
+ [Installation](#-installation) • [Usage](#-usage) • [Features](#-features) • [Credits](#-credits)
46
+
47
+ </div>
48
+
49
+ ---
50
+
51
+ ## ✨ Features
52
+
53
+ - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
54
+ - 🌍 **Multi-Language Support**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
55
+ - 🤖 **Multiple AI Models**:
56
+ - OpenAI Whisper (Medium, Large)
57
+ - Hindi2Hinglish (Oriserve/Whisper-Hindi2Hinglish-Prime) 🇮🇳
58
+ - 💻 **Dual Interface**: CLI for power users, Web UI for visual workflow
59
+ - 📦 **Easy Installation**: One-line pip install
60
+ - ☁️ **Cloud Ready**: Works seamlessly on Google Colab
61
+
62
+ ---
63
+
64
+ ## 🚀 Installation
65
+
66
+ ### Method 1: Install from PyPI (Recommended)
67
+
68
+ ```bash
69
+ pip install oneword-ai
70
+ ```
71
+
72
+ **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
73
+
74
+ ---
75
+
76
+ ## 📖 Usage
77
+
78
+ ### Option 1: Web Interface (Easiest)
79
+
80
+ Start the web server and process files through a beautiful UI:
81
+
82
+ ```bash
83
+ # Start server
84
+ python -m onewordai.api.main
85
+ ```
86
+
87
+ Then open http://localhost:8000 in your browser.
88
+
89
+ **Features:**
90
+ - 📤 Drag & drop file upload
91
+ - 📊 Real-time download progress with speed tracking
92
+ - ⏱️ Live transcription status
93
+ - ❌ Cancel processing anytime
94
+ - 📥 Instant SRT download
95
+ - ⚠️ Reload protection (won't lose progress)
96
+
97
+ ---
98
+
99
+ ### Option 2: Google Colab with Package
100
+
101
+ Run OneWord AI in the cloud without any local installation:
102
+
103
+ [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Ambrishyadav-byte/OnewordAI/blob/main/OneWord_Colab.ipynb)
104
+
105
+ **Quick Start in Colab:**
106
+
107
+ ```python
108
+ # Install package
109
+ !pip install oneword-ai
110
+
111
+ # Import and use
112
+ from onewordai.core.engine import SubtitleGenerator
113
+
114
+ # Generate subtitles
115
+ generator = SubtitleGenerator(model_name="medium")
116
+ output = generator.process("video.mp4", mode="oneword")
117
+ print(f"✅ Subtitles saved: {output}")
118
+ ```
119
+
120
+ ---
121
+
122
+ ### Option 3: Command Line Interface (CLI)
123
+
124
+ For batch processing and automation:
125
+
126
+ ```bash
127
+ # Basic usage
128
+ python -m onewordai.cli -i video.mp4
129
+
130
+ # Advanced options
131
+ python -m onewordai.cli -i video.mp4 -m medium -lang hi -mode oneword
132
+ ```
133
+
134
+ **See [CLI.md](CLI.md) for full CLI documentation.**
135
+
136
+ ---
137
+
138
+ ## 📊 Subtitle Modes
139
+
140
+ | Mode | Description | Best For |
141
+ |------|-------------|----------|
142
+ | **One Word** | Each word = separate subtitle | High-energy viral content, reels |
143
+ | **Two Word Punch** | Groups of 2 words | Punchy messaging, Instagram posts |
144
+ | **Phrase Mode** | Full sentence segments | YouTube videos, longer content |
145
+
146
+ ---
147
+
148
+ ## 🎨 Model Options
149
+
150
+ | Model | Size | Speed | Quality | Language Support |
151
+ |-------|------|-------|---------|------------------|
152
+ | **medium** | ~1.5GB | Fast | Good | Multi-language |
153
+ | **large** | ~3GB | Slower | Best | Multi-language |
154
+ | **Hindi2Hinglish** | ~1.5GB | Fast | Excellent for Hindi | Hindi → Hinglish |
155
+
156
+ ---
157
+
158
+ ## 🤝 Credits
159
+
160
+ This project wouldn't be possible without these amazing open-source projects:
161
+
162
+ ### Core Technologies
163
+ - **[OpenAI Whisper](https://github.com/openai/whisper)** - Revolutionary speech recognition model
164
+ - **[Oriserve/Whisper-Hindi2Hinglish-Prime](https://huggingface.co/Oriserve/Whisper-Hindi2Hinglish-Prime)** - Hindi to Hinglish transcription model
165
+ - **[HuggingFace Transformers](https://github.com/huggingface/transformers)** - Model loading and inference
166
+
167
+ ### Backend & UI
168
+ - **[FastAPI](https://fastapi.tiangolo.com/)** - Modern Python web framework
169
+ - **[Gradio](https://gradio.app/)** - ML web interfaces
170
+ - **[FFmpeg](https://ffmpeg.org/)** - Audio/video processing
171
+
172
+ ### Special Thanks
173
+ - OpenAI for making Whisper open-source
174
+ - Oriserve team for the Hindi2Hinglish model
175
+ - All contributors to the dependencies
176
+
177
+ ---
178
+
179
+ ## 📜 License
180
+
181
+ MIT License - see [license.txt](license.txt)
182
+
183
+ Free to use for personal and commercial projects!
184
+
185
+ ---
186
+
187
+ ## 👨‍💻 Author
188
+
189
+ **Built with ❤️ by [Ambrish Yadav](https://github.com/Ambrishyadav-byte)**
190
+
191
+ 💼 Connect: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
192
+
193
+ ---
194
+
195
+ <div align="center">
196
+
197
+ ⭐ **Star this repo if you find it useful!** ⭐
198
+
199
+ [Report Bug](https://github.com/Ambrishyadav-byte/OnewordAI/issues) • [Request Feature](https://github.com/Ambrishyadav-byte/OnewordAI/issues)
200
+
201
+ </div>
oneword_ai-0.1.1/README.md ADDED
@@ -0,0 +1,169 @@
1
+ # 🎬 OneWord AI - Cinematic Subtitle Generator
2
+
3
+ <div align="center">
4
+
5
+ **Generate viral-style one-word subtitles from video/audio using Whisper AI**
6
+
7
+ [![PyPI](https://img.shields.io/pypi/v/oneword-ai)](https://pypi.org/project/oneword-ai/)
8
+ [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
9
+ [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
10
+
11
+ Perfect for creating high-energy reels, shorts, and TikToks! 🚀
12
+
13
+ [Installation](#-installation) • [Usage](#-usage) • [Features](#-features) • [Credits](#-credits)
14
+
15
+ </div>
16
+
17
+ ---
18
+
19
+ ## ✨ Features
20
+
21
+ - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
22
+ - 🌍 **Multi-Language Support**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
23
+ - 🤖 **Multiple AI Models**:
24
+ - OpenAI Whisper (Medium, Large)
25
+ - Hindi2Hinglish (Oriserve/Whisper-Hindi2Hinglish-Prime) 🇮🇳
26
+ - 💻 **Dual Interface**: CLI for power users, Web UI for visual workflow
27
+ - 📦 **Easy Installation**: One-line pip install
28
+ - ☁️ **Cloud Ready**: Works seamlessly on Google Colab
29
+
30
+ ---
31
+
32
+ ## 🚀 Installation
33
+
34
+ ### Method 1: Install from PyPI (Recommended)
35
+
36
+ ```bash
37
+ pip install oneword-ai
38
+ ```
39
+
40
+ **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
41
+
42
+ ---
43
+
44
+ ## 📖 Usage
45
+
46
+ ### Option 1: Web Interface (Easiest)
47
+
48
+ Start the web server and process files through a beautiful UI:
49
+
50
+ ```bash
51
+ # Start server
52
+ python -m onewordai.api.main
53
+ ```
54
+
55
+ Then open http://localhost:8000 in your browser.
56
+
57
+ **Features:**
58
+ - 📤 Drag & drop file upload
59
+ - 📊 Real-time download progress with speed tracking
60
+ - ⏱️ Live transcription status
61
+ - ❌ Cancel processing anytime
62
+ - 📥 Instant SRT download
63
+ - ⚠️ Reload protection (won't lose progress)
64
+
65
+ ---
66
+
67
+ ### Option 2: Google Colab with Package
68
+
69
+ Run OneWord AI in the cloud without any local installation:
70
+
71
+ [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Ambrishyadav-byte/OnewordAI/blob/main/OneWord_Colab.ipynb)
72
+
73
+ **Quick Start in Colab:**
74
+
75
+ ```python
76
+ # Install package
77
+ !pip install oneword-ai
78
+
79
+ # Import and use
80
+ from onewordai.core.engine import SubtitleGenerator
81
+
82
+ # Generate subtitles
83
+ generator = SubtitleGenerator(model_name="medium")
84
+ output = generator.process("video.mp4", mode="oneword")
85
+ print(f"✅ Subtitles saved: {output}")
86
+ ```
87
+
88
+ ---
89
+
90
+ ### Option 3: Command Line Interface (CLI)
91
+
92
+ For batch processing and automation:
93
+
94
+ ```bash
95
+ # Basic usage
96
+ python -m onewordai.cli -i video.mp4
97
+
98
+ # Advanced options
99
+ python -m onewordai.cli -i video.mp4 -m medium -lang hi -mode oneword
100
+ ```
101
+
102
+ **See [CLI.md](CLI.md) for full CLI documentation.**
103
+
104
+ ---
105
+
106
+ ## 📊 Subtitle Modes
107
+
108
+ | Mode | Description | Best For |
109
+ |------|-------------|----------|
110
+ | **One Word** | Each word = separate subtitle | High-energy viral content, reels |
111
+ | **Two Word Punch** | Groups of 2 words | Punchy messaging, Instagram posts |
112
+ | **Phrase Mode** | Full sentence segments | YouTube videos, longer content |
113
+
114
+ ---
115
+
116
+ ## 🎨 Model Options
117
+
118
+ | Model | Size | Speed | Quality | Language Support |
119
+ |-------|------|-------|---------|------------------|
120
+ | **medium** | ~1.5GB | Fast | Good | Multi-language |
121
+ | **large** | ~3GB | Slower | Best | Multi-language |
122
+ | **Hindi2Hinglish** | ~1.5GB | Fast | Excellent for Hindi | Hindi → Hinglish |
123
+
124
+ ---
125
+
126
+ ## 🤝 Credits
127
+
128
+ This project wouldn't be possible without these amazing open-source projects:
129
+
130
+ ### Core Technologies
131
+ - **[OpenAI Whisper](https://github.com/openai/whisper)** - Revolutionary speech recognition model
132
+ - **[Oriserve/Whisper-Hindi2Hinglish-Prime](https://huggingface.co/Oriserve/Whisper-Hindi2Hinglish-Prime)** - Hindi to Hinglish transcription model
133
+ - **[HuggingFace Transformers](https://github.com/huggingface/transformers)** - Model loading and inference
134
+
135
+ ### Backend & UI
136
+ - **[FastAPI](https://fastapi.tiangolo.com/)** - Modern Python web framework
137
+ - **[Gradio](https://gradio.app/)** - ML web interfaces
138
+ - **[FFmpeg](https://ffmpeg.org/)** - Audio/video processing
139
+
140
+ ### Special Thanks
141
+ - OpenAI for making Whisper open-source
142
+ - Oriserve team for the Hindi2Hinglish model
143
+ - All contributors to the dependencies
144
+
145
+ ---
146
+
147
+ ## 📜 License
148
+
149
+ MIT License - see [license.txt](license.txt)
150
+
151
+ Free to use for personal and commercial projects!
152
+
153
+ ---
154
+
155
+ ## 👨‍💻 Author
156
+
157
+ **Built with ❤️ by [Ambrish Yadav](https://github.com/Ambrishyadav-byte)**
158
+
159
+ 💼 Connect: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
160
+
161
+ ---
162
+
163
+ <div align="center">
164
+
165
+ ⭐ **Star this repo if you find it useful!** ⭐
166
+
167
+ [Report Bug](https://github.com/Ambrishyadav-byte/OnewordAI/issues) • [Request Feature](https://github.com/Ambrishyadav-byte/OnewordAI/issues)
168
+
169
+ </div>
oneword_ai-0.1.1/oneword_ai.egg-info/PKG-INFO ADDED
@@ -0,0 +1,201 @@
1
+ Metadata-Version: 2.4
2
+ Name: oneword-ai
3
+ Version: 0.1.1
4
+ Summary: Create viral-style one-word subtitles for Reels, Shorts & TikToks using AI. Perfect for content creators!
5
+ Author-email: Ambrish <ambrishyadav1110@gmail.com>
6
+ License: Copyright 2025 Ambrish
7
+
8
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
9
+
10
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
11
+
12
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
13
+ Project-URL: Homepage, https://github.com/Ambrishyadav-byte/OnewordAI
14
+ Project-URL: Bug Tracker, https://github.com/Ambrishyadav-byte/OnewordAI/issues
15
+ Keywords: subtitles,ai,whisper,content-creation,video-editing
16
+ Requires-Python: >=3.9
17
+ Description-Content-Type: text/markdown
18
+ License-File: license.txt
19
+ Requires-Dist: openai-whisper>=20231117
20
+ Requires-Dist: torch>=2.0.0
21
+ Requires-Dist: fastapi>=0.100.0
22
+ Requires-Dist: uvicorn[standard]>=0.23.0
23
+ Requires-Dist: python-multipart>=0.0.6
24
+ Requires-Dist: ffmpeg-python>=0.2.0
25
+ Requires-Dist: gradio>=4.0.0
26
+ Requires-Dist: tqdm>=4.65.0
27
+ Requires-Dist: aiofiles>=23.0.0
28
+ Requires-Dist: transformers>=4.30.0
29
+ Requires-Dist: accelerate>=0.20.0
30
+ Requires-Dist: huggingface_hub>=0.16.0
31
+ Dynamic: license-file
32
+
33
+ # 🎬 OneWord AI - Cinematic Subtitle Generator
34
+
35
+ <div align="center">
36
+
37
+ **Generate viral-style one-word subtitles from video/audio using Whisper AI**
38
+
39
+ [![PyPI](https://img.shields.io/pypi/v/oneword-ai)](https://pypi.org/project/oneword-ai/)
40
+ [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
41
+ [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
42
+
43
+ Perfect for creating high-energy reels, shorts, and TikToks! 🚀
44
+
45
+ [Installation](#-installation) • [Usage](#-usage) • [Features](#-features) • [Credits](#-credits)
46
+
47
+ </div>
48
+
49
+ ---
50
+
51
+ ## ✨ Features
52
+
53
+ - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
54
+ - 🌍 **Multi-Language Support**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
55
+ - 🤖 **Multiple AI Models**:
56
+ - OpenAI Whisper (Medium, Large)
57
+ - Hindi2Hinglish (Oriserve/Whisper-Hindi2Hinglish-Prime) 🇮🇳
58
+ - 💻 **Dual Interface**: CLI for power users, Web UI for visual workflow
59
+ - 📦 **Easy Installation**: One-line pip install
60
+ - ☁️ **Cloud Ready**: Works seamlessly on Google Colab
61
+
62
+ ---
63
+
64
+ ## 🚀 Installation
65
+
66
+ ### Method 1: Install from PyPI (Recommended)
67
+
68
+ ```bash
69
+ pip install oneword-ai
70
+ ```
71
+
72
+ **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
73
+
74
+ ---
75
+
76
+ ## 📖 Usage
77
+
78
+ ### Option 1: Web Interface (Easiest)
79
+
80
+ Start the web server and process files through a beautiful UI:
81
+
82
+ ```bash
83
+ # Start server
84
+ python -m onewordai.api.main
85
+ ```
86
+
87
+ Then open http://localhost:8000 in your browser.
88
+
89
+ **Features:**
90
+ - 📤 Drag & drop file upload
91
+ - 📊 Real-time download progress with speed tracking
92
+ - ⏱️ Live transcription status
93
+ - ❌ Cancel processing anytime
94
+ - 📥 Instant SRT download
95
+ - ⚠️ Reload protection (won't lose progress)
96
+
97
+ ---
98
+
99
+ ### Option 2: Google Colab with Package
100
+
101
+ Run OneWord AI in the cloud without any local installation:
102
+
103
+ [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Ambrishyadav-byte/OnewordAI/blob/main/OneWord_Colab.ipynb)
104
+
105
+ **Quick Start in Colab:**
106
+
107
+ ```python
108
+ # Install package
109
+ !pip install oneword-ai
110
+
111
+ # Import and use
112
+ from onewordai.core.engine import SubtitleGenerator
113
+
114
+ # Generate subtitles
115
+ generator = SubtitleGenerator(model_name="medium")
116
+ output = generator.process("video.mp4", mode="oneword")
117
+ print(f"✅ Subtitles saved: {output}")
118
+ ```
119
+
120
+ ---
121
+
122
+ ### Option 3: Command Line Interface (CLI)
123
+
124
+ For batch processing and automation:
125
+
126
+ ```bash
127
+ # Basic usage
128
+ python -m onewordai.cli -i video.mp4
129
+
130
+ # Advanced options
131
+ python -m onewordai.cli -i video.mp4 -m medium -lang hi -mode oneword
132
+ ```
133
+
134
+ **See [CLI.md](CLI.md) for full CLI documentation.**
135
+
136
+ ---
137
+
138
+ ## 📊 Subtitle Modes
139
+
140
+ | Mode | Description | Best For |
141
+ |------|-------------|----------|
142
+ | **One Word** | Each word = separate subtitle | High-energy viral content, reels |
143
+ | **Two Word Punch** | Groups of 2 words | Punchy messaging, Instagram posts |
144
+ | **Phrase Mode** | Full sentence segments | YouTube videos, longer content |
145
+
146
+ ---
147
+
148
+ ## 🎨 Model Options
149
+
150
+ | Model | Size | Speed | Quality | Language Support |
151
+ |-------|------|-------|---------|------------------|
152
+ | **medium** | ~1.5GB | Fast | Good | Multi-language |
153
+ | **large** | ~3GB | Slower | Best | Multi-language |
154
+ | **Hindi2Hinglish** | ~1.5GB | Fast | Excellent for Hindi | Hindi → Hinglish |
155
+
156
+ ---
157
+
158
+ ## 🤝 Credits
159
+
160
+ This project wouldn't be possible without these amazing open-source projects:
161
+
162
+ ### Core Technologies
163
+ - **[OpenAI Whisper](https://github.com/openai/whisper)** - Revolutionary speech recognition model
164
+ - **[Oriserve/Whisper-Hindi2Hinglish-Prime](https://huggingface.co/Oriserve/Whisper-Hindi2Hinglish-Prime)** - Hindi to Hinglish transcription model
165
+ - **[HuggingFace Transformers](https://github.com/huggingface/transformers)** - Model loading and inference
166
+
167
+ ### Backend & UI
168
+ - **[FastAPI](https://fastapi.tiangolo.com/)** - Modern Python web framework
169
+ - **[Gradio](https://gradio.app/)** - ML web interfaces
170
+ - **[FFmpeg](https://ffmpeg.org/)** - Audio/video processing
171
+
172
+ ### Special Thanks
173
+ - OpenAI for making Whisper open-source
174
+ - Oriserve team for the Hindi2Hinglish model
175
+ - All contributors to the dependencies
176
+
177
+ ---
178
+
179
+ ## 📜 License
180
+
181
+ MIT License - see [license.txt](license.txt)
182
+
183
+ Free to use for personal and commercial projects!
184
+
185
+ ---
186
+
187
+ ## 👨‍💻 Author
188
+
189
+ **Built with ❤️ by [Ambrish Yadav](https://github.com/Ambrishyadav-byte)**
190
+
191
+ 💼 Connect: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
192
+
193
+ ---
194
+
195
+ <div align="center">
196
+
197
+ ⭐ **Star this repo if you find it useful!** ⭐
198
+
199
+ [Report Bug](https://github.com/Ambrishyadav-byte/OnewordAI/issues) • [Request Feature](https://github.com/Ambrishyadav-byte/OnewordAI/issues)
200
+
201
+ </div>
{oneword_ai-0.1.0 → oneword_ai-0.1.1}/pyproject.toml RENAMED
@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "oneword-ai"
7
- version = "0.1.0"
8
- description = "A minimalist one-word subtitle generator with Neobrutalism UI"
7
+ version = "0.1.1"
8
+ description = "Create viral-style one-word subtitles for Reels, Shorts & TikToks using AI. Perfect for content creators!"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.9"
11
11
  license = {file = "license.txt"}
oneword_ai-0.1.0/PKG-INFO DELETED
@@ -1,237 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: oneword-ai
3
- Version: 0.1.0
4
- Summary: A minimalist one-word subtitle generator with Neobrutalism UI
5
- Author-email: Ambrish <ambrishyadav1110@gmail.com>
6
- License: Copyright 2025 Ambrish
7
-
8
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
9
-
10
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
11
-
12
- THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
13
- Project-URL: Homepage, https://github.com/Ambrishyadav-byte/OnewordAI
14
- Project-URL: Bug Tracker, https://github.com/Ambrishyadav-byte/OnewordAI/issues
15
- Keywords: subtitles,ai,whisper,content-creation,video-editing
16
- Requires-Python: >=3.9
17
- Description-Content-Type: text/markdown
18
- License-File: license.txt
19
- Requires-Dist: openai-whisper>=20231117
20
- Requires-Dist: torch>=2.0.0
21
- Requires-Dist: fastapi>=0.100.0
22
- Requires-Dist: uvicorn[standard]>=0.23.0
23
- Requires-Dist: python-multipart>=0.0.6
24
- Requires-Dist: ffmpeg-python>=0.2.0
25
- Requires-Dist: gradio>=4.0.0
26
- Requires-Dist: tqdm>=4.65.0
27
- Requires-Dist: aiofiles>=23.0.0
28
- Requires-Dist: transformers>=4.30.0
29
- Requires-Dist: accelerate>=0.20.0
30
- Requires-Dist: huggingface_hub>=0.16.0
31
- Dynamic: license-file
32
-
33
- # 🎬 OneWord AI - Subtitle Generator
34
-
35
- <div align="center">
36
-
37
- **Generate cinematic one-word subtitles from video/audio using Whisper AI**
38
-
39
- [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
40
- [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
41
- [![Whisper](https://img.shields.io/badge/OpenAI-Whisper-orange)](https://github.com/openai/whisper)
42
-
43
- Perfect for creators making high-energy reels, shorts, and TikToks!
44
-
45
- </div>
46
-
47
- ---
48
-
49
- ## ✨ Features
50
-
51
- - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
52
- - 🌍 **Multi-Language**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
53
- - 🤖 **Multiple Models**: Medium, Large, and **Hindi2Hinglish** (Oriserve/Prime) 🆕
54
- - 📦 **Python Package**: Installable via pip with `oneword-cli` and `oneword-web` commands
55
- - 💻 **Local CLI**: Robust command-line tool for batch processing
56
- - 🌐 **Web UI**: Beautiful Neobrutalism-styled web interface
57
- - ☁️ **Cloud Ready**: Works on Google Colab and Hugging Face Spaces
58
- - 🐳 **Docker Support**: Containerized deployment
59
-
60
- ## 🚀 Quick Start
61
-
62
- ### Installation
63
-
64
- ```bash
65
- # Clone the repository
66
- git clone https://github.com/Ambrishyadav-byte/OnewordAI.git
67
- cd OnewordAI
68
-
69
- # Install as a package
70
- pip install -e .
71
- ```
72
-
73
- **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
74
-
75
- ### Usage
76
-
77
- #### 🖥️ CLI (Command Line)
78
-
79
- See [CLI.md](CLI.md) for full documentation.
80
-
81
- ```bash
82
- # Basic usage
83
- oneword-cli -i video.mp4
84
-
85
- # Full options
86
- oneword-cli -i video.mp4 -m medium -lang hi -mode oneword
87
- ```
88
-
89
- #### 🌐 Web UI
90
-
91
- ```bash
92
- # Start server & open browser
93
- oneword-web
94
- ```
95
-
96
- Features:
97
- - Drag & drop file upload
98
- - Real-time progress tracking
99
- - Instant SRT download
100
- - Responsive Neobrutalism design
101
-
102
- #### ☁️ Google Colab
103
-
104
- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/)
105
-
106
- 1. Open `OneWord_Colab.ipynb` in Colab
107
- 2. Run all cells
108
- 3. Upload your video
109
- 4. Download your SRT!
110
-
111
- #### 🤗 Hugging Face Space
112
-
113
- ```bash
114
- python app_gradio.py
115
- ```
116
-
117
- Or deploy to Hugging Face Spaces for a hosted version!
118
-
119
- ## 📊 Subtitle Modes
120
-
121
- | Mode | Description | Use Case |
122
- |------|-------------|----------|
123
- | **One Word** | Each word = separate subtitle | High-energy, attention-grabbing content |
124
- | **Two Word Punch** | Groups of 2 words | Punchy, impactful messaging |
125
- | **Phrase Mode** | Full sentence segments | Traditional subtitle style |
126
-
127
- ## 🎨 Web UI Preview
128
-
129
- The web interface features a stunning **Neobrutalism** design:
130
- - Bold black borders
131
- - Vibrant color palette
132
- - Sharp shadows
133
- - Grid background pattern
134
- - Smooth animations
135
-
136
- ## 🐳 Docker Deployment
137
-
138
- ```bash
139
- # Build image
140
- docker build -t oneword-ai .
141
-
142
- # Run container
143
- docker run -p 8000:8000 oneword-ai
144
- ```
145
-
146
- ## 📁 Project Structure
147
-
148
- ```
149
- minimalist-one-word-subtitle-generator/
150
- ├── onewordai/ # Source code (package)
151
- │ ├── core/
152
- │ │ ├── __init__.py
153
- │ │ └── engine.py # Core subtitle generation logic
154
- │ ├── api/
155
- │ │ ├── __init__.py
156
- │ │ └── main.py # FastAPI backend
157
- │ └── web/
158
- │ ├── index.html # Web UI
159
- │ ├── style.css # Neobrutalism styles
160
- │ └── app.js # Frontend logic
161
- ├── cli.py # CLI interface
162
- ├── app_gradio.py # Gradio app for HF Spaces
163
- ├── OneWord_Colab.ipynb # Google Colab notebook
164
- ├── Dockerfile # Docker configuration
165
- ├── requirements.txt # Python dependencies
166
- └── README.md
167
- ```
168
-
169
- ## 🛠️ Development
170
-
171
- ### API Endpoints
172
-
173
- - `POST /upload` - Upload video/audio file
174
- - `POST /process` - Start transcription job
175
- - `GET /status/{job_id}` - Check job progress
176
- - `GET /download/{job_id}` - Download generated SRT
177
-
178
- ### Requirements
179
-
180
- - Python 3.8+
181
- - FFmpeg
182
- - PyTorch
183
- - OpenAI Whisper
184
- - FastAPI (for web server)
185
- - Gradio (for HF Spaces)
186
-
187
- ## 💡 Tips for Creators
188
-
189
- ### Video Editing Workflow
190
-
191
- 1. Generate SRT using OneWord AI
192
- 2. Import into your editor:
193
- - **CapCut**: Text → Local Captions → Upload
194
- - **VN Editor**: Text → SRT → Import
195
- - **Premiere Pro**: File → Import → Captions
196
- 3. Apply animations (Pop, Spring, Bounce)
197
- 4. Customize colors and fonts
198
-
199
- ### Best Practices
200
-
201
- - Use **Tiny** model for quick drafts
202
- - Use **Base** model for production (best balance)
203
- - Use **Small** model for technical/complex content
204
- - **One Word** mode works best for 30-60 sec reels
205
- - Enable language selection for multilingual content
206
-
207
- ## 🤝 Contributing
208
-
209
- Contributions welcome! Open an issue or submit a PR.
210
-
211
- Ideas for improvements:
212
- - Auto-capitalization for emphasis
213
- - Color-coded keywords
214
- - Export with burned-in subtitles
215
- - Batch processing multiple files
216
-
217
- ## 📜 License
218
-
219
- MIT License - see [license.txt](license.txt)
220
-
221
- ## 🤝 Credits
222
-
223
- - [OpenAI Whisper](https://github.com/openai/whisper) - Speech recognition
224
- - [FastAPI](https://fastapi.tiangolo.com/) - Backend framework
225
- - [Gradio](https://gradio.app/) - ML web interfaces
226
-
227
- Built with ❤️ by [Ambrish](https://github.com/ambrish-yadav)
228
-
229
- Follow for updates: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
230
-
231
- ---
232
-
233
- <div align="center">
234
-
235
- ⭐ Star this repo if you find it useful!
236
-
237
- </div>
oneword_ai-0.1.0/README.md DELETED
@@ -1,205 +0,0 @@
1
- # 🎬 OneWord AI - Subtitle Generator
2
-
3
- <div align="center">
4
-
5
- **Generate cinematic one-word subtitles from video/audio using Whisper AI**
6
-
7
- [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
8
- [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
9
- [![Whisper](https://img.shields.io/badge/OpenAI-Whisper-orange)](https://github.com/openai/whisper)
10
-
11
- Perfect for creators making high-energy reels, shorts, and TikToks!
12
-
13
- </div>
14
-
15
- ---
16
-
17
- ## ✨ Features
18
-
19
- - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
20
- - 🌍 **Multi-Language**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
21
- - 🤖 **Multiple Models**: Medium, Large, and **Hindi2Hinglish** (Oriserve/Prime) 🆕
22
- - 📦 **Python Package**: Installable via pip with `oneword-cli` and `oneword-web` commands
23
- - 💻 **Local CLI**: Robust command-line tool for batch processing
24
- - 🌐 **Web UI**: Beautiful Neobrutalism-styled web interface
25
- - ☁️ **Cloud Ready**: Works on Google Colab and Hugging Face Spaces
26
- - 🐳 **Docker Support**: Containerized deployment
27
-
28
- ## 🚀 Quick Start
29
-
30
- ### Installation
31
-
32
- ```bash
33
- # Clone the repository
34
- git clone https://github.com/Ambrishyadav-byte/OnewordAI.git
35
- cd OnewordAI
36
-
37
- # Install as a package
38
- pip install -e .
39
- ```
40
-
41
- **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
42
-
43
- ### Usage
44
-
45
- #### 🖥️ CLI (Command Line)
46
-
47
- See [CLI.md](CLI.md) for full documentation.
48
-
49
- ```bash
50
- # Basic usage
51
- oneword-cli -i video.mp4
52
-
53
- # Full options
54
- oneword-cli -i video.mp4 -m medium -lang hi -mode oneword
55
- ```
56
-
57
- #### 🌐 Web UI
58
-
59
- ```bash
60
- # Start server & open browser
61
- oneword-web
62
- ```
63
-
64
- Features:
65
- - Drag & drop file upload
66
- - Real-time progress tracking
67
- - Instant SRT download
68
- - Responsive Neobrutalism design
69
-
70
- #### ☁️ Google Colab
71
-
72
- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/)
73
-
74
- 1. Open `OneWord_Colab.ipynb` in Colab
75
- 2. Run all cells
76
- 3. Upload your video
77
- 4. Download your SRT!
78
-
79
- #### 🤗 Hugging Face Space
80
-
81
- ```bash
82
- python app_gradio.py
83
- ```
84
-
85
- Or deploy to Hugging Face Spaces for a hosted version!
86
-
87
- ## 📊 Subtitle Modes
88
-
89
- | Mode | Description | Use Case |
90
- |------|-------------|----------|
91
- | **One Word** | Each word = separate subtitle | High-energy, attention-grabbing content |
92
- | **Two Word Punch** | Groups of 2 words | Punchy, impactful messaging |
93
- | **Phrase Mode** | Full sentence segments | Traditional subtitle style |
94
-
95
- ## 🎨 Web UI Preview
96
-
97
- The web interface features a stunning **Neobrutalism** design:
98
- - Bold black borders
99
- - Vibrant color palette
100
- - Sharp shadows
101
- - Grid background pattern
102
- - Smooth animations
103
-
104
- ## 🐳 Docker Deployment
105
-
106
- ```bash
107
- # Build image
108
- docker build -t oneword-ai .
109
-
110
- # Run container
111
- docker run -p 8000:8000 oneword-ai
112
- ```
113
-
114
- ## 📁 Project Structure
115
-
116
- ```
117
- minimalist-one-word-subtitle-generator/
118
- ├── onewordai/ # Source code (package)
119
- │ ├── core/
120
- │ │ ├── __init__.py
121
- │ │ └── engine.py # Core subtitle generation logic
122
- │ ├── api/
123
- │ │ ├── __init__.py
124
- │ │ └── main.py # FastAPI backend
125
- │ └── web/
126
- │ ├── index.html # Web UI
127
- │ ├── style.css # Neobrutalism styles
128
- │ └── app.js # Frontend logic
129
- ├── cli.py # CLI interface
130
- ├── app_gradio.py # Gradio app for HF Spaces
131
- ├── OneWord_Colab.ipynb # Google Colab notebook
132
- ├── Dockerfile # Docker configuration
133
- ├── requirements.txt # Python dependencies
134
- └── README.md
135
- ```
136
-
137
- ## 🛠️ Development
138
-
139
- ### API Endpoints
140
-
141
- - `POST /upload` - Upload video/audio file
142
- - `POST /process` - Start transcription job
143
- - `GET /status/{job_id}` - Check job progress
144
- - `GET /download/{job_id}` - Download generated SRT
145
-
146
- ### Requirements
147
-
148
- - Python 3.8+
149
- - FFmpeg
150
- - PyTorch
151
- - OpenAI Whisper
152
- - FastAPI (for web server)
153
- - Gradio (for HF Spaces)
154
-
155
- ## 💡 Tips for Creators
156
-
157
- ### Video Editing Workflow
158
-
159
- 1. Generate SRT using OneWord AI
160
- 2. Import into your editor:
161
- - **CapCut**: Text → Local Captions → Upload
162
- - **VN Editor**: Text → SRT → Import
163
- - **Premiere Pro**: File → Import → Captions
164
- 3. Apply animations (Pop, Spring, Bounce)
165
- 4. Customize colors and fonts
166
-
167
- ### Best Practices
168
-
169
- - Use **Tiny** model for quick drafts
170
- - Use **Base** model for production (best balance)
171
- - Use **Small** model for technical/complex content
172
- - **One Word** mode works best for 30-60 sec reels
173
- - Enable language selection for multilingual content
174
-
175
- ## 🤝 Contributing
176
-
177
- Contributions welcome! Open an issue or submit a PR.
178
-
179
- Ideas for improvements:
180
- - Auto-capitalization for emphasis
181
- - Color-coded keywords
182
- - Export with burned-in subtitles
183
- - Batch processing multiple files
184
-
185
- ## 📜 License
186
-
187
- MIT License - see [license.txt](license.txt)
188
-
189
- ## 🤝 Credits
190
-
191
- - [OpenAI Whisper](https://github.com/openai/whisper) - Speech recognition
192
- - [FastAPI](https://fastapi.tiangolo.com/) - Backend framework
193
- - [Gradio](https://gradio.app/) - ML web interfaces
194
-
195
- Built with ❤️ by [Ambrish](https://github.com/ambrish-yadav)
196
-
197
- Follow for updates: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
198
-
199
- ---
200
-
201
- <div align="center">
202
-
203
- ⭐ Star this repo if you find it useful!
204
-
205
- </div>
oneword_ai-0.1.0/oneword_ai.egg-info/PKG-INFO DELETED
@@ -1,237 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: oneword-ai
3
- Version: 0.1.0
4
- Summary: A minimalist one-word subtitle generator with Neobrutalism UI
5
- Author-email: Ambrish <ambrishyadav1110@gmail.com>
6
- License: Copyright 2025 Ambrish
7
-
8
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
9
-
10
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
11
-
12
- THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
13
- Project-URL: Homepage, https://github.com/Ambrishyadav-byte/OnewordAI
14
- Project-URL: Bug Tracker, https://github.com/Ambrishyadav-byte/OnewordAI/issues
15
- Keywords: subtitles,ai,whisper,content-creation,video-editing
16
- Requires-Python: >=3.9
17
- Description-Content-Type: text/markdown
18
- License-File: license.txt
19
- Requires-Dist: openai-whisper>=20231117
20
- Requires-Dist: torch>=2.0.0
21
- Requires-Dist: fastapi>=0.100.0
22
- Requires-Dist: uvicorn[standard]>=0.23.0
23
- Requires-Dist: python-multipart>=0.0.6
24
- Requires-Dist: ffmpeg-python>=0.2.0
25
- Requires-Dist: gradio>=4.0.0
26
- Requires-Dist: tqdm>=4.65.0
27
- Requires-Dist: aiofiles>=23.0.0
28
- Requires-Dist: transformers>=4.30.0
29
- Requires-Dist: accelerate>=0.20.0
30
- Requires-Dist: huggingface_hub>=0.16.0
31
- Dynamic: license-file
32
-
33
- # 🎬 OneWord AI - Subtitle Generator
34
-
35
- <div align="center">
36
-
37
- **Generate cinematic one-word subtitles from video/audio using Whisper AI**
38
-
39
- [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
40
- [![License](https://img.shields.io/badge/License-MIT-green)](license.txt)
41
- [![Whisper](https://img.shields.io/badge/OpenAI-Whisper-orange)](https://github.com/openai/whisper)
42
-
43
- Perfect for creators making high-energy reels, shorts, and TikToks!
44
-
45
- </div>
46
-
47
- ---
48
-
49
- ## ✨ Features
50
-
51
- - 🎯 **Three Subtitle Modes**: One Word, Two Word Punch, Phrase Mode
52
- - 🌍 **Multi-Language**: Auto-detect or specify (English, Hindi, Urdu, Spanish)
53
- - 🤖 **Multiple Models**: Medium, Large, and **Hindi2Hinglish** (Oriserve/Prime) 🆕
54
- - 📦 **Python Package**: Installable via pip with `oneword-cli` and `oneword-web` commands
55
- - 💻 **Local CLI**: Robust command-line tool for batch processing
56
- - 🌐 **Web UI**: Beautiful Neobrutalism-styled web interface
57
- - ☁️ **Cloud Ready**: Works on Google Colab and Hugging Face Spaces
58
- - 🐳 **Docker Support**: Containerized deployment
59
-
60
- ## 🚀 Quick Start
61
-
62
- ### Installation
63
-
64
- ```bash
65
- # Clone the repository
66
- git clone https://github.com/Ambrishyadav-byte/OnewordAI.git
67
- cd OnewordAI
68
-
69
- # Install as a package
70
- pip install -e .
71
- ```
72
-
73
- **Prerequisites**: Ensure [FFmpeg](https://ffmpeg.org/) is installed on your system.
74
-
75
- ### Usage
76
-
77
- #### 🖥️ CLI (Command Line)
78
-
79
- See [CLI.md](CLI.md) for full documentation.
80
-
81
- ```bash
82
- # Basic usage
83
- oneword-cli -i video.mp4
84
-
85
- # Full options
86
- oneword-cli -i video.mp4 -m medium -lang hi -mode oneword
87
- ```
88
-
89
- #### 🌐 Web UI
90
-
91
- ```bash
92
- # Start server & open browser
93
- oneword-web
94
- ```
95
-
96
- Features:
97
- - Drag & drop file upload
98
- - Real-time progress tracking
99
- - Instant SRT download
100
- - Responsive Neobrutalism design
101
-
102
- #### ☁️ Google Colab
103
-
104
- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/)
105
-
106
- 1. Open `OneWord_Colab.ipynb` in Colab
107
- 2. Run all cells
108
- 3. Upload your video
109
- 4. Download your SRT!
110
-
111
- #### 🤗 Hugging Face Space
112
-
113
- ```bash
114
- python app_gradio.py
115
- ```
116
-
117
- Or deploy to Hugging Face Spaces for a hosted version!
118
-
119
- ## 📊 Subtitle Modes
120
-
121
- | Mode | Description | Use Case |
122
- |------|-------------|----------|
123
- | **One Word** | Each word = separate subtitle | High-energy, attention-grabbing content |
124
- | **Two Word Punch** | Groups of 2 words | Punchy, impactful messaging |
125
- | **Phrase Mode** | Full sentence segments | Traditional subtitle style |
126
-
127
- ## 🎨 Web UI Preview
128
-
129
- The web interface features a stunning **Neobrutalism** design:
130
- - Bold black borders
131
- - Vibrant color palette
132
- - Sharp shadows
133
- - Grid background pattern
134
- - Smooth animations
135
-
136
- ## 🐳 Docker Deployment
137
-
138
- ```bash
139
- # Build image
140
- docker build -t oneword-ai .
141
-
142
- # Run container
143
- docker run -p 8000:8000 oneword-ai
144
- ```
145
-
146
- ## 📁 Project Structure
147
-
148
- ```
149
- minimalist-one-word-subtitle-generator/
150
- ├── onewordai/ # Source code (package)
151
- │ ├── core/
152
- │ │ ├── __init__.py
153
- │ │ └── engine.py # Core subtitle generation logic
154
- │ ├── api/
155
- │ │ ├── __init__.py
156
- │ │ └── main.py # FastAPI backend
157
- │ └── web/
158
- │ ├── index.html # Web UI
159
- │ ├── style.css # Neobrutalism styles
160
- │ └── app.js # Frontend logic
161
- ├── cli.py # CLI interface
162
- ├── app_gradio.py # Gradio app for HF Spaces
163
- ├── OneWord_Colab.ipynb # Google Colab notebook
164
- ├── Dockerfile # Docker configuration
165
- ├── requirements.txt # Python dependencies
166
- └── README.md
167
- ```
168
-
169
- ## 🛠️ Development
170
-
171
- ### API Endpoints
172
-
173
- - `POST /upload` - Upload video/audio file
174
- - `POST /process` - Start transcription job
175
- - `GET /status/{job_id}` - Check job progress
176
- - `GET /download/{job_id}` - Download generated SRT
177
-
178
- ### Requirements
179
-
180
- - Python 3.8+
181
- - FFmpeg
182
- - PyTorch
183
- - OpenAI Whisper
184
- - FastAPI (for web server)
185
- - Gradio (for HF Spaces)
186
-
187
- ## 💡 Tips for Creators
188
-
189
- ### Video Editing Workflow
190
-
191
- 1. Generate SRT using OneWord AI
192
- 2. Import into your editor:
193
- - **CapCut**: Text → Local Captions → Upload
194
- - **VN Editor**: Text → SRT → Import
195
- - **Premiere Pro**: File → Import → Captions
196
- 3. Apply animations (Pop, Spring, Bounce)
197
- 4. Customize colors and fonts
198
-
199
- ### Best Practices
200
-
201
- - Use **Tiny** model for quick drafts
202
- - Use **Base** model for production (best balance)
203
- - Use **Small** model for technical/complex content
204
- - **One Word** mode works best for 30-60 sec reels
205
- - Enable language selection for multilingual content
206
-
207
- ## 🤝 Contributing
208
-
209
- Contributions welcome! Open an issue or submit a PR.
210
-
211
- Ideas for improvements:
212
- - Auto-capitalization for emphasis
213
- - Color-coded keywords
214
- - Export with burned-in subtitles
215
- - Batch processing multiple files
216
-
217
- ## 📜 License
218
-
219
- MIT License - see [license.txt](license.txt)
220
-
221
- ## 🤝 Credits
222
-
223
- - [OpenAI Whisper](https://github.com/openai/whisper) - Speech recognition
224
- - [FastAPI](https://fastapi.tiangolo.com/) - Backend framework
225
- - [Gradio](https://gradio.app/) - ML web interfaces
226
-
227
- Built with ❤️ by [Ambrish](https://github.com/ambrish-yadav)
228
-
229
- Follow for updates: [@ambrish.yadav.1](https://instagram.com/ambrish.yadav.1)
230
-
231
- ---
232
-
233
- <div align="center">
234
-
235
- ⭐ Star this repo if you find it useful!
236
-
237
- </div>
{oneword_ai-0.1.0 → oneword_ai-0.1.1}/license.txt RENAMED
File without changes
{oneword_ai-0.1.0 → oneword_ai-0.1.1}/onewordai/cli.py RENAMED
File without changes
{oneword_ai-0.1.0 → oneword_ai-0.1.1}/setup.cfg RENAMED
File without changes