{"id":1259,"date":"2011-03-14T00:46:13","date_gmt":"2011-03-14T07:46:13","guid":{"rendered":"http:\/\/www.nathalielawhead.com\/candybox\/?p=1259"},"modified":"2014-03-18T22:50:35","modified_gmt":"2014-03-19T05:50:35","slug":"programe-e-alice-aiml-bot-using-flash-php-actionscript-walkthrough-source-files","status":"publish","type":"post","link":"http:\/\/www.nathalielawhead.com\/candybox\/programe-e-alice-aiml-bot-using-flash-php-actionscript-walkthrough-source-files","title":{"rendered":"Programe E ALICE AIML Bot Using Flash (PHP & Actionscript Walkthrough + Source Files)"},"content":{"rendered":"

System requirements:<\/strong>
\n*PHP (4.0.4 and up)
\n*MySQL
\n*Apache Server
\n*Flash
\n(If you found this via a google search… Source files for the Flash<\/a><\/strong> are at the end of the post…)<\/p>\n

Short Summary:<\/strong>
\nUpdate: <\/strong>For a tutorial, and source code, on integrating Pandorabots with Flash, click here<\/a>.
\nThis is a concise collection of all the information that’s out there (as far as my research leads me to believe – since I last checked), + some personal trial-error-experimeddling on installing Program’s to host your own ALICE bot.
\nThis also walks you through the basics for building your own Flash interface (for your bot).
\nMy goal was to make a tutorial for people that don’t want to use pandorabots.
\nI hope to build on this in the near future.<\/p>\n

Extended Summary:<\/strong>
\nI love playing around with bots<\/a>, and especially love lurking on lists like Robitron<\/a>. Projects like ChatScript<\/a> & RiveScript<\/a> are excellent ways of tickling the inner geek and keeping you busy in all your free time…
\nOf course, this completely devastates your social life, but hell… Who needs friends when you can MAKE them. Ha! Pun intended!<\/a>
\nChatbots in games is something that I’m particularly passionate about, and sell everyone on. I’ve successfully incorporated them into a number of my client’s projects. They’ve fit beautifully into these every-time.
\nNaturally, if you want to see them in action visit Tetrageddon Arcade<\/a>, or chat with Minibyte on the front page of AlienMelon<\/a>…<\/p>\n

This is going to cover a means of making a Flash based ALICE AIML<\/a> bot that you<\/em> can host without pandorabots<\/a>.
\nYou’ll need a host provider like MediaTemple<\/a> where you have basic control over your own database, ect…
\nNow, I know that AIML<\/a> is not necessarily “the best” solution out there.
\nThere are fucktoneries of technologies\/experiments, like Jabberwacky<\/a>, VoiceXML<\/a>, ELIZA<\/a> (of course<\/a>), IBM’s Watson<\/a>, the list goes on and on<\/a>… In terms of authoring<\/a>, AIML is difficult to look at, BUT it makes the most effective and believable personality I know of… Especially if you don’t have years to develop your own personality.
\nI turn to it because of all the AIML sets that are so freely available out there, allowing you to quickly and easily customize your own personality… Not because it is necessarily “better”, but because there are so many sets available, you don’t need to spend years on creating something that is somewhat believable.
\nI terms of “building from the ground up”, I notice users still pick up on the “fakeness” of other bots too easily…
\nNevertheless, picking your own solution is for you to decide, besides this is a post about building and hosting your own Flash ALICE bot!<\/a>
\nAgain, like I said, if you want to see a Flash front-end and AIML back-end in full frontal wackiness (crazy little character) then check out these two examples:
\nAlienmelon<\/a> (minibyte, the most popular)
\nThey Came From My Inbox<\/a> (talk to the spam via the text input field at the bottom of the menu)
\nSo…<\/p>\n

INSTALLING THE BOT<\/strong><\/p>\n

Head on down to
\nhttp:\/\/www.alicebot.org\/downloads\/programs.html<\/a>
\nAnd grab yourself a copy of Programe E<\/a>… That’s their PHP version.
\nNotice that there are a plethora of other funky awesome implementations there, and that makes things all the more exciting!<\/p>\n

Program E<\/a> is a platform for running artificial intelligence robots written in PHP. It runs bots written in AIML (Artificial Intelligence Markup Language). Custom tags are a feature of AIML engines such as Programe E and it uses MySQL for its database bits and pieces.
\nYou’ll have to know a little thing or two about running sql scripts, which is not hard!
\nIn fact, it can be a lot of fun!
\nNote that AIML is really easy to understand if you know XML. It basically is a funked up version of XML.
\nA noteworthy collection of AIML sets are the Annotated A.L.I.C.E. AIML<\/a> files found here:
\nhttp:\/\/www.alicebot.org\/aiml\/aaa\/<\/a>
\nOn the other hand, if you are crazy enough to start from complete scratch I suggest investigating other solutions.<\/p>\n

You’ll also need a noteworthy AIML editor. For most people I suggest just heading down to Pandorabots<\/a> and using that as a development environment.
\nThey already have something like an “editor” there where you can keep testing & uploading.
\nGo to “Create a Pandorabot<\/em>“, there you can also select whatever set you wish…
\nCreate it and then go to “AIML”. You can download sets there as well.
\nYou can do your testing and personality forging there, and then upload the sets to your own server. It’s one good way of having a reliable environment.
\nAnother great desktop editor is the GAITObot AIML editor (Windows only, MAC users must use bootcamp<\/a>):
\nhttp:\/\/www.gaitobot.de\/gaitobot\/AIMLEditor\/download.aspx<\/a>
\nIt’s another good starting point for learning.
\nThere is also SAE (Simple AIML Editor)<\/a>. It’s Free by Riot Software<\/a>…
\nAND AI Dealer<\/a>…
\nPick your point of entry!<\/p>\n

Setting up a local testing environment is also something I highly recommend for safety reasons…
\nI suggest MAMP<\/a> for that:
\nhttp:\/\/www.mamp.info\/en\/index.html<\/a>
\nIt’s for godless MAC users like me.
\nIt’ll simulate Apache, MySQL, and PHP environments.
\nIt works charms and keeps you from making killer mistakes that’ll down all your sites because you’ve accidentally failed to terminate a loop on line 34 and it overloaded the server… or some freak shit like that…
\nWhatever!
\nDon’t judge me.
\nFor setting up MAMP<\/a> wordpress.org<\/a> has a wonderful walk through:
\nInstalling WordPress Locally On Your Mac With MAMP<\/a>
\nAnd here is another good walkthrough:
\nSetting Up Your Mac For Local Development Using Coda WordPress Mamp
\n<\/a>
\nEither way. This is LOTS OF FUN and IS NOT HARD. :D
\nIf I can do it, a monkey can!<\/p>\n

So! After you’ve got all your settings upped, safeties strapped, balls secured, and your copy of Program E<\/a> downloaded…<\/p>\n

1) Create a directory (on your server) called “programe<\/code>“. Here is where you’ll install your little robot friend.
\nUnzip and upload all the Program E files into this directory.<\/p>\n

\"Unzip<\/p>\n

2) Create a database for the program to use in MySQL. Call it something like “programe<\/code>“.<\/p>\n

