Spaces:
Sleeping
Sleeping
Trim README (remove deploy/how-to, MCP, troubleshooting sections)
Browse files
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|