Mersenne.ca download mirror

• https://www.mersenneforum.org/node/1057120
• https://github.com/tdulcet/AutoPrimeNet

AutoPrimeNet: The Ultimate PrimeNet assignment handler program

About AutoPrimeNet

Prime95 has built-in assignment handling using the PrimeNet v5 API. Users should use the PrimeNet API when it is available for their GIMPS software instead of the legacy manual testing/assignment pages. Using the PrimeNet API provides many advantages for users, including:

• Your systems can get much smaller Category 0 and 1 exponents
• You can monitor the progress of all your exponents and systems on the CPUs page
• You do not have to remember to manually get new assignments, request extensions on your existing assignments, submit the results or upload the PRP proof files and you will never run out of work
• You can change your work preference and unreserve assignments directly on the system, in addition to the website

An automated assignment handler program that uses the PrimeNet API is also available for all other GIMPS software, including Mlucas, GpuOwl, CUDALucas, mfaktc and mfakto. (⚠️ Note that PRPLL is not ready for production use and is not (yet) fully supported.) It was written by Teal Dulcet, with contributions from Daniel Connelly (CUDALucas) and Tyler Busby (mfaktc/mfakto) and adapted from an older script for Mlucas by Loïc Le Loarer and Ernst W. Mayer. As with Prime95, this program will automatically get and register assignments, report assignment progress and results, upload proof files to and download certification starting values from the PrimeNet server. It additionally can get assignments and report results to mersenne.ca for exponents above the PrimeNet limit of 1G. It supports Windows, macOS and Linux. Below are some basic instructions to download and setup the program:

Download

The program uses some Unicode characters to improve the output, so if you encounter a UnicodeEncodeError exception, you may need to set a PYTHONIOENCODING=utf-8 environment variable before running the program.

Setup

1. Register your system with PrimeNet:
   Recommended

   Just run this command for the program to automatically prompt for all the needed options:

   python3 autoprimenet.py --setup

   Alternatively - Command line options (click to show)

   Run the below command using the command line options. See the -h/--help output above for the full list of available options and the respective default values. Users will need to add the option for the respective GIMPS software they are using, so -m/--mlucas for Mlucas, -g/--gpuowl for GpuOwl, --cudalucas for CUDALucas, --mfaktc for mfaktc or --mfakto for mfakto. It saves its configuration to a “prime.ini” file by default, so it is only necessary to give these options the first time it is run.

   python3 autoprimenet.py --timeout 0 --username <PrimeNet User ID> [--hostname <computer name>] [--workpref <work preference>] [--num-workers <num>]

   Supported work preferences (click to show)

   2 - Trial factoring
   4 - P-1 factoring
   12 - Trial factoring GPU
   100 - First time LL tests
   101 - Double-check LL tests
   102 - World record LL tests
   104 - 100 million digit LL tests
   106 - Double-check LL tests with zero shift count,
   150 - First time PRP tests
   151 - Double-check PRP tests
   152 - World record PRP tests
   153 - 100 million digit PRP tests
   154 - Smallest available first time PRP that needs P-1 factoring
   155 - Double-check using PRP with proof
   156 - Double-check using PRP with proof and nonzero shift count
   160 - First time PRP on Mersenne cofactors
   161 - Double-check PRP on Mersenne cofactors
   
   

   Worktype	Mlucas	GpuOwl	PRPLL	CUDALucas	CUDAPm1	mfaktc/mfakto
   4	✔	✔			✔
   12						✔
   100	✔	✔*	✔	✔
   101	✔			✔
   102	✔	✔*	✔	✔
   104	✔	✔*	✔	✔
   106		✔*	✔
   150	✔	✔	✔
   151	✔	✔	✔
   152	✔	✔	✔
   153	✔	✔	✔
   154	✔	✔*
   155		✔	✔
   156
   160	✔
   161	✔

   * Some previous versions of GpuOwl

   
   For example, for GpuOwl: python3 autoprimenet.py --timeout 0 --username ANONYMOUS --hostname example --workpref 150 --gpuowl
   
   (or equivalently using the short options: python3 autoprimenet.py -t 0 -u ANONYMOUS -H example -T 150 -g)
2. Start the program: Run the below command each time you want to start the program. If you have more than one worker, add the -D/--dir option for each worker directory. Advanced/power users may want to add the -d/--debug option for more verbose output.

   python3 -OO autoprimenet.py [--timeout <update frequency (sec)>] [--checkin <checkin frequency (hours)>] [--dir <directory>]...

   For example, for GpuOwl (with the default 1 hour update and checkin frequency): python3 -OO autoprimenet.py

For more information about this program/script and for support, please see the dedicated thread on the forum (may require a sign in). Note that there are many other older programs/scripts that may be bundled with the download for your GIMPS software and appear similar to this program, but they are just simple wrappers around the legacy manual testing/assignment pages and do not actually use the PrimeNet API. If the script/program requires you to provide your GIMPS password, it is not using the PrimeNet API and therefore does not provide most of the benefits listed above.