Help:Bots
This page is for outlining basic step towards running a 'bot on Wiktionary. This is a companion page to WT:BOTS.
Preliminaries
editThere are several things you need to do to become a 'bot operator.
- Download and install python.
- Download and install Pywikibot.
- Create an account that has "Bot" as the last three characters of the username. (Usually capital "B" — not strictly enforced.)
- Get community approval for what you want to do.
- Run some tests.
- Garner as much feedback as you can.
- Run some more tests.
- Start a WT:VOTE for approval. (Only done for recurring tasks, not one-time things.)
Downloading and installing Python is quite straight-forward, and well documented depending on the flavor you pick (e.g. Linux, Windows, Mac, Solaris, VMS, etc.) Estimated time: 25 minutes.
Downloading the 'pywikipediabot' framework is the "normal" type of download from http://sf.net/. When you "tar -zxvf" or "unzip" the file, you get a directory full of different programs. Since Python is an interpreted language, you can simply view all the programs before running them. Most of the "framework" programs are pretty self-explanatory, particularly looking at the input parameters parsing sections. Setting up the "user-config.py" file (all four lines) tends to give people lots of trouble - please remember to read the FAQ first. Make sure there is no indentation and that the last line is blank. Estimated time: 35 minutes (reading instructions)
To test that all is working, do $ python logon.py to see that it runs OK. Note that your cookies will usually persist for quite a while.
Now that you are a new bot operator, check out WT:BOT/T to see if there are any pending requests for you to fulfil.