.exe
version (64-bit or 32-bit), unzip to
where
you have your GIMPS program (e.g. mfaktc or GpuOwl).autoprimenet.exe
(from Windows Terminal if possible, or just double-click if you're not
comfortable with command-line programs) and go through the setup wizard.<enter>⏎
to accept the default value.autoprimenet.exe
again
and it will start up in monitoring mode and fetch work and submit results every hour.wget
)python3 autoprimenet.py --setup
to run the setup wizard.python3 autoprimenet.py
and it will start up in
monitoring mode and fetch work and submit results every hour.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 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:
Windows users on x86 systems can click one of these links to download a standalone executable that packages the latest versions of Python, the Requests library and the program. Note that the latest version of Python currently requires Windows 8.1+. Standalone executables using Python 3.8 that support Windows Vista, 7 and 8 are also provided, while ones with older versions of Python are available upon request. It is recommended that users on Windows 10+ use the Windows Terminal to run both the GIMPS software and AutoPrimeNet. (Users on older versions of Windows would need to use the Windows PowerShell or Command Prompt.) 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 autoprimenet.exe
executable to the same directory as your GIMPS software. Then,
open the terminal in this directory and run: autoprimenet --help
to verify that everything
works. Lastly, skip down to the Setup section below and be sure
to use “autoprimenet
” instead of “python3 autoprimenet.py
” in those commands.
All other users should follow these three steps to install Python and download the program:
pip3 install requests
or
python3 -m pip install requests
. Some recent Python installations may require first setting
up a virtual environment. (Users using an older version of Python may need to install a corresponding older version of
the library.)
autoprimenet.py
file to the
same directory as your GIMPS software. Then, open the terminal in this directory and run:
python3 autoprimenet.py --help
to verify that everything works.
Windows users may need to use the py
launcher
instead of python3
.
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.
python3 autoprimenet.py --setup
-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>]
Worktype | Mlucas | GpuOwl | PRPLL | CUDALucas | CUDAPm1 | mfaktc/mfakto |
---|---|---|---|---|---|---|
4 | ✔ | ✔ | ✔ | |||
12 | ✔ | |||||
100 | ✔ | ✔* | ✔ | ✔ | ||
101 | ✔ | ✔ | ||||
102 | ✔ | ✔* | ✔ | ✔ | ||
104 | ✔ | ✔* | ✔ | ✔ | ||
106 | ✔* | ✔ | ||||
150 | ✔ | ✔ | ✔ | |||
151 | ✔ | ✔ | ✔ | |||
152 | ✔ | ✔ | ✔ | |||
153 | ✔ | ✔ | ✔ | |||
154 | ✔ | ✔* | ||||
155 | ✔ | ✔ | ||||
156 | ||||||
160 | ✔ | |||||
161 | ✔ |
python3 autoprimenet.py --timeout 0 --username ANONYMOUS --hostname example --workpref 150 --gpuowl
python3 autoprimenet.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 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.
File Name | File Size | Date Modified | Hash | |||
---|---|---|---|---|---|---|
quick-start-guide.html | 19,547 | 2024-10-21 | ff4b2eeb1ed13c2162046c8e98e073ab | |||
AutoPrimeNet_Windows_x86.zip | 7,464,855 | 2024-12-01 | 68b61063de24cfe93099889d4597d9db | |||
AutoPrimeNet_Windows-Vista-7-8_x64.zip | 8,083,072 | 2024-12-01 | 3e7114d21619e5875588d74a12404b40 | |||
AutoPrimeNet_Windows-Vista-7-8_x86.zip | 6,094,561 | 2024-12-01 | 4096287189f10793276e86aa9708ab75 | |||
AutoPrimeNet_Windows_x64.zip | 9,739,799 | 2024-12-01 | d7a19aa5e4ad16b0ba975f22538ac0fe | |||
autoprimenet.py | 257,090 | 2024-11-16 | 15b514700b02e9637685bfef248c9b4c |