SuNavar's picture
Update README.md
e4331f1 verified
|
Raw
History Blame Contribute Delete
3.77 kB
---
language:
- en
license: apache-2.0
pipeline_tag: text-generation
library_name: llama-cpp
tags:
- davinci-resolve
- video-editing
- local-inference
- gguf
- qwen
base_model: Qwen/Qwen2.5-7B-Instruct
---
# Pygenesis ResolveExpert
Pygenesis ResolveExpert is a task-oriented assistant model for **DaVinci Resolve** workflows (Edit, Color, Fusion, Fairlight, Deliver), packaged for local inference as GGUF.
## Model Overview
`pygenesis-resolve-q4km.gguf` is a quantized local-inference variant of a Resolve-focused fine-tuned model.
Main goals:
- Provide practical, step-by-step help for real editing and post-production tasks.
- Keep latency reasonable on desktop hardware.
- Run fully on-device with no cloud dependency.
## Studio vs Free: Context Behavior
The model is the same in both editions.
The key difference is **how runtime context is provided**.
### DaVinci Resolve Studio (Integrated Plugin)
In Studio, the Workflow Integration plugin can automatically read and pass context such as:
- Current Resolve page (`Media`, `Cut`, `Edit`, `Fusion`, `Color`, `Fairlight`, `Deliver`)
- Current project and timeline names
- Basic timeline metadata
This usually improves relevance because answers are grounded in the user’s current working state.
### DaVinci Resolve Free (Companion App)
Resolve Free does not support the Workflow Integration plugin, so usage is via **Pygenesis Companion** (external app).
In this mode, context is provided manually:
- User selects the active page
- User can optionally provide project/timeline names
The model quality is unchanged, but contextual precision depends on the information entered by the user.
## Practical Summary
- **Same model weights** in Studio and Free.
- **Studio**: automatic context -> more situational responses.
- **Free**: manual context -> still useful responses, with lower contextual precision when input context is incomplete.
## Recommended Use Cases
- Resolve workflow troubleshooting ("how do I do X in Color/Fusion/Edit?").
- Page-specific checklists ("what should I review here?").
- Export and performance best practices.
- Actionable next steps for practical post-production decisions.
## Limitations
- Not a replacement for official Blackmagic documentation.
- Advanced workflows may still require iterative clarification.
- In Free mode, missing manual context can reduce specificity.
## Prompting Tips
For best results, include:
- Current Resolve page.
- Clear goal ("match two shots", "export for YouTube 4K", etc.).
- Constraints (GPU, Resolve version, footage type, deadline).
Example:
> "I am on the Color page. I have two shots with different exposure and need a fast matching workflow without damaging skin tones."
## Installation & Usage
Pygenesis ResolveExpert is distributed as a **packaged installer**, not as a manual developer setup.
The installer handles:
- GPU detection and inference backend selection (CUDA, Vulkan, or CPU)
- Model download from this Hugging Face repository
- UI installation for your Resolve edition
After installation:
| Edition | How you use it |
|---------|----------------|
| **DaVinci Resolve Studio** | Open the integrated plugin from **Workspace → Workflow Integrations → Pygenesis Resolve Tutor** |
| **DaVinci Resolve Free** | Launch **Pygenesis Companion** (standalone app installed alongside the model) |
Inference runs locally on your machine. No account or API key is required beyond downloading the model through the installer.
## Intended Users
Editors, colorists, and technical users who want a local assistant tailored to DaVinci Resolve workflows.
## Acknowledgements
- Built for the Pygenesis ResolveExpert project.
- Resolve integration behavior follows Blackmagic’s Studio/Free plugin constraints.