Hi everyone,

For the past few months I’ve been building a personal project called NumClass: a Python CLI tool that analyzes an integer and classifies it into a large set of number-theory properties.

The idea started as a small experiment inspired by the YouTube channel Numberphile, but it quickly got out of hand and now supports 200+ classifiers.

Examples of things it can detect:

• perfect / abundant / weird numbers • Mersenne primes and primorial numbers • amicable, sociable and aspiring numbers (aliquot sequences) • Carmichael numbers and other pseudoprimes • narcissistic, Kaprekar and happy numbers • palindromic and truncatable primes • taxicab numbers (Hardy–Ramanujan style cube sums) • Fibonacci, Lucas, Pell and Padovan numbers • triangular, pentagonal and other figurate numbers • strange curiosities like Belphegor’s prime, vampire numbers and Munchausen numbers

The current version contains 205 atomic classifiers plus 27 intersections (232 properties in total).

Example output: [screenshot]

Some features:

• 200+ classifiers • extensible plugin-like architecture • configurable profiles (fast vs heavy computations) • OEIS sequence integration • support for very large integers (100000 digits by default) • explanations for each classification

The project is open source:

https://github.com/c788630/Numclass

I’m now looking for people who would like to test it, especially:

• mathematicians • Python developers • people interested in number theory • anyone who likes exploring interesting integer properties

If you decide to try it out, I would really appreciate feedback on:

• usability of the CLI • additional number-theory properties to implement • performance for very large numbers • any issues or bugs you encounter

There are also a few small Easter eggs hidden in the program (including Klingon number input), so feel free to explore

Installation instructions and documentation are available in the repository (docs folder).

This is an amazing project - thank you for building/sharing it!