Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A Python wrapper for Andrew Tridgell's spamsum algorithm

Project description

spamsum is a fuzzy hash specifically designed for hashing email messages to detect if they are SPAM. The spamsum utility includes the ability to generate the spamsum hash and check a new message against a existing set of hashes to find a match.

pyspamsum is a Python wrapper for the core API of spamsum.

The original spamsum code has been licensed under the terms of the the Perl Artistic License. It has been slightly modified

The original code is Copyright Andrew Tridgell <> 2002. It forms part of Andrew’s junkcode, and is available here:

The spamsum code in this project is derived from an updated version that was published at 2004:

For details on spamsum itself, please see the spamsum README:


At a prompt, run:

$ python install


Once installed, here are some examples of usage:

# Import spamsum and set up some strings
>>> import spamsum
>>> s1 = "I am the very model of a modern Major-General, I've information animal and vegetable and mineral"
>>> s2 = "I am the very model of a modern Brigadier, I've information animal and vegetable and something else"
>>> s3 = "Huh? Gilbert and Who?"

# Evaluate the edit distance between two strings
>>> spamsum.edit_distance(s1, s2)

# Evaluate the spamsum of some strings
>>> sum1 = spamsum.spamsum(s1)
>>> sum2 = spamsum.spamsum(s2)
>>> sum3 = spamsum.spamsum(s2)
>>> print sum1

# Compare two spamsums. 0 = no match, 100 = perfect match.
>>> spamsum.match(sum1, sum1)
>>> spamsum.match(sum1, sum2)
>>> spamsum.match(sum1, sum3)

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyspamsum-1.0.4-cp27-cp27m-macosx_10_12_x86_64.whl (11.6 kB) Copy SHA256 hash SHA256 Wheel cp27 May 30, 2018
pyspamsum-1.0.4-cp34-cp34m-macosx_10_12_x86_64.whl (9.9 kB) Copy SHA256 hash SHA256 Wheel cp34 May 30, 2018
pyspamsum-1.0.4-cp35-cp35m-macosx_10_12_x86_64.whl (11.8 kB) Copy SHA256 hash SHA256 Wheel cp35 May 30, 2018
pyspamsum-1.0.4-cp36-cp36m-macosx_10_12_x86_64.whl (11.8 kB) Copy SHA256 hash SHA256 Wheel cp36 May 30, 2018
pyspamsum-1.0.4.tar.gz (12.1 kB) Copy SHA256 hash SHA256 Source None May 30, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page