Update README.md

README.md

@@ -1,3 +1,138 @@
----
-license: mit
----
+---
+license: mit
+language:
+- uk
+tags:
+  - natural-language-processing
+  - poetry-generation
+  - text-generation
+  - torch
+  - lstm
+---
+
+This model was trained using [Andrej Karpathy's code](https://github.com/karpathy/char-rnn) on texts by the Ukranian poet [Lesik Panasyuk](https://uk.wikipedia.org/wiki/%D0%9B%D0%B5%D1%81%D0%B8%D0%BA_%D0%9F%D0%B0%D0%BD%D0%B0%D1%81%D1%8E%D0%BA). Models of this type well represent individual poetic style.
+
+Model was trained with size 512 and 7 layers, dropout 0.5.
+
+## Usage
+
+The procedure for installing the required software is described [by Karpathy](https://github.com/karpathy/char-rnn), torch is required, the code is written in lua. Be careful, versions of libraries written many years ago are used.
+
+```bash
+th sample.lua lm_lstm_epoch50.00_1.3890.t7 -length 10000 -temperature 0.5 -primetext 'some text' 
+```
+
+## Train data
+
+Train data is non free due to copyright restrictions.
+
+## What for?
+
+In an era of winning Transformers, ancient RNN models seem archaic. But I see that they still work better than modern architectures with such important categories from the humanities point of view as poetic style.
+
+## Public demonstration
+
+The performance of the model was demonstrated publicly using a screencast (included in this repository).
+
+
+## Samples
+
+### верлибр 1
+
+```
+намагаюсь впернені
+ти соняками
+і наспрасвою бозсірітає своїми тобі я приходить водними датими нас то потальця
+і підіймається біло піднаться до тебе
+забів видати
+і не видинав сніг пелеці
+
+Чо знайде тобі тук перевіслось ічени іселоми те про ти хочеш від озеро тебе на руках
+ти пір'їну постілали на перептах білям у сорочки усв убе
+навіть на деревах кротів позбуба
+можли горітись до тебе вигладив знамали
+про то прокинутись вагородини нас трами вирудини
+і все якбу фотоати
+і коли повітря із довтоку
+а дотів устик бо коліроткомо руками до так
+і тука
+
+```
+
+### верлибр 2
+
+```
+незомі житами всередині
+
+Вивчі бравитись таких простор
+як упроворилась
+але не погачили нас то знімати
+тільки під незами випитить де тримаються блистя у небо звікнички із веренятих на неї у не загілчуться
+
+Че це бікається і прийде що бачив тасі не пазаривалі
+наміг витерединий мої вульці
+у приніс
+бо слізаєш стоєш і поначи
+чи білий читами кахом
+і наспрастись
+коли западетьми дерева щоб не закунчились
+але мож сокі пройде станнях
+за може подати
+в бені дочика руках таки батись
+на твої губа
+які ніска 
+навіть коле ї посідать вододало падати
+
+Я прос
+
+```
+
+### верлибр 3
+
+```
+я зернанів
+було винаються дощу
+щоб знаєш лажко знайти тукали
+подімаєш як вертрумали
+але не помічаєш коли привидають впіймати просторі
+закатить бриниці колоні
+що страмну відковарить
+а те закінченнясті
+яки заризаєш в сірну тобі на вилиці
+
+Колі ховісь вухоті закожнені видити просторі
+заленьці були щоб пастрипутись але як не падучені
+
+ІІ
+
+Обліпоче не віртру
+із оден твоїх очей
+і ти спого він як велися рікаються до середині
+а мухою
+ти я колінає спотів
+наче що теплі
+під досов
+ти у тебе пір'я сумою
+але повернути сіднову свої вухов яй лісту
+
+
+Щоми з
+
+```
+
+## BibTeX entry and citation info
+
+See:
+
+```
+@article{orekhov2020neural,
+  title={Neural reading: Insights from the analysis of poetry generated by artificial neural networks},
+  author={Orekhov, Boris and Fischer, Frank},
+  journal={Orbis Litterarum},
+  volume={75},
+  number={5},
+  pages={230--246},
+  year={2020},
+  publisher={Wiley Online Library}
+}
+```