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:
An automated assignment handler program/script that uses the PrimeNet API is also available for most other GIMPS primality testing software, including GpuOwl for GPUs and Mlucas for ARM and other non-x86 CPUs. It was written by Teal Dulcet and Daniel Connelly 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 assignments, report assignment progress and results and upload proof files to the PrimeNet server. It supports Windows, macOS and Linux. Below are some basic instructions to download and setup the program:
Windows users on x86 systems can click one of these links to download a standalone executable that packages the latest versions of both Python and the program. Click this link for how to determine if you are running a 32 or 64 bit version of Windows.
Just extract the ZIP file and save the primenet.exe
executable to the same directory as your GIMPS software. Then,
run: primenet --help
to verify that everything
works. Lastly, skip down to the Setup section below and be sure
to use “primenet
” instead of “python3
primenet.py
” in those commands.
All other users should follow these two steps to install Python and download the program:
primenet.py
file to the
same directory as your GIMPS software. Then, run: python3
primenet.py --help
to verify that everything works.
Windows users may need to use python
or py
instead of python3
.python3 primenet.py --setup
Then skip down to step #2 below.-h/--help
output
above for the full list of available options and the
respective default values. The program defaults to Mlucas, so
if using GpuOwl be sure to also add the -g/--gpuowl
option. It saves
its configuration to a “local.ini” file by default, so it is
only necessary to give these options the first time it is run.
python3 primenet.py --timeout 0 --username <PrimeNet User ID> [--hostname <computer name>] [--worktype <work preference>] [--num-workers <num>]
python3 primenet.py --timeout 0 --username ANONYMOUS --hostname example --worktype 150 --gpuowl
python3 primenet.py -t 0 -u ANONYMOUS -H example -T 150 -g
)
-D/--dir
option for each worker directory. Advanced/power
users may want to add the -d/--debug
option for
more verbose output.
python3 -OO primenet.py [--timeout <update frequency (sec)>] [--checkin <checkin frequency (hours)>] [--dir <directory>]...
For example, for GpuOwl (with the default 1 hour update
frequency and 6 hour checkin frequency): python3 -OO primenet.py
For more information about this program/script and for support, please see the dedicated thread on the forum. 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.
File Name | File Size | Date Modified | Hash | |||
---|---|---|---|---|---|---|
PrimeNet_Windows_x64.zip | 9,480,508 | 2024-05-01 | 463c4c5c41298f9513381f8d3f2b09f8 | |||
PrimeNet_Windows_x86.zip | 7,655,108 | 2024-05-01 | cbb1b80e624f895dd763526f1c1d5cb8 | |||
primenet.py | 207,398 | 2024-04-20 | ef18910cc7f6f247b47d40ee1668c800 | |||
primenet_20240420.py | 207,398 | 2024-04-20 | ef18910cc7f6f247b47d40ee1668c800 | |||
primenet_20240318.py | 206,289 | 2024-03-18 | 7d84141af1f68005fed12c8d1c4f71ba | |||
primenet_20240310.py | 148,485 | 2024-03-10 | 45a590ebd7d049cd362b3ee3d34c3e49 | |||
primenet_20231216.py | 146,463 | 2023-12-16 | 2bcd3a6e09ad645c5e984d5fdeebedb5 | |||
primenet_20231102.py | 146,459 | 2023-11-02 | 83de161eda737a650bf8c3ffe3eebac3 | |||
primenet_20230930.py | 146,564 | 2023-09-30 | 01a6219955d8e4a25ea02b081c1a5126 | |||
primenet_20230720.py | 141,643 | 2023-07-20 | bfdd491cd081026a54790684cb04c114 | |||
primenet_20230611.py | 134,968 | 2023-06-11 | bbb2ac8055fa16efb53ead5673b92846 | |||
primenet_20230606.py | 134,844 | 2023-06-06 | 4cd6cb91024c06ccd797b8474cf757fd | |||
primenet_20230602.py | 134,781 | 2023-06-02 | ea6c011e94aadb3e7fd1eaab87d797e1 |