euler is a command line tool for running and submitting Project Euler problems. This is what a successful submission looks like:

Get Started in Two Lines

$ sudo port install euler
$ euler -p 1

Get Started

I've submitted it to Macports, but in the meantime you need to do a little bit of work to get started. You need the jp2a, ImageMagick and BeautifulSoup libraries installed.

$ sudo port install jp2a ImageMagick py27-beautifulsoup

Then grab the euler script (just one file) from here and place it somewhere in your PATH.


euler requires two pieces of information from you: the number of the problem you are trying to solve, and your proposed solution. You can do this in one of a few ways:

Username Configuration

You can also save your username and password in a file named .eulerrc in your home directory (~/.eulerrc or /Users/yourusername/.eulerrc). The format is:

username = myusername
password = mypassword

Note that there are no quotes around your username or password.

Supported Languages

Here are the languages currently supported by euler:


If your language isn't supported, you can pipe a solution in via stdin:

$ sml problem4.sml | euler -p 4

Or specify your solution as another argument on the command line:

$ euler -p 4 -s 99032

Pull requests to add new languages are also welcome.

Contact Me

If you have any questions please email me at Thanks!