Word cloud generator

Make a word cloud picture from text or from a list of weighted words, with a choice of size and colours. Counts the words, sizes each by its share, and packs them from the centre along a spiral. The result lists the words drawn with their counts.

Input

Text to count words in. The more often a word appears, the larger it is drawn.
Instead of text: an object that gives each word a weight, such as {"coffee": 12, "tea": 7}.
Width of the picture in pixels.
Height of the picture in pixels.
Draw at most this many words, starting with the most frequent.
Colours for the words.
Background colour: hex such as #ffffff, a basic colour name, or "transparent".
Leave out very common English words such as "the", "and" and "with" when counting text.
When counting text, leave out words with fewer letters than this.
Mixed turns about one word in five on its side. Horizontal keeps every word level.
Change this number to get a different arrangement of the same words.
Picture format.

Result

Choose a file and press Run.

Files you upload and the results are stored for one hour, then deleted. Anyone who has the link can open them, so don't upload anything private.

Use it from code or an agent

curl -s https://setget.net/v1/tools/wordcloud \
  -H 'Content-Type: application/json' \
  -d '{"input":{"text":"Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.","width":600,"height":360},"wait":30}'
import json, urllib.request

body = {'input': {'text': 'Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.', 'width': 600, 'height': 360}, 'wait': 30}
request = urllib.request.Request("https://setget.net/v1/tools/wordcloud", json.dumps(body).encode(),
                                 {"Content-Type": "application/json"})
print(json.load(urllib.request.urlopen(request))["result"])
const response = await fetch("https://setget.net/v1/tools/wordcloud", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({"input":{"text":"Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.","width":600,"height":360},"wait":30}),
});
console.log((await response.json()).result);
Tool: run_tool
Arguments:
{
  "slug": "wordcloud",
  "input": {
    "text": "Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.",
    "width": 600,
    "height": 360
  },
  "wait": 30
}
{
  "input": {
    "text": "Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.",
    "width": 600,
    "height": 360
  },
  "wait": 30
}

This is a file tool, so a call takes three steps: upload the file to get a reference, run the tool with that reference, then read the result and download its files. Uploads and results are public by link and expire after one hour.

Endpoint: POST /v1/tools/wordcloud. Over MCP: run_tool with slug: "wordcloud". Machine-readable: input schema, Markdown. Connect an agent.

Inputs

NameTypeRequiredWhat it does
text string no Text to count words in. The more often a word appears, the larger it is drawn.
words json no Instead of text: an object that gives each word a weight, such as {"coffee": 12, "tea": 7}.
width integer no Width of the picture in pixels. Default: 800. From 200 to 2400.
height integer no Height of the picture in pixels. Default: 500. From 200 to 2400.
max_words integer no Draw at most this many words, starting with the most frequent. Default: 100. From 1 to 300.
palette string no Colours for the words. One of: bright, ocean, sunset, forest, berry, slate. Default: "bright".
background string no Background colour: hex such as #ffffff, a basic colour name, or "transparent". Default: "#ffffff".
remove_stop_words boolean no Leave out very common English words such as "the", "and" and "with" when counting text. Default: true.
min_length integer no When counting text, leave out words with fewer letters than this. Default: 2. From 1 to 20.
orientation string no Mixed turns about one word in five on its side. Horizontal keeps every word level. One of: mixed, horizontal. Default: "mixed".
seed integer no Change this number to get a different arrangement of the same words. Default: 1. From 0 to 1000000.
format string no Picture format. One of: png, webp, jpg. Default: "png".

Examples

Counted from a sentence

Input
{
  "text": "Tea is hot. Coffee is hot. Tea with milk, coffee with sugar, tea with lemon. Green tea, black tea, iced coffee, hot chocolate, warm milk, sweet honey, fresh lemon and mint tea.",
  "width": 600,
  "height": 360
}
Result

Press the example button above to make it.

Weighted words on a dark background

Input
{
  "words": {
    "python": 30,
    "javascript": 24,
    "rust": 14,
    "go": 12,
    "sql": 18,
    "bash": 9,
    "kotlin": 6,
    "swift": 7,
    "ruby": 5,
    "java": 16,
    "typescript": 20,
    "c": 8
  },
  "palette": "ocean",
  "background": "#0f172a",
  "width": 640,
  "height": 400,
  "orientation": "horizontal"
}
Result

Press the example button above to make it.

Questions

How is the size of a word chosen?
By how often it appears, or by the weight you give it. The most frequent word is the largest, and words are placed from the centre outwards so that none overlap.
Will I get the same picture every time?
Yes. The same input and settings always give the same arrangement. Change "seed" for a different one.
Why are some words missing?
Common English words are left out unless you turn "remove_stop_words" off, and the smallest words are dropped when the picture is full. The result lists every word that was drawn.
Which alphabets work?
Latin letters with accents, Greek and Cyrillic. Text is split at spaces and punctuation, so languages written without spaces are not counted correctly.