Sailor Agents Installation and Operations Manuel

Updated 8/12/2002 by Seth Russell

Installation Procedure:
  1. Make sure that you have installed Python 2.2 on the computer.
  2. Download current release zip file, use the hyperlink off (sailor agents).
  3. Unzip it in any directory.  This direcorty will be refered to as your homePath.
  4. Make sure that you have access to python from that directory.  
Operating Instructions for running the sailor server:
  1. At the command prompt in the homePath directory enter the command below:

      2. c:\homePath> python sailorServer.py
     
  2. If the server is running properly it will respond: 
    3. The homePath is now c:\homePath
    new born Noname
    Sailor version x.xxx
    Serving Noname at http://localhost:2187
  3. In your favorite browser hit the address:
    http://localhost:2187/sailor.html
  4. Alternatively in Win32 you should be able to double click on sailorServer.py in the homePath directory and then hit the address above.

  5. You can serve different agents in different domains and different ports by entering command parameters. The command format is:
    python sailorServer.py <domain> <port> <agentName> 
    You can place a comma for any argument to get the default.
  6. You can stop the server with ctrl-Break or ctrl-C depending on your platform 
  7. I suggest the first interesting thing you could do would be to click the LoadDirectory button at the top of the screen to read in a directory of RDF and N3 data on the web.   This will read in the document:
http://robustai.net/sailor/semdocs.quads
This will give you a directory of interesting RDF files.  Click on the ~read~> buttons to read these files into your sailor agent.  
    From python:

      You can instantiate a sailor agent directly in any python script as follows:

        import sailor
        me=sailor.wake('AgentName')
        Of course the homePath needs to be your current working directory  or the import will not find sailor.py.  To make homePath your current working directory, type in the following:

          import os
          os.chdir('c:\homePath') 
    From web pages:

      You can write applications for your agent using HTML with embedded Semenglish imparatives.  For example see sailor.html in your homePath.   Embed Semenglish imparatives by including the instructions within {! ....  !}.   For example:
    {! at(Seth) say(node) !}  
    would cause the node named 'Seth' to be displayed in your browser.