Update README.md
Browse files
README.md
CHANGED
@@ -1,4 +1,89 @@
|
|
1 |
---
|
2 |
license: apache-2.0
|
3 |
---
|
4 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
license: apache-2.0
|
3 |
---
|
4 |
+
Below is a sample README file for the repository. You can adjust the sections as needed:
|
5 |
+
|
6 |
+
---
|
7 |
+
|
8 |
+
# Qwen2.5-Coder-14B Houdini Vex Functions
|
9 |
+
|
10 |
+
This repository hosts a fine-tuned version of the **Qwen2.5-Coder-14B** model, optimized specifically for generating Houdini VEX functions. The model has been fine-tuned using Houdini VEX Functions data and is designed to assist developers and technical artists working in Houdini.
|
11 |
+
|
12 |
+
## Model Details
|
13 |
+
|
14 |
+
- **Base Model:** Qwen2.5-Coder-14B
|
15 |
+
- **Fine-Tuning:** Finetuned using Houdini VEX Functions data
|
16 |
+
- **Architecture:** qwen2
|
17 |
+
- **Model Size:** 14.8B parameters
|
18 |
+
- **Quantization:** 8-bit (Q8_0)
|
19 |
+
- **License:** [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0)
|
20 |
+
|
21 |
+
## Features
|
22 |
+
|
23 |
+
- **Houdini VEX Expertise:** Specially adapted to generate Houdini VEX code.
|
24 |
+
- **Procedural Workflow:** Ideal for creating procedural geometry, effects, and other Houdini-specific functions.
|
25 |
+
- **Efficient Performance:** Utilizes 8-bit quantization for faster inference while maintaining quality.
|
26 |
+
|
27 |
+
## Installation
|
28 |
+
|
29 |
+
To use this model, ensure you have the required dependencies installed. You can install the necessary Python packages using pip:
|
30 |
+
|
31 |
+
```bash
|
32 |
+
pip install transformers torch
|
33 |
+
```
|
34 |
+
|
35 |
+
Then, load the model in your Python script as follows:
|
36 |
+
|
37 |
+
```python
|
38 |
+
from transformers import AutoTokenizer, AutoModelForCausalLM
|
39 |
+
|
40 |
+
model_name = "pahaadi/Qwen2.5-Coder-14B-houdini_vex_functions"
|
41 |
+
tokenizer = AutoTokenizer.from_pretrained(model_name)
|
42 |
+
model = AutoModelForCausalLM.from_pretrained(model_name, trust_remote_code=True)
|
43 |
+
|
44 |
+
# Example usage: Generate Houdini VEX code
|
45 |
+
prompt = "Write a Houdini VEX function that creates procedural geometry."
|
46 |
+
inputs = tokenizer(prompt, return_tensors="pt")
|
47 |
+
outputs = model.generate(**inputs, max_length=256)
|
48 |
+
generated_code = tokenizer.decode(outputs[0], skip_special_tokens=True)
|
49 |
+
print(generated_code)
|
50 |
+
```
|
51 |
+
|
52 |
+
## Usage
|
53 |
+
|
54 |
+
This model is tailored for tasks such as:
|
55 |
+
- Generating Houdini VEX functions.
|
56 |
+
- Assisting with procedural generation tasks in Houdini.
|
57 |
+
- Accelerating coding workflows in Houdini-based projects.
|
58 |
+
|
59 |
+
Feel free to integrate the model into your Houdini pipeline to enhance your creative coding process.
|
60 |
+
|
61 |
+
## Fine-Tuning and Contributions
|
62 |
+
|
63 |
+
If you are interested in further fine-tuning this model or adapting it for other Houdini-related tasks, contributions and suggestions are welcome. Please follow the guidelines provided in the [Hugging Face documentation](https://huggingface.co/docs) for model fine-tuning and deployment.
|
64 |
+
|
65 |
+
## License
|
66 |
+
|
67 |
+
This model is released under the [Apache-2.0 License](https://www.apache.org/licenses/LICENSE-2.0).
|
68 |
+
|
69 |
+
## Citation
|
70 |
+
|
71 |
+
If you use this model in your research or projects, please consider citing it as follows:
|
72 |
+
|
73 |
+
```bibtex
|
74 |
+
@misc{pahaadi2025qwen2.5,
|
75 |
+
author = {pahaadi},
|
76 |
+
title = {Qwen2.5-Coder-14B Houdini Vex Functions},
|
77 |
+
year = {2025},
|
78 |
+
publisher = {Hugging Face},
|
79 |
+
url = {https://huggingface.co/pahaadi/Qwen2.5-Coder-14B-houdini_vex_functions}
|
80 |
+
}
|
81 |
+
```
|
82 |
+
|
83 |
+
## Acknowledgments
|
84 |
+
|
85 |
+
Special thanks to the contributors and the Hugging Face community for their continuous support and for providing an open platform for sharing and developing innovative machine learning models.
|
86 |
+
|
87 |
+
---
|
88 |
+
|
89 |
+
This README provides an overview of the model, usage instructions, and additional details that help users understand and integrate the model into their projects.
|