Word Counter Pack

Count words, characters, and sentences in any text. A simple, zero-dependency text analysis tool that provides word counts, character counts, sentence counts, reading time estimates, and readability metrics.

Quick Start

agentnode install word-counter-pack

from word_counter_pack.tool import run

result = run(text="Hello world, this is a test.")
print(f"{result['word_count']} words, {result['character_count']} characters")

Usage

Basic Word Count

result = run(text="Your text goes here.")
print(f"Words: {result['word_count']}")
print(f"Characters: {result['character_count']}")
print(f"Sentences: {result['sentence_count']}")

Reading Time Estimate

with open("article.txt") as f:
    text = f.read()

result = run(text=text)
print(f"Reading time: {result['reading_time_minutes']:.1f} minutes")
print(f"Avg words per sentence: {result['avg_words_per_sentence']:.1f}")

Character Limit Validation

tweet = "Excited to announce our new AI agent toolkit!"
result = run(text=tweet)
if result["character_count"] <= 280:
    print("Tweet is within character limit")

API Reference

Parameter	Type	Description
text	str	The text to analyze

Return Field	Type	Description
word_count	int	Total number of words
character_count	int	Total characters including spaces
character_count_no_spaces	int	Characters excluding spaces
sentence_count	int	Number of sentences
paragraph_count	int	Number of paragraphs
avg_words_per_sentence	float	Average sentence length
reading_time_minutes	float	Estimated reading time (238 wpm)

Zero dependencies. Works entirely offline.

License

MIT