SuNavar commited on
Commit
e4331f1
·
verified ·
1 Parent(s): 28d0ceb

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +98 -5
README.md CHANGED
@@ -1,14 +1,107 @@
1
  ---
2
- license: apache-2.0
3
  language:
4
  - en
5
- - es
6
- base_model:
7
- - Qwen/Qwen2.5-7B-Instruct
8
  pipeline_tag: text-generation
 
9
  tags:
10
  - davinci-resolve
11
  - video-editing
12
  - local-inference
13
  - gguf
14
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
 
2
  language:
3
  - en
4
+ license: apache-2.0
 
 
5
  pipeline_tag: text-generation
6
+ library_name: llama-cpp
7
  tags:
8
  - davinci-resolve
9
  - video-editing
10
  - local-inference
11
  - gguf
12
+ - qwen
13
+ base_model: Qwen/Qwen2.5-7B-Instruct
14
+ ---
15
+
16
+ # Pygenesis ResolveExpert
17
+
18
+ Pygenesis ResolveExpert is a task-oriented assistant model for **DaVinci Resolve** workflows (Edit, Color, Fusion, Fairlight, Deliver), packaged for local inference as GGUF.
19
+
20
+ ## Model Overview
21
+
22
+ `pygenesis-resolve-q4km.gguf` is a quantized local-inference variant of a Resolve-focused fine-tuned model.
23
+
24
+ Main goals:
25
+ - Provide practical, step-by-step help for real editing and post-production tasks.
26
+ - Keep latency reasonable on desktop hardware.
27
+ - Run fully on-device with no cloud dependency.
28
+
29
+ ## Studio vs Free: Context Behavior
30
+
31
+ The model is the same in both editions.
32
+ The key difference is **how runtime context is provided**.
33
+
34
+ ### DaVinci Resolve Studio (Integrated Plugin)
35
+
36
+ In Studio, the Workflow Integration plugin can automatically read and pass context such as:
37
+ - Current Resolve page (`Media`, `Cut`, `Edit`, `Fusion`, `Color`, `Fairlight`, `Deliver`)
38
+ - Current project and timeline names
39
+ - Basic timeline metadata
40
+
41
+ This usually improves relevance because answers are grounded in the user’s current working state.
42
+
43
+ ### DaVinci Resolve Free (Companion App)
44
+
45
+ Resolve Free does not support the Workflow Integration plugin, so usage is via **Pygenesis Companion** (external app).
46
+
47
+ In this mode, context is provided manually:
48
+ - User selects the active page
49
+ - User can optionally provide project/timeline names
50
+
51
+ The model quality is unchanged, but contextual precision depends on the information entered by the user.
52
+
53
+ ## Practical Summary
54
+
55
+ - **Same model weights** in Studio and Free.
56
+ - **Studio**: automatic context -> more situational responses.
57
+ - **Free**: manual context -> still useful responses, with lower contextual precision when input context is incomplete.
58
+
59
+ ## Recommended Use Cases
60
+
61
+ - Resolve workflow troubleshooting ("how do I do X in Color/Fusion/Edit?").
62
+ - Page-specific checklists ("what should I review here?").
63
+ - Export and performance best practices.
64
+ - Actionable next steps for practical post-production decisions.
65
+
66
+ ## Limitations
67
+
68
+ - Not a replacement for official Blackmagic documentation.
69
+ - Advanced workflows may still require iterative clarification.
70
+ - In Free mode, missing manual context can reduce specificity.
71
+
72
+ ## Prompting Tips
73
+
74
+ For best results, include:
75
+ - Current Resolve page.
76
+ - Clear goal ("match two shots", "export for YouTube 4K", etc.).
77
+ - Constraints (GPU, Resolve version, footage type, deadline).
78
+
79
+ Example:
80
+ > "I am on the Color page. I have two shots with different exposure and need a fast matching workflow without damaging skin tones."
81
+
82
+ ## Installation & Usage
83
+
84
+ Pygenesis ResolveExpert is distributed as a **packaged installer**, not as a manual developer setup.
85
+
86
+ The installer handles:
87
+ - GPU detection and inference backend selection (CUDA, Vulkan, or CPU)
88
+ - Model download from this Hugging Face repository
89
+ - UI installation for your Resolve edition
90
+
91
+ After installation:
92
+
93
+ | Edition | How you use it |
94
+ |---------|----------------|
95
+ | **DaVinci Resolve Studio** | Open the integrated plugin from **Workspace → Workflow Integrations → Pygenesis Resolve Tutor** |
96
+ | **DaVinci Resolve Free** | Launch **Pygenesis Companion** (standalone app installed alongside the model) |
97
+
98
+ Inference runs locally on your machine. No account or API key is required beyond downloading the model through the installer.
99
+
100
+ ## Intended Users
101
+
102
+ Editors, colorists, and technical users who want a local assistant tailored to DaVinci Resolve workflows.
103
+
104
+ ## Acknowledgements
105
+
106
+ - Built for the Pygenesis ResolveExpert project.
107
+ - Resolve integration behavior follows Blackmagic’s Studio/Free plugin constraints.