word2num is a Python package for converting numbers expressed in natural language to numerical values. It supports:

• Fractions
• Decimals
• Negative values
• Large numbers into the quintillions
• Digit sequences
• Fuzzy string matching

• 🛠️ Installation
• 💻 Usage
• 🐻 Fuzzy String Matching
  • Default Fuzzy Threshold
  • Custom Fuzzy Threshold
  • Disable Fuzzy Matching
• 🌐 Language Support
• 🤝 Contributing
• 📃 License

To use word2num, you must first install it. You can do this using pip by running the following command in your terminal:

pip install word2num

Once installed, you can use word2num to convert numbers expressed in natural language to numerical values. To parse a single string, use the word2num convenience function:

from word2num import word2num

word2num("fifty-seven thousand four hundred and twenty-one")  # 57421

If you need to parse multiple strings, you can create your own instance of Word2Num and call its parse method:

from word2num import Word2Num

w2n = Word2Num()
w2n.parse("one hundred and one")     # 101
w2n.parse("seventeen billion")       # 17000000000
w2n.parse("negative eight")          # -8
w2n.parse("half")                    # 0.5
w2n.parse("one and three quarters")  # 1.75
w2n.parse("one three three seven")   # 1337

Note that these functions will return None if a valid numerical value couldn't be interpreted.

word2num uses fuzzy string matching to help parse misspelled number words.

By default, word2num uses a fuzzy threshold of 80, which means that it will match a word to a number if the fuzzy score is 80 or higher.

You can change the fuzzy threshold by passing a fuzzy_threshold parameter to the word2num function or to the Word2Num class constructor:

# Using the word2num function
word2num("soxteeeen", fuzzy_threshold=60) # [16]

# Using the Word2Num class
w2n = Word2Num(fuzzy_threshold=60)
w2n.parse("twoo hunrdered and twienty-too")  # [222]

To disable fuzzy matching (exact matching only), you can set the fuzzy_threshold to 100:

w2n = Word2Num(fuzzy_threshold=100)
w2n.parse("two hundered and twinty-two")  # None

• English
• Spanish

We'd love to add support for other languages. Contributions are more than welcome, so if you're interested in contributing, see the "Contributing" section below!

Contributions to word2num are more than welcome! If you'd like to contribute, please follow these guidelines:

• Make sure the tests pass by running pytest in the root directory of the repository.
• If appropriate, add new tests to cover your changes.
• Follow the existing code style and conventions.
• Create a pull request with your changes.

word2num is released under the MIT License. See LICENSE.txt for more information.