3) Here’s the fun part. In the Program E install you downloaded navigate to:
\nsql > mysql > db.sql<\/code>
\nOpen that up. You’ll need to run that script.
\nIf you have phpMyAdmin, then do the following…
\nHit the SQL tab at the top:<\/p>\n

\"The<\/p>\n

Paste the contents of “db.sql<\/code>” into the “RUN SQL query \/ queries on database<\/code>”<\/p>\n

\"Run<\/p>\n

And hit “go<\/code>“!<\/p>\n

Booya! You got bot.<\/p>\n

\"U<\/p>\n

4) By default, AIML files and startup.xml<\/code> are in the aiml<\/code> directory. Use the startup.xml<\/code> file included in the distribution.
\nDO NOT use the startup.xml<\/code> you get with AIML files from alicebot.org<\/a>. AIML files that work well with Program E<\/a> can be found at http:\/\/sourceforge.net\/project\/showfiles.php?group_id=43190<\/a>
\nOnce you’ve got your AIML sets unzip and upload all the files to the AIML directory.
\nDelete “std-65-percent.aiml<\/code>” & “std-pickup.aiml<\/code>“.
\nYou don’t need those.<\/p>\n

\"u<\/p>\n

Booya! Bot got brain.<\/p>\n

5) In the “aiml<\/code>” directory there is a “startup.xml<\/code>“:<\/p>\n

