Persian Modernist Poetry Word Cloud

Persian Modernist Poetry Word Cloud

Draws a word cloud of the words a chosen Persian modernist poet uses most, from the Shereno poem dataset, for readers and students of Persian poetry.

Made by HalflingWizard on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: This Gradio app draws a word cloud for a Persian modernist poet you pick from a list of 40. It reads the Shereno poem dataset, stored as a CSV file in the repository. Larger words in a cloud are the ones the poet used more often.

Who it suits: It suits readers, students and teachers of Persian literature who want a quick look at the words a poet repeats. The author says such clouds may hint at a poet's recurring themes. It was inspired by an earlier word cloud for traditional Persian poetry.

Industry | Who uses it | How they use it | Example
Education | Literature teachers | Show a class which words a poet repeats | Pick a poet and put two clouds side by side
Research | Students of Persian poetry | Look for recurring words and themes | Note the largest words in one poet's cloud
Publishing | Writers and editors | Keep a cloud in view while writing about a poet | Check a poet's frequent words before drafting

You can skip it if you need deeper text analysis than word frequency.

Where to use it:

• A web browser, on the Space's page on Hugging Face
• Windows, macOS or Linux with Python, from a downloaded copy

Use case | Who | What they get back
Compare poets | Teachers and students | A word cloud image for each poet you pick
Spot frequent words | Readers of poetry | A picture where common words stand out

How to set it up:

• Nothing at all if you use the online Space
• Python on your computer, only if you run a copy
• The packages listed in requirements.txt

1. Open the Space's page in a browser to use it with nothing to install.
2. To run a copy, install the Hugging Face Hub package and download the Space.
3. Move into the new folder, then install Gradio and the listed requirements.
4. Start the app with Python.

pip install -U huggingface_hub
hf download HalflingWizard/Shereno-Word-Cloud --repo-type space --local-dir Shereno-Word-Cloud
cd Shereno-Word-Cloud
pip install gradio
pip install -r requirements.txt
python app.py

How to use it: Choose a poet from the list in the app, and it returns a word cloud image built from that poet's poems. On your own machine, run the main file first, then use the page it serves.

python app.py

Example: You pick one poet from the list of 40. The app returns a word cloud image of that poet's poems, where the most frequent words stand out in a larger size.

For newcomers and experts: A word cloud is a picture of words, with the most common ones drawn biggest. Start by opening the Space and choosing any poet, then compare what you see with a second poet.

If you know the field, the app does plain word frequency over one CSV file of poems. It does no meaning analysis, so related word forms and common function words are counted as the data gives them.

You choose a poet from the list
The app filters that poet's poems in the CSV
It counts how often each word appears
It draws the word cloud image

Good to know:

• License: listed as cc on the Space
• Cost to run: none named
• Data it reaches: the Shereno dataset in shereno.csv, which ships in the repository
• Not for: the record names no exclusions, and it covers only the poets in its list

On Hugging Face, 13 November 2026

• Likes: 0
• Built with: gradio
• License: cc

Links

• Space: https://huggingface.co/spaces/HalflingWizard/Shereno-Word-Cloud
• Files: https://huggingface.co/spaces/HalflingWizard/Shereno-Word-Cloud/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.