sammoftah commited on
Commit
75f963b
Β·
verified Β·
1 Parent(s): 2ae4d9f

Trim README (remove deploy/how-to, MCP, troubleshooting sections)

Browse files
Files changed (1) hide show
  1. README.md +0 -82
README.md CHANGED
@@ -90,49 +90,6 @@ All of this happens automatically. You just upload and wait a few minutes.
90
  - All generated videos are written to `outputs/` (oldest files auto-pruned to keep disk usage in check); temp workdirs are cleaned after each job.
91
  - Jobs run through a small Gradio queue to avoid overlapping heavy runs on shared Spaces.
92
 
93
- ### HuggingFace Spaces
94
-
95
- The app is ready to deploy on HuggingFace Spaces. It works completely without API keys using open source models.
96
-
97
- 1. Create a new Space on [Hugging Face Spaces](https://huggingface.co/spaces)
98
- 2. Choose **Gradio** SDK
99
- 3. Upload all files from this repository
100
- 4. Add `ffmpeg` to `packages.txt`
101
- 5. The app will build automatically
102
-
103
- **Optional**: Add your ElevenLabs API key in the UI for premium voice quality. The app works perfectly without it.
104
-
105
- ### Quick Smoke Test (after deploy)
106
-
107
- 1. Grab a 5–10 second MP4 (spoken English) and upload.
108
- 2. Choose Spanish (default) and click Localize. No API key needed.
109
- 3. Wait for the job to finish (serialized queue); the localized file appears in the UI and is saved to `outputs/`.
110
- 4. If audio is silent, ensure outbound network is allowed for EdgeTTS/deep-translator or switch to a GPU space for faster Whisper.
111
-
112
- ### MCP Server (for Claude)
113
-
114
- Connect Claude to your video library:
115
-
116
- 1. Start the server:
117
- ```bash
118
- python server.py
119
- ```
120
-
121
- 2. Add to `claude_desktop_config.json`:
122
- ```json
123
- {
124
- "mcpServers": {
125
- "localizer": {
126
- "command": "uv",
127
- "args": ["run", "/absolute/path/to/MCP-Video-Localizer/server.py"]
128
- }
129
- }
130
- }
131
- ```
132
-
133
- 3. Ask Claude:
134
- > "I have a video at `/Users/me/demo.mp4`. Please dub it into Japanese."
135
-
136
  ## Tech Stack
137
 
138
  - **MCP**: Model Context Protocol server for Claude integration
@@ -143,42 +100,3 @@ Connect Claude to your video library:
143
  - **Coqui TTS**: Local neural TTS (fallback)
144
  - **gTTS**: Reliable backup TTS
145
  - **MoviePy/FFmpeg**: Video processing engine
146
-
147
- ## Troubleshooting
148
-
149
- **Video processing is slow**: This is normal. Video processing can take 2-5 minutes for a 1-minute video. Consider using GPU instances for faster processing.
150
-
151
- **ffmpeg not found**: Install ffmpeg on your system. On Hugging Face Spaces, add it to `packages.txt`.
152
-
153
- **Module not found**: Ensure all dependencies are installed: `pip install -r requirements.txt`
154
-
155
- ## Hackathon Submission
156
-
157
- Built for the [MCP 1st Birthday Hackathon](https://huggingface.co/MCP-1st-Birthday) hosted by Anthropic and Gradio.
158
-
159
- **Competing in All Tracks**:
160
-
161
- **Track 1: Building MCP**
162
- - πŸ—οΈ Consumer MCP Servers - Full MCP server implementation for video localization
163
- - 🏒 Enterprise MCP Servers - Scalable solution for enterprise content localization needs
164
- - πŸ› οΈ Developer Tools - MCP server that developers can integrate into their workflows
165
-
166
- **Track 2: MCP in Action**
167
- - πŸš€ Consumer Applications - User-friendly Gradio interface for end users
168
- - 🏒 Enterprise Applications - Business-ready solution for content creators and enterprises
169
- - πŸ› οΈ Developer Tools - Programmatic API via MCP for integration into developer workflows
170
-
171
- **Video and Social Media Post**: [View on X/Twitter](https://x.com/osamaamoftah/status/1995278797793280204?s=20)
172
-
173
- **Key Features**:
174
- - βœ… Full MCP server implementation for Claude integration
175
- - βœ… Multi-modal AI pipeline (video β†’ audio β†’ text β†’ translation β†’ voice β†’ video)
176
- - βœ… Works completely free with open source models
177
- - βœ… Optional ElevenLabs integration for premium voice quality
178
- - βœ… Intelligent fallback system ensures reliability
179
- - βœ… Professional-grade output in minutes
180
- - βœ… Programmatic access via MCP - Claude can localize videos automatically
181
-
182
- ---
183
-
184
- **Made with ❀️ for the MCP community**
 
90
  - All generated videos are written to `outputs/` (oldest files auto-pruned to keep disk usage in check); temp workdirs are cleaned after each job.
91
  - Jobs run through a small Gradio queue to avoid overlapping heavy runs on shared Spaces.
92
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
93
  ## Tech Stack
94
 
95
  - **MCP**: Model Context Protocol server for Claude integration
 
100
  - **Coqui TTS**: Local neural TTS (fallback)
101
  - **gTTS**: Reliable backup TTS
102
  - **MoviePy/FFmpeg**: Video processing engine