horoslop / README.md
rustemgareev's picture
Create README.md
0bb2a3d verified
---
language:
- ru
base_model:
- ai-forever/rugpt3medium_based_on_gpt2
pipeline_tag: text-generation
tags:
- gpt2
- gpt3
- funny
- humor
- russian
- horoscope
- surrealism
---
# Horoslop: The Absurd Russian Horoscope Generator
**Horoslop** is a fine-tuned version of the ruGPT3 model trained to generate surreal, absurd, and humorous horoscopes in Russian.
## Quick Links
* **Live Demo:** [Hugging Face Space](https://huggingface.co/spaces/rustemgareev/horoslop)
* **Telegram Channel:** [t.me/horoslop](https://t.me/horoslop)
## Model Description
This model was fine-tuned on a curated dataset to mimic a specific style: it combines standard astrological phrasing with unexpected objects and surreal actions.
## Usage
This model can be used directly with the Hugging Face `transformers` library.
```python
from transformers import GPT2LMHeadModel, GPT2Tokenizer
model_name = "rustemgareev/horoslop"
tokenizer = GPT2Tokenizer.from_pretrained(model_name)
model = GPT2LMHeadModel.from_pretrained(model_name)
text = "Звёзды советуют"
input_ids = tokenizer.encode(text, return_tensors="pt")
# Recommended generation parameters for maximum absurdity
out = model.generate(
input_ids,
max_new_tokens=60,
repetition_penalty=1.2,
temperature=0.9,
top_k=40,
top_p=0.95,
do_sample=True,
pad_token_id=tokenizer.eos_token_id
)
generated_text = tokenizer.decode(out[0], skip_special_tokens=True)
print(generated_text)
```
## Examples
Here is what the model is capable of (Russian original + English translation):
> **RU:** Астрологи советуют Вам надеть на себя костюм клоуна и начать петь песни. Звёзды советуют вам быть как можно меньше похожим на человека, который любит кошек. Не бойтесь стать настоящим вампиром — вас не тронут.
>
> **EN:** *Astrologers advise you to put on a clown suit and start singing songs. The stars advise you to look as little like a cat lover as possible. Don't be afraid to become a real vampire — they won't touch you.*
> **RU:** Подходящий день, чтобы купить новый холодильник. В начале дня можно стать вегетарианцем и начать питаться травой. Вы поймёте: жизнь — это сплошная лотерея. Ночью вам предстоит быть рядом со своим демоном.
>
> **EN:** *A suitable day to buy a new refrigerator. At the start of the day, you can become a vegetarian and start eating grass. You will understand: life is a total lottery. At night, you will have to be close to your demon.*
> **RU:** Звёзды предупреждают: в вашей жизни будет всё, кроме любви. Не бойтесь стать кем-то вроде клоуна или бомжа. Это поможет избавиться от страха перед смертью.
>
> **EN:** *The stars warn: your life will have everything except love. Don't be afraid to become something like a clown or a bum. This will help get rid of the fear of death.*
## Limitations & Bias
This model is designed for **entertainment purposes only**. It generates text based on patterns found in a humorous dataset.
* **Hallucinations:** The model generates nonsense by design. Do not use for real advice.
* **Tone:** The humor can be dark, absurd, or nonsensical.
## Specs
- **Base Architecture:** GPT-2 (ruGPT3-medium)
- **Language:** Russian
- **Pipeline:** Text Generation
- **Fine-tuning:** Full fine-tune