{"id":28384430,"url":"https://github.com/runpod-workers/worker-fasthunyuan","last_synced_at":"2025-06-25T23:31:09.958Z","repository":{"id":271105308,"uuid":"911635612","full_name":"runpod-workers/worker-fasthunyuan","owner":"runpod-workers","description":"WIP","archived":false,"fork":false,"pushed_at":"2025-01-03T13:39:31.000Z","size":5,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-23T13:56:51.523Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/runpod-workers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-03T13:38:37.000Z","updated_at":"2025-03-08T04:12:59.000Z","dependencies_parsed_at":"2025-01-05T15:24:13.831Z","dependency_job_id":"39841fb6-ae92-459c-a734-0675896eaa28","html_url":"https://github.com/runpod-workers/worker-fasthunyuan","commit_stats":null,"previous_names":["runpod-workers/worker-fasthunyuan"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/runpod-workers/worker-fasthunyuan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runpod-workers%2Fworker-fasthunyuan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runpod-workers%2Fworker-fasthunyuan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runpod-workers%2Fworker-fasthunyuan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runpod-workers%2Fworker-fasthunyuan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runpod-workers","download_url":"https://codeload.github.com/runpod-workers/worker-fasthunyuan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runpod-workers%2Fworker-fasthunyuan/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261972578,"owners_count":23238537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-30T08:38:37.244Z","updated_at":"2025-06-25T23:31:09.939Z","avatar_url":"https://github.com/runpod-workers.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FastHunyuan RunPod Worker\r\n\r\nThis is a RunPod worker implementation for FastHunyuan, a fast inference version of the Hunyuan text-to-video model.\r\n\r\n## Development Guide\r\n\r\n### Prerequisites\r\n\r\n- RunPod account with API access\r\n- NVIDIA GPU with CUDA support\r\n- (Optional) VSCode for remote development\r\n\r\n### Development Setup\r\n\r\n1. Create a development pod on RunPod:\r\n\r\n   - Go to [RunPod Console](https://www.runpod.io/console/pods)\r\n   - Click \"Deploy\"\r\n   - Select base image: `runpod/pytorch:2.1.2-py3.10-cuda12.1.0` (includes SSH and JupyterLab)\r\n   - Choose your GPU type\r\n   - Name your pod (e.g., \"fasthunyuan-dev\")\r\n   - Deploy\r\n\r\n2. Connect to your pod (choose one method):\r\n\r\n   a. Using RunPod Web Terminal:\r\n\r\n   - Click \"Connect\" on your pod in RunPod console\r\n   - Select \"SSH Terminal\" or use the web terminal\r\n\r\n   b. Using VSCode (Recommended for development):\r\n\r\n   - Follow the [official RunPod guide for VSCode setup](https://docs.runpod.io/tutorials/pods/connect-to-vscode)\r\n   - This allows you to develop directly on the pod with full IDE support\r\n\r\n3. Install dependencies:\r\n\r\n   ```bash\r\n   cd /workspace\r\n   chmod +x builder/install.sh\r\n   ./builder/install.sh\r\n   ```\r\n\r\n4. Test the handler:\r\n   ```bash\r\n   python src/handler.py\r\n   ```\r\n\r\n### Development Tips\r\n\r\n- The handler is located in `src/handler.py`\r\n- Dependencies are managed in `builder/requirements.txt`\r\n- System dependencies and installation steps are in `builder/install.sh`\r\n- Using VSCode remote development provides a better development experience with:\r\n  - Integrated terminal\r\n  - Code completion\r\n  - Debugging capabilities\r\n  - Git integration\r\n\r\n## Production Guide\r\n\r\n### Building the Docker Image\r\n\r\n1. Build the image:\r\n\r\n   ```bash\r\n   docker build -t your-registry/fasthunyuan-worker:version .\r\n   ```\r\n\r\n   Note: For production, we use a minimal base image (`nvidia/cuda:12.1.0-cudnn8-devel-ubuntu22.04`) without development tools.\r\n\r\n2. Push to your registry:\r\n   ```bash\r\n   docker push your-registry/fasthunyuan-worker:version\r\n   ```\r\n\r\n### Deploying on RunPod\r\n\r\n1. Create a template on RunPod:\r\n\r\n   - Base image: your-registry/fasthunyuan-worker:version\r\n   - Container disk: at least 10GB\r\n   - HTTP endpoints: enabled\r\n   - Environment variables:\r\n     ```\r\n     HUGGING_FACE_HUB_TOKEN=your_token\r\n     ```\r\n\r\n2. Deploy serverless endpoints using the template\r\n\r\n### API Usage\r\n\r\nExample request:\r\n\r\n```json\r\n{\r\n  \"input\": {\r\n    \"prompt\": \"A cinematic video of a beautiful landscape\",\r\n    \"height\": 720,\r\n    \"width\": 1280,\r\n    \"num_frames\": 45,\r\n    \"num_inference_steps\": 6,\r\n    \"seed\": 1024,\r\n    \"fps\": 24\r\n  }\r\n}\r\n```\r\n\r\nExample response:\r\n\r\n```json\r\n{\r\n  \"video_path\": \"/tmp/output_1024.mp4\"\r\n}\r\n```\r\n\r\n## Project Structure\r\n\r\n```\r\n.\r\n├── builder/\r\n│   ├── install.sh        # Development installation script\r\n│   └── requirements.txt  # Python dependencies\r\n├── src/\r\n│   └── handler.py        # RunPod handler implementation\r\n├── Dockerfile           # Production container definition\r\n└── README.md           # This file\r\n```\r\n\r\n## License\r\n\r\nThis project is licensed under the Apache License 2.0 - see the LICENSE file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunpod-workers%2Fworker-fasthunyuan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frunpod-workers%2Fworker-fasthunyuan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunpod-workers%2Fworker-fasthunyuan/lists"}