Add HF Spaces metadata and update README

README.md

@@ -1,11 +1,23 @@
+---
+title: NCAkit
+emoji: 🎬
+colorFrom: purple
+colorTo: blue
+sdk: docker
+app_port: 8880
+pinned: false
+license: mit
+---
+
 # NCAkit - Neural Content Automation Toolkit 🤖
 
-A modular Python toolkit for content automation, featuring video creation, text-to-speech, and more.
+A modular Python toolkit for content automation, featuring video creation, AI story reels, and more.
 
 ## ✨ Features
 
 - 🎬 **Video Creator** - Short-form videos with TTS, captions, and music
-- 🔌 **Modular Architecture** - Easy to add new features
+- � **Story Reels** - AI-powered character-consistent story videos (NEW!)
+- �🔌 **Modular Architecture** - Easy to add new features
 - 🌐 **REST API** - FastAPI with auto-generated docs
 - 🚀 **Ready for Deployment** - Docker & Hugging Face Spaces
 
@@ -24,9 +36,7 @@ NCAkit/
 │
 ├── modules/                    # Feature modules
 │   ├── video_creator/          # Video creation module
-│   │   ├── router.py           # API endpoints
-│   │   ├── schemas.py          # Pydantic models
-│   │   └── services/           # Core logic
+│   ├── story_reels/            # AI Story Reels (NEW!)
 │   └── _template/              # Template for new modules
 │
 └── static/                     # Web UI & assets
@@ -63,30 +73,30 @@ python app.py
 
 ## 📡 API Endpoints
 
-| Module | Endpoint | Method | Description |
-|--------|----------|--------|-------------|
-| System | `/health` | GET | Health check |
-| System | `/api/modules` | GET | List modules |
-| Video | `/api/video/short-video` | POST | Create video |
-| Video | `/api/video/short-video/{id}/status` | GET | Check status |
-| Video | `/api/video/short-video/{id}` | GET | Download video |
-
-## 🔧 Adding New Modules
-
-1. Copy `modules/_template/` to `modules/your_module/`
-2. Update `MODULE_NAME`, `MODULE_PREFIX` in `__init__.py`
-3. Implement router and services
-4. Restart server - auto-discovered!
-
-```python
-# modules/your_module/__init__.py
-MODULE_NAME = "your_module"
-MODULE_PREFIX = "/api/your-feature"
-
-def register(app, config):
-    from .router import router
-    app.include_router(router, prefix=MODULE_PREFIX)
-```
+### Video Creator
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/video/short-video` | POST | Create video |
+| `/api/video/short-video/{id}/status` | GET | Check status |
+| `/api/video/short-video/{id}` | GET | Download video |
+
+### Story Reels (NEW!)
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/story-reels/generate` | POST | Generate AI story video |
+| `/api/story-reels/status/{id}` | GET | Check status |
+| `/api/story-reels/download/{id}` | GET | Download video |
+
+## ⚙️ Environment Variables
+
+| Variable | Required | Module |
+|----------|----------|--------|
+| `PEXELS_API_KEY` | ✅ | Video Creator |
+| `HF_TTS` | ✅ | Video Creator / Story Reels |
+| `NVIDIA_API_KEY` | ✅ | Story Reels (Primary) |
+| `CF_URL` | ❌ | Story Reels (Fallback) |
+| `CF_API` | ❌ | Story Reels (Fallback) |
+| `GEMINI_API_KEY` | ✅ | Story Reels (AI Scripts) |
 
 ## 🐳 Docker
 
@@ -95,16 +105,6 @@ docker build -t ncakit .
 docker run -p 8880:8880 --env-file .env ncakit
 ```
 
-## ⚙️ Environment Variables
-
-| Variable | Required | Default | Module |
-|----------|----------|---------|--------|
-| `PEXELS_API_KEY` | ✅ | - | Video Creator |
-| `HF_TTS` | ✅ | - | Video Creator |
-| `WHISPER_MODEL` | ❌ | tiny.en | Video Creator |
-| `PORT` | ❌ | 8880 | Server |
-| `LOG_LEVEL` | ❌ | info | Server |
-
 ## 📄 License
 
 MIT