feat: Add intelligent auto-router and enhanced integrations
- Add intelligent-router.sh hook for automatic agent routing - Add AUTO-TRIGGER-SUMMARY.md documentation - Add FINAL-INTEGRATION-SUMMARY.md documentation - Complete Prometheus integration (6 commands + 4 tools) - Complete Dexto integration (12 commands + 5 tools) - Enhanced Ralph with access to all agents - Fix /clawd command (removed disable-model-invocation) - Update hooks.json to v5 with intelligent routing - 291 total skills now available - All 21 commands with automatic routing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
122
dexto/agents/sora-video-agent/README.md
Normal file
122
dexto/agents/sora-video-agent/README.md
Normal file
@@ -0,0 +1,122 @@
|
||||
# Sora Video Agent
|
||||
|
||||
A Dexto agent specialized in AI video generation using OpenAI's Sora technology. This agent provides a comprehensive interface for creating, managing, and manipulating AI-generated videos.
|
||||
|
||||
## Features
|
||||
|
||||
- **🎬 Video Generation**: Create videos from text prompts with custom settings
|
||||
- **📊 Progress Monitoring**: Real-time status updates during video generation
|
||||
- **🎭 Video Remixing**: Create variations and extensions of existing videos
|
||||
- **📁 File Management**: Automatic download and organization of generated videos
|
||||
- **🖼️ Reference Support**: Use images or videos as reference for consistent style
|
||||
- **🗂️ Video Library**: List and manage all your generated videos
|
||||
|
||||
## Capabilities
|
||||
|
||||
### Video Creation
|
||||
- Generate videos from detailed text prompts
|
||||
- Customize duration (4s, 8s, 16s, 32s)
|
||||
- Choose resolution for different platforms:
|
||||
- **Vertical (9:16)**: 720x1280, 1024x1808 - Perfect for social media
|
||||
- **Horizontal (16:9)**: 1280x720, 1808x1024 - Great for YouTube
|
||||
- **Square (1:1)**: 1024x1024 - Ideal for Instagram posts
|
||||
|
||||
### Reference-Based Generation
|
||||
- Use existing images or videos as style references
|
||||
- Maintain character consistency across multiple videos
|
||||
- Apply specific visual styles or aesthetics
|
||||
|
||||
### Video Management
|
||||
- Monitor generation progress with real-time updates
|
||||
- List all your videos with status information
|
||||
- Download completed videos automatically
|
||||
- Delete unwanted videos to manage storage
|
||||
|
||||
### Creative Workflows
|
||||
- Create video series with consistent characters
|
||||
- Generate multiple variations of the same concept
|
||||
- Extend existing videos with new scenes
|
||||
- Build comprehensive video libraries
|
||||
|
||||
## Usage Examples
|
||||
|
||||
### Basic Video Generation
|
||||
```text
|
||||
Create a video of a cat playing piano in a cozy living room
|
||||
```
|
||||
|
||||
### Custom Settings
|
||||
```text
|
||||
Generate an 8-second video in 16:9 format showing a sunset over mountains
|
||||
```
|
||||
|
||||
### Reference-Based Creation
|
||||
```text
|
||||
Create a video using this image as reference, showing the character walking through a forest
|
||||
```
|
||||
|
||||
### Video Remixing
|
||||
```text
|
||||
Create a remix of video_123 showing the same character but in a different setting
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Detailed Prompts**: Be specific about characters, settings, actions, and mood
|
||||
2. **Platform Optimization**: Choose the right aspect ratio for your target platform
|
||||
3. **Progressive Creation**: Start with shorter videos for testing, then create longer versions
|
||||
4. **Style Consistency**: Use reference images/videos for character or style continuity
|
||||
5. **Library Management**: Regularly organize and clean up your video collection
|
||||
|
||||
## Technical Requirements
|
||||
|
||||
- OpenAI API key with Sora access
|
||||
- Node.js 18+ for running npx
|
||||
- Sufficient storage space for video downloads
|
||||
|
||||
## Setup
|
||||
|
||||
### Default Setup (Recommended)
|
||||
|
||||
By default, this agent uses the published `@truffle-ai/sora-video-server` NPM package via `npx`. No additional installation is required - the package will be automatically fetched and run when the agent starts.
|
||||
|
||||
```yaml
|
||||
mcpServers:
|
||||
sora_video:
|
||||
type: stdio
|
||||
command: npx
|
||||
args:
|
||||
- -y
|
||||
- "@truffle-ai/sora-video-server"
|
||||
connectionMode: strict
|
||||
env:
|
||||
OPENAI_API_KEY: $OPENAI_API_KEY
|
||||
```
|
||||
|
||||
### Local Development Setup (Optional)
|
||||
|
||||
If you're developing or modifying the Sora agent locally, you can override the default behavior:
|
||||
|
||||
1. Clone and build the MCP Sora server locally
|
||||
2. Set the environment variable to point to your local installation:
|
||||
|
||||
```bash
|
||||
export MCP_SORA_VIDEO_PATH="/path/to/mcp-servers/src/sora-video/dist/index.js"
|
||||
```
|
||||
|
||||
3. Update the agent YAML to use the local path instead of npx:
|
||||
|
||||
|
||||
|
||||
Add the environment variable to your shell profile (`.bashrc`, `.zshrc`, etc.) to persist across sessions.
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **Plan**: Define your video concept and requirements
|
||||
2. **Generate**: Create the initial video with your prompt
|
||||
3. **Monitor**: Check progress and wait for completion
|
||||
4. **Download**: Save the completed video to your device
|
||||
5. **Iterate**: Create variations or remixes as needed
|
||||
6. **Organize**: Manage your video library efficiently
|
||||
|
||||
This agent makes AI video generation accessible and efficient, providing all the tools you need to create professional-quality videos with OpenAI's Sora technology.
|
||||
Reference in New Issue
Block a user