\"aiml<\/p>\n

Edit that to fit your bot’s personality. You can also do this later, but this is an important 1st step in forging your own bot.
\nNote that this is like the Pandorabots “properties<\/code>“:<\/p>\n

\"pandorabots<\/p>\n

Same thing… It’s basically predefined character traits (values) that you continuously refer to in the AIML files. <\/p>\n

6) Go to “\/src\/admin\/dbprefs.php<\/code>“, and edit dbprefs.php<\/code> with your database information and aiml directory information.
\nIf you have AIML files in the default directory you don’t have to change that. See dbprefs.php<\/code> for other options that can be configured.
\nThe values you need to edit are:
\n$DB_HOST<\/code> (database host name)
\n$DB_UNAME<\/code> (database username)
\n$DB_PWORD<\/code> (password)
\n$DB_DB<\/code> (name of the programe database)
\nFor the AIML directory for $rootdir<\/code> use the absolute path and include “\/”. If this is wrong you may have to revisit this. You’ll get an error, and then you’ll know if you did it wrong. Sorry maaaaan<\/a>.<\/p>\n

For example if you’re on a (mt) gridserver:<\/p>\n

$rootdir=\"\/..\/..\/aiml\/\";
\n$DB_HOST=\"internal-db.sxxxxx.gridserver.com\";
\n$DB_UNAME=\"username\";
\n$DB_PWORD=\"password\";
\n$DB_DB=\"dbxxxx_programe\";<\/code><\/p>\n

Note that src\/admin<\/code> needs to be writable by the web server because botloader.php<\/code> will create a file subs.inc<\/code>. You can also create an empty subs.inc<\/code> file and make that writable.<\/p>\n

8) From your site access botloader.php<\/code>…
\nExample:
\nhttp:\/\/MYSITE.com\/programe\/src\/admin\/botloader.php<\/code>
\nTo load the AIML into the database. This’ll take a bit so be patient!
\nOn a dual PIII it takes approx. 1 minute for 10,000 categories.
\nIf your PHP is running in safe mode you might need to use botloaderinc.php<\/code> to load the AIML files one at a time. <\/p>\n

\"botloaderinc\"<\/p>\n

If you experience timeouts then access botloaderinc.php<\/code> instead.
\nNote that whenever you load botloader.php<\/code> it DELETES ALL the patterns and templates that you have in your database and then loads\/reloads them from the AIML files you have. This is basically how you re-load\/update your bot… by accessing that file.<\/p>\n

9) Navigate to:
\nhttp:\/\/MYSITE.com\/programe\/src\/talk.php<\/code><\/p>\n

\"talk.php\"<\/p>\n

To give it a test ride.
\nIf it talks back, you know you dundidit right!<\/p>\n

\"Sup,<\/p>\n

10) For safety reasons: PASSWORD PROTECT THE ADMIN DIRECTORY WITH A .htaccess FILE SO NO ONE CAN ACCESS THAT DIRECTORY.<\/strong>
\nLock it down, or remove it and re-upload later when needed.<\/p>\n

