For those of you who don’t know what SETI@Home optimizers are, they are essentially specialized versions of the standard version of the SETI@Home client which take advantage of extended floating-point instruction sets available to certain x86 (Intel, AMD, or the like) processors. Using these instruction sets allows optimized clients to complete work many times faster than it could before with the standard client. For example, prior to using an SSSE3 optimized client on my Intel Core 2 Quad Q6600 my recent average credit (RAC) on SETI was in the 500 range including one other active machine and now my RAC has spiked over 2,500 not including the other active machine.

Before we get started, you should make sure that all other active work units you have running are completed before replacing the standard client with an optimized one. Then you may choose which optimize client you will run. Keep in mind that currently, only Intel Core 2 based CPUs and a single VIA CPU are capable of running SSSE3 instructions. For more details on this you should refer to the SSSE3 wikipedia page. Otherwise, you will likely be able to run an SSE3 optimized client, unless your CPU is more than several years old, also refer to wikipedia for more information on this. If you’ve got an even older CPU, there are also clients for MMX, SSE, and SSE2.

Optionally you may check which instruction sets are supported by your CPU using the following command:

[maddog39@desktop ~]$ cat /proc/cpuinfo | grep flags | tail -n 1
flags		: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe nx lm constant_tsc arch_perfmon pebs bts pni monitor ds_cpl vmx est tm2 ssse3 cx16 xtpr lahf_lm

First thing we want to do is download the client for your respective CPU and kernel version (most likely SSE3 or SSSE3 and kernel 2.6) from this page and extract the tarball. If your using an older CPU requiring an older instruction set, see this page instead.

Before we actually drop in the optimized client, its probably best to suspend the SETI@Home project in BOINC for safe measure.

Now we get to physically install our new SETI@Home optimizer. In the folder you extracted from the tarball, you should find a binary (executable) and an app_info.xml file, either in the folder’s top directory or in a subsequent sub-folder.

You want to copy these files and launch nautilus (or your file manager of choice) as root and point it to the /var/lib/boinc folder. Hit Alt+F2 to bring up a run dialog and enter the command:

gksudo nautilus /var/lib/boinc/projects/setiathome.berkeley.edu

Paste the optimizer files into the directory and when comes up. Finally, you will need to restart the BOINC daemon. On my distribution, Arch Linux its:

sudo /etc/rc.d/boinc restart

Although if you are using Ubuntu, Debian, or a derivative its:

sudo /etc/init.d/boinc restart

Then, to start using your new SETI optimized client, you simply launch BOINC manager and resume the SETI@Home project. It should start downloading new workunits immediatley and your in business. I hope you found this article useful and keep in mind that I tried to keep it as easy as possible for the newer Linux users out there.

So this is a simple little tutorial on how to write a basic “Hello World” bot using PyBotlib. The library itself is only a single file so I have not bothered to repackage it or write setup scripts as you will only need import that single file within your application. You may get the latest source code for the library at any time here (google code/SVN) or here (blog). So here we go…

Lets start by defining our bot class and its constructor.

import botlib
 
# Create a new class for our bot, extending the Bot class from botlib
class HelloWorldBot(botlib.Bot):
    def __init__(self, server, channel, nick, password=None):
        botlib.Bot.__init__(self, server, 6667, channel, nick)
 
        # Send nickserv password if available
        if password != None:
            self.protocol.privmsg("nickserv", "identify" % password)

Next we are going to want to override the __actions__ function of the Bot class which will handle all of our bots actions. This acts as essentially a main loop and is called infinitely until the bot is shutdown. In here we put code for our commands, responders, whatever other interaction with the IRC channel that we need.

    def __actions__(self):
        botlib.Bot.__actions__(self)
 
        # Create a Hello World responder/command
        if botlib.check_found(self.data, "!hello"):
            # Get the senders username
            username = self.get_username()
 
            # Send user a message in response
            self.protocol.privmsg(self.channel, "Hello %s!" % username)

So here, we have created a simple command called !hello which runs the code underneath its if statement when an instance of that command is found in the chat. Then we call the get_username() function of the Bot class (remember that we inherited from the Bot class) to get the user name of the person who initiated the command. After that, we simply send a message back to the channel using the equivalent function for IRC’s PRIVMSG command. Now all we to do is instantiate and run our new bot.

 if __name__ == "__main__":
    # Create new instance of our bot and run it
    HelloWorldBot("irc.wyldryde.org", "#maddog39", "HelloWorldBot").run()

Keep in mind that when you are instantiating Bot object, that because PyBotlib is entirely threaded, you can make as many instances of your bot as you would like. I do have a BotManager class in PyBotlib intended for managing sets of multiple bots on the same process however I have never actually tested it so your results may vary. Here is the script in its entirety.

import botlib
 
# Create a new class for our bot, extending the Bot class from botlib
class HelloWorldBot(botlib.Bot):
    def __init__(self, server, channel, nick, password=None):
        botlib.Bot.__init__(self, server, 6667, channel, nick)
 
        # Send nickserv password if availible
        if password != None:
            self.protocol.privmsg("nickserv", "identify" % password)
 
    def __actions__(self):
        botlib.Bot.__actions__(self)
 
        # Create a Hello World responder/command
        if botlib.check_found(self.data, "!hello"):
            # Get the senders username
            username = self.get_username()
 
            # Send user a message in response
            self.protocol.privmsg(self.channel, "Hello %s!" % username)
 
if __name__ == "__main__":
    # Create new instance of our bot and run it
    HelloWorldBot("irc.wyldryde.org", "#maddog39", "HelloWorldBot").run()

Finally, to run your new bot, simply issue the command:

python helloworldbot.py

At the terminal prompt or command prompt (windows). Also note that you must make sure that your botlib.py file is in the same directory as your bot. Have fun!