Update README.md
Browse files
README.md
CHANGED
|
@@ -1,6 +1,92 @@
|
|
|
|
|
|
|
|
| 1 |
---
|
|
|
|
| 2 |
license: apache-2.0
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 3 |
---
|
| 4 |
|
| 5 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Thank you for the clarification. Here's the updated model card with the correct link and ownership information.
|
| 2 |
+
|
| 3 |
---
|
| 4 |
+
|
| 5 |
license: apache-2.0
|
| 6 |
+
language:
|
| 7 |
+
- en
|
| 8 |
+
pipeline_tag: text-generation
|
| 9 |
+
tags:
|
| 10 |
+
- role-play
|
| 11 |
+
- fine-tuned
|
| 12 |
+
- qwen2
|
| 13 |
+
base_model: Qwen/Qwen2-1.5B
|
| 14 |
---
|
| 15 |
|
| 16 |
+
# Oxy 1 Micro
|
| 17 |
+
|
| 18 |
+

|
| 19 |
+
|
| 20 |
+
## Introduction
|
| 21 |
+
|
| 22 |
+
**Oxy 1 Micro** is a fine-tuned version of the [Qwen2-1.5B](https://huggingface.co/Qwen/Qwen2-1.5B) language model, specialized for **role-play** scenarios. Despite its small size, it delivers impressive performance in generating engaging dialogues and interactive storytelling.
|
| 23 |
+
|
| 24 |
+
Developed by **Oxygen (oxyapi)**, with contributions from **TornadoSoftwares**, Oxy 1 Micro aims to provide an accessible and efficient language model for creative and immersive role-play experiences.
|
| 25 |
+
|
| 26 |
+
## Model Details
|
| 27 |
+
|
| 28 |
+
- **Model Name**: Oxy 1 Micro
|
| 29 |
+
- **Model ID**: [oxyapi/oxy-1-micro](https://huggingface.co/oxyapi/oxy-1-micro)
|
| 30 |
+
- **Base Model**: [Qwen/Qwen2-1.5B](https://huggingface.co/Qwen/Qwen2-1.5B)
|
| 31 |
+
- **Model Type**: Chat Completions
|
| 32 |
+
- **License**: Apache-2.0
|
| 33 |
+
- **Language**: English
|
| 34 |
+
- **Tokenizer**: [Qwen/Qwen2.5-1.5B-Instruct](https://huggingface.co/Qwen/Qwen2.5-1.5B-Instruct)
|
| 35 |
+
- **Max Input Tokens**: 32,768
|
| 36 |
+
- **Max Output Tokens**: 8,192
|
| 37 |
+
|
| 38 |
+
### Features
|
| 39 |
+
|
| 40 |
+
- **Fine-tuned for Role-Play**: Specially trained to generate dynamic and contextually rich role-play dialogues.
|
| 41 |
+
- **Efficient**: Compact model size allows for faster inference and reduced computational resources.
|
| 42 |
+
- **Parameter Support**:
|
| 43 |
+
- `temperature`
|
| 44 |
+
- `top_p`
|
| 45 |
+
- `top_k`
|
| 46 |
+
- `frequency_penalty`
|
| 47 |
+
- `presence_penalty`
|
| 48 |
+
- `max_tokens`
|
| 49 |
+
|
| 50 |
+
### Metadata
|
| 51 |
+
|
| 52 |
+
- **Owned by**: Oxygen (oxyapi)
|
| 53 |
+
- **Contributors**: TornadoSoftwares
|
| 54 |
+
- **Description**: A Qwen2-1.5B fine-tune for role-play; small model but still good.
|
| 55 |
+
|
| 56 |
+
## Usage
|
| 57 |
+
|
| 58 |
+
To utilize Oxy 1 Micro for text generation in role-play scenarios, you can load the model using the Hugging Face Transformers library:
|
| 59 |
+
|
| 60 |
+
```python
|
| 61 |
+
from transformers import AutoModelForCausalLM, AutoTokenizer
|
| 62 |
+
|
| 63 |
+
tokenizer = AutoTokenizer.from_pretrained("oxyapi/oxy-1-micro")
|
| 64 |
+
model = AutoModelForCausalLM.from_pretrained("oxyapi/oxy-1-micro")
|
| 65 |
+
|
| 66 |
+
prompt = "You are a wise old wizard in a mystical land. A traveler approaches you seeking advice."
|
| 67 |
+
inputs = tokenizer(prompt, return_tensors="pt")
|
| 68 |
+
outputs = model.generate(**inputs, max_length=500)
|
| 69 |
+
response = tokenizer.decode(outputs[0], skip_special_tokens=True)
|
| 70 |
+
print(response)
|
| 71 |
+
```
|
| 72 |
+
|
| 73 |
+
## Performance
|
| 74 |
+
|
| 75 |
+
Performance benchmarks for Oxy 1 Micro are not available at this time. Future updates may include detailed evaluations on relevant datasets.
|
| 76 |
+
|
| 77 |
+
## License
|
| 78 |
+
|
| 79 |
+
This model is licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0).
|
| 80 |
+
|
| 81 |
+
## Citation
|
| 82 |
+
|
| 83 |
+
If you find Oxy 1 Micro useful in your research or applications, please cite it as:
|
| 84 |
|
| 85 |
+
```
|
| 86 |
+
@misc{oxy1micro2024,
|
| 87 |
+
title={Oxy 1 Micro: A Fine-Tuned Qwen2-1.5B Model for Role-Play},
|
| 88 |
+
author={Oxygen (oxyapi)},
|
| 89 |
+
year={2024},
|
| 90 |
+
howpublished={\url{https://huggingface.co/oxyapi/oxy-1-micro}},
|
| 91 |
+
}
|
| 92 |
+
```
|