11) Finally you’ll need a PHP script for the Flash end of things to access.
\nIn your aiml\/startup.xml<\/code> there is a bit at the top < bot id=\"TestBot\" ... > <\/code><\/p>\n

\"This\"<\/p>\n

Substitute “TestBot<\/code>” with your bot name first. That’s going to be hardcoded into the following PHP script.
\nStart a blank .php file then copy & paste the following:<\/p>\n

<\/p>\n

\n
<?php<\/span>\r\n\/\/load in contents of respond file for use...<\/span>\r\ninclude<\/span> "respond.php"<\/span>;\r\nif<\/span> (isset<\/span>($_POST<\/span>['theinput'<\/span>])){\r\n\t$numselects<\/span>=<\/span>0<\/span>;\r\n\tsession_start<\/span>();\r\n\t\/\/unique session id for user<\/span>\r\n\t$sessionid<\/span>=<\/span>session_id<\/span>();\r\n\t$response<\/span>=<\/span>replybotname($_POST<\/span>['theinput'<\/span>],$sessionid<\/span>,'TestBot'<\/span>);\r\n\techo<\/span> "theoutput="<\/span>.<\/span>trim($response<\/span>-><\/span>response<\/span>);\r\n}\r\n?><\/span>\r\n<\/pre>\n<\/div>\n
Save that as “talk_flash.php<\/code>”<\/p>\n
Notice in ( $_POST ['theinput'] , $myuniqueid, 'TestBot' );<\/code> The ‘TestBot<\/code>‘ is your bot id<\/em>. Rename that to the name you chose for your bot. Else your shit wont work for shit.<\/p>\n
Done! The non-Flash end is all setup
\nNext up…
\nPlanet Flash.<\/p>\n
PROGRAMMING AND CREATING THE FLASH FRONT END<\/strong><\/p>\n
In a new Flash document you’ll need two text fields.
\nOne named “txt_output<\/code>” set as a Dynamic Text field<\/code>.
\nOne named “txt_input<\/code>” set as an Input Text field<\/code>.<\/p>\n
And the following actions that do something along the lines of…<\/p>\n
ACTIONSCRIPT 3.0 would look like:<\/strong>
\n<\/p>\n
\n
var<\/span> url_php:String<\/span> =<\/span> "http:\/\/www.nathalielawhead.com\/programe\/src\/talk_flash.php"<\/span>;<\/span>\r\nvar<\/span> bool_firstrun:Boolean<\/span> =<\/span> true<\/span>;<\/span>\r\n\/\/Run<\/span>\r\nfunction <\/span>run<\/span>():<\/span>void<\/span> {<\/span>\r\n\t\/\/Set up url vars<\/span>\r\n\tvar<\/span> url_vars:URLVariables<\/span> =<\/span> new<\/span> URLVariables<\/span>();<\/span>\r\n\tvar<\/span> request:URLRequest<\/span> =<\/span> new<\/span> URLRequest<\/span>();<\/span>\r\n\t\/\/if its first run send an initial message<\/span>\r\n\tif<\/span> (<\/span>bool_firstrun)<\/span> {<\/span>\r\n\t\t\/\/then set to false...<\/span>\r\n\t\tbool_firstrun =<\/span> false<\/span>;<\/span>\r\n\t\t\/\/firstrun message to establish a connection<\/span>\r\n\t\turl_vars.<\/span>theinput<\/span>=<\/span>"Hello. My name is visitor."<\/span>;<\/span>\r\n\t}<\/span> else<\/span> {<\/span>\r\n\t\t\/\/if not do default<\/span>\r\n\t\turl_vars.<\/span>theinput<\/span>=<\/span>txt_input.<\/span>text<\/span>;<\/span>\r\n\t\ttxt_input.<\/span>text<\/span>=<\/span>""<\/span>;<\/span>\r\n\t}<\/span>\r\n\t\/\/Post<\/span>\r\n\trequest.<\/span>url<\/span>=<\/span>url_php;<\/span>\r\n\trequest.<\/span>method<\/span>=<\/span>URLRequestMethod.<\/span>POST<\/span>;<\/span>\r\n\trequest.<\/span>data<\/span>=<\/span>url_vars;<\/span>\r\n\t\/\/URL loader for above<\/span>\r\n\tvar<\/span> loader:URLLoader<\/span> =<\/span> new<\/span> URLLoader<\/span>();<\/span>\r\n\tloader.<\/span>dataFormat<\/span>=<\/span>URLLoaderDataFormat.<\/span>VARIABLES<\/span>;<\/span>\r\n\tloader.<\/span>addEventListener<\/span>(<\/span>Event.<\/span>COMPLETE<\/span>,<\/span> sendcompletehandler);<\/span>\r\n\tloader.<\/span>load<\/span>(<\/span>request);<\/span>\r\n\t\/\/receive all the above and throw it into txt_output<\/span>\r\n\tfunction <\/span>sendcompletehandler<\/span>(<\/span>event:<\/span>Event<\/span>):<\/span>void<\/span> {<\/span>\r\n\t\ttxt_output.<\/span>text<\/span>=<\/span>event.<\/span>target<\/span>.<\/span>data<\/span>.<\/span>theoutput<\/span>;<\/span>\r\n\t}<\/span>\r\n}<\/span>\r\n\/\/Keyboard<\/span>\r\ntxt_input.<\/span>addEventListener<\/span>(<\/span>KeyboardEvent.<\/span>KEY_UP<\/span>,<\/span> key_run);<\/span>\r\nfunction <\/span>key_run<\/span>(<\/span>event:<\/span>KeyboardEvent<\/span>):<\/span>void<\/span> {<\/span>\r\n\tif<\/span> (<\/span>event.<\/span>keyCode<\/span>==<\/span>Keyboard.<\/span>ENTER<\/span>)<\/span> {<\/span>\r\n\t\trun();<\/span>\r\n\t}<\/span>\r\n}<\/span>\r\n\/\/start<\/span>\r\nrun();<\/span>\r\n<\/pre>\n<\/div>\n
ACTIONSCRIPT 2.0 version would look like:<\/strong>
\n<\/p>\n
\n
var<\/span> myfilename:String<\/span> =<\/span> "http:\/\/YOURSITE.com\/programe\/src\/talk_flash.php"<\/span>;<\/span>\r\nvar<\/span> keyListener:Object<\/span> =<\/span> new<\/span> Object<\/span>();<\/span>\r\nkeyListener.<\/span>onKeyDown<\/span> =<\/span> function<\/span>()<\/span> {<\/span>\r\n\tif<\/span> (<\/span>Key.<\/span>getCode<\/span>()<\/span> ==<\/span> Key.<\/span>ENTER<\/span>)<\/span> {<\/span>\r\n\t\tsubmit();<\/span>\r\n\t}<\/span>\r\n};<\/span>\r\nKey.<\/span>addListener<\/span>(<\/span>keyListener);<\/span>\r\nfunction <\/span>submit<\/span>()<\/span> {<\/span>\r\n\tvar<\/span> result_lv:LoadVars<\/span> =<\/span> new<\/span> LoadVars<\/span>();<\/span>\r\n\tresult_lv.<\/span>onLoad<\/span> =<\/span> function<\/span>(<\/span>success:<\/span>Boolean)<\/span> {<\/span>\r\n\t\tif<\/span> (<\/span>success)<\/span> {<\/span>\r\n\t\t\ttxt_output.<\/span>text<\/span> =<\/span> result_lv.<\/span>theoutput<\/span>;<\/span>\r\n\t\t}<\/span> else<\/span> {<\/span>\r\n\t\t\ttrace<\/span>(<\/span>"error"<\/span>);<\/span>\r\n\t\t}<\/span>\r\n\t};<\/span>\r\n\tvar<\/span> send_lv:LoadVars<\/span> =<\/span> new<\/span> LoadVars<\/span>();<\/span>\r\n\tsend_lv.<\/span>theinput<\/span> =<\/span> txt_input.<\/span>text<\/span>;<\/span>\r\n\tsend_lv.<\/span>sendAndLoad<\/span>(<\/span>myfilename,<\/span> result_lv,<\/span>"POST"<\/span>);<\/span>\r\n\ttxt_input.<\/span>text<\/span> =<\/span> ""<\/span>;<\/span>\r\n}<\/span>\r\n<\/pre>\n<\/div>\n
[swfobj src=”http:\/\/nathalielawhead.com\/sourcefiles\/Chatbot_Programe_E_Flash\/pflash.swf” height=”400″ width=”400″]
\nType above to test<\/em>
\n\"Flash<\/a><\/p>\n
You get the idea…
\nThis is a veeeeeery<\/em> super simple barebones example that really just does the basic sending \/ receiving of variables.
\nYou can easily take this example and extend it.
\nMake a class out of it. Have the text write itself out a character at a time, as if the bot is typing to you. Have multiple text fields that connect to multiple bots to create a virtual chatroom. Or have an isometric game where each character is hooked to a bot that you talk to, and they give you information to send you on your quest… You get the idea… Bots are fucking awesome, and this is how simple they are.
\nNow go and have some creative fun on your great bot master adventures!<\/p>\n
Source Files Here<\/a>:
\nhttp:\/\/nathalielawhead.com\/sourcefiles\/Chatbot_Programe_E_Flash<\/a><\/p>\n
Further Links:<\/strong><\/p>\n
Fa\u00e7ade<\/a><\/p>\n
RiveScript<\/a>
\n(Perl) A text-based scripting language for giving responses to chatterbots.
\nThis one’s worth keeping an eye on.<\/p>\n
Beyond Fa\u00e7ade: Pattern Matching for Natural Language Applications<\/a><\/p>\n
ChatScript
\nhttp:\/\/sourceforge.net\/projects\/chatscript\/files\/<\/a><\/p>\n
suzette
\nhttp:\/\/www.chatbots.org\/chatbot\/suzette\/<\/a>
\nhttp:\/\/ai.bluemars.com\/chat\/<\/a>
\nhttp:\/\/bluemars.com\/<\/a><\/p>\n
cleverbot
\nhttp:\/\/www.cleverbot.com\/<\/a><\/p>\n
ultra hal
\nhttp:\/\/www.zabaware.com<\/a><\/p>\n
http:\/\/www.personalityforge.com\/<\/a><\/p>\n
http:\/\/www.chatbots.org\/<\/a><\/p>\n
French version of installing here!<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
System requirements: *PHP (4.0.4 and up) *MySQL *Apache Server *Flash (If you found this via a google search… Source files for the Flash are at the end of the post…) Short Summary: Update: For a tutorial, and source code, on integrating Pandorabots with Flash, click here. This is a concise collection of all the information that’s out there (as far as my research leads me to believe – since I last checked), + some personal trial-error-experimeddling on installing Program’s to host your own ALICE bot. This also walks you through the basics for building your own Flash interface (for your...<\/p>\n","protected":false},"author":1,"featured_media":4522,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"fifu_image_url":"","fifu_image_alt":"","footnotes":"","_links_to":"","_links_to_target":""},"categories":[12],"tags":[],"class_list":["post-1259","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-resources"],"_links":{"self":[{"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/posts\/1259","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/comments?post=1259"}],"version-history":[{"count":53,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/posts\/1259\/revisions"}],"predecessor-version":[{"id":3021,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/posts\/1259\/revisions\/3021"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/media\/4522"}],"wp:attachment":[{"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/media?parent=1259"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/categories?post=1259"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.nathalielawhead.com\/candybox\/wp-json\/wp\/v2\/tags?post=1259"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}