---
id: wonderwords
version: "3.0.1"
license: MIT License Copyright (c) 2020 Maxim Rebguns Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# wonderwords — Generate random english words and phrases.

License: permissive · Maintenance: aging · Downloads: 632.5K/mo

## What it is and what it does

Wonderwords is a pure-Python library for generating random English words and sentences. It provides a RandomWord class for generating individual words with optional filters (length, starting/ending patterns, part of speech, regex matching) and a RandomSentence class for generating structured random sentences. The package includes a command-line interface for quick generation without writing code.

The library has no external runtime dependencies and supports Python 3.8 through 3.12. It's useful for test data generation, placeholder text, creative writing tools, or any application needing randomized English vocabulary. The API is straightforward—instantiate a class and call methods with optional filter parameters—and the documentation is comprehensive.

Use it for:

- Generate test data and fixtures for unit tests without hardcoding specific word values.
- Create placeholder or dummy text in applications during development or prototyping.
- Build word games, puzzles, or educational tools that need randomized vocabulary.
- Populate database seeds or sample datasets with realistic English words.
- Generate random prompts or creative writing seeds for brainstorming tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates random English words and sentences with filtering options (by length, starting/ending characters, part of speech, or regex), plus a command-line interface for quick generation.

Yes. The package is stable, dependency-free, well-documented, and solves a straightforward problem with a clean API. The aging maintenance status (288 days since last release) is not a blocker for a mature utility package with no known vulnerabilities. Install it if you need random word or sentence generation; the low friction and permissive license make it a safe choice.

## Install

pip install wonderwords
uv add wonderwords
poetry add wonderwords

## Installing wonderwords

Before you install: Low friction install with no runtime dependencies. Maintenance status is aging—last release was 288 days ago—but the repository remains active and the package is marked Production/Stable.

License in practice: MIT License permits unrestricted use, modification, and distribution with only attribution and liability disclaimer required. No restrictions on commercial or private use.

Quickstart:

pip install wonderwords

from wonderwords import RandomWord

r = RandomWord()
print(r.word())
print(r.word(starts_with="a", word_max_length=8))
print(r.random_words(3, include_parts_of_speech=["nouns"]))

Verify before relying:

- Whether the word list is comprehensive enough for production use cases requiring specialized vocabulary domains.
- Performance characteristics when filtering against very large result sets or complex regex patterns.
- Whether custom word lists can be loaded from external sources or must be defined in code.

## Package facts

- License: MIT License Copyright (c) 2020 Maxim Rebguns Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 632.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random word generator, random sentence generation, word filtering by length, part of speech filtering, random text generation, english word randomizer, cli word generator, text-generation, testing-utilities

[View on SkillFed](https://skillfed.io/packages/wonderwords) · [View on PyPI](https://pypi.org/project/wonderwords/)