=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Kon the C# Chatterbot Offline - Version 1.2.0
Programmed by James "Iyouboushi" (Iyouboushi@gmail.com)
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Table of Contents:
 About
 Setup
 Options
 What's New?
 Known Issues
 Contact

 _______________________________________________________________________
/                                                                       \
|                                ABOUT                                  |
\_______________________________________________________________________/


"Kon" is my attempt at creating a "chatterbot" written in C#.  Kon is
an IRC bot that connects and watches a channel.  This is the
OFFLINE version of the same bot.  It does not need an internet connection
and cannot connect online at all.

Kon uses a "brain" to learn and use in conversations.  The brain system
is based on a chatterbot called "Language Bot" that was written by 
BishounenNightBird of Esper.net.  

The brain attempts to take what you say and manipulate it to create semi-
original thoughts.  

Please note that at first it will basically be a 'monkey-see, monkey-do'
because the bot has not seen enough conversations to create semi-original
thoughts yet. 

A default brain is included that contains 1,856 lines total (which is very,
very small).  

** The brain files that the offline version uses is compatible with the
online version (and vice versa) should you ever wish to switch versions.


 _______________________________________________________________________
/                                                                       \
|                                SETUP                                  |
\_______________________________________________________________________/


Setup is simple.  Extract the zip into a folder of your choice.  Run
the Kon Offline.exe file.  

 _______________________________________________________________________
/                                                                       \
|                              OPTIONS                                  |
\_______________________________________________________________________/


When you click on the options tool bar you will see a number of things
that you can do to help control the bot.  Here's a detailed description
of all of them.


###### MODES

The bot currently has three different modes that you can toggle.  They
are:

* Chat Only
* Learn Only
* Chat While Learning

* Chat Only
This mode is simply chatting, nothing else.  You can send text and Kon
will try to create dialog based on what you say to it.

* Learn Only
This mode is to teach the bot something new.  When you talk to it, it 
will record everything you say into its brain.  Kon will never respond
to you in this mode.

* Chat While Learning
A combination of the two above.  The bot will take what you say to it
and store it in its brain, but it will also try to respond to the line
as well.



###### BRAIN CONTROL

You have a little control over the brain in this section of options.

* Brain Info
If you want to know how many lines the brain files are using and their size 
(in bytes) click this option.

* Feed Kon a Text File
This is how you teach Kon very quickly.  The bot will attempt to learn
everything that appears in a text file you want it to read.  There is
something to note here: the formatting of the text file matters, a lot.


He went to the store and got some milk


is not the same as:


He went to the store
and got some milk


The latter example would be processed as two entirely different lines,
while the first would be only one.


* Tidy Up Brain Files
This will reorganize the brain files so that all the "START_SENTENCES"
will appear at the top of the files.  Use this after you've added a 
good amount of lines.

* Wipe Kon's Brain Clean
This will erase the brain files clean, save for a single line in both.
This option CANNOT BE UNDONE so make sure you really want to do it before
you go through with it.

* Answer Search
You can enable or disable the answer search mode here.  Answer search
makes Kon attempt to locate the question and give an appropriate answer.



###### LOGGING

These two options (on/off) will tell the program that you want, or don't
want, to save your conversations with Kon.  If on, it will write the 
conversation to a text file.  This option is ON BY DEFAULT.



###### SET YOUR CHAT NAME

Identify yourself to the program so that it knows who you are! The name you
pick will occasionally be used by Kon in his sentences.  Blank names are
not allowed.  


 _______________________________________________________________________
/                                                                       \
|                             WHAT'S NEW?                               |
\_______________________________________________________________________/


* Kon Engine 1.5.0
This version uses the latest version of the Kon engine.

* "Answer Search"
This version of Kon Offline now tries to find the question or statement
you ask him and reply with an appropriate answer.  Sometimes it works
great, other times..not so much.  Play with it and see. :)

* Redid the LB Brain Files
In previous versions the questions and statements were all split into
seperate files.  This version combines them all into one file.  Furthermore,
kon.brain is now necessary to use this version.


 _______________________________________________________________________
/                                                                       \
|                            KNOWN ISSUES                               |
\_______________________________________________________________________/


There are some known issues with the bot.  Please do not email me about 
these.  Ever.

* ???
There are no known issues in this version.  If you find an error please
email and let me know about it so that I can fix it.


 _______________________________________________________________________
/                                                                       \
|                               CONTACT                                 |
\_______________________________________________________________________/


If, for whatever reason, you need to contact me.. my email address is
provided:  Iyouboushi@gmail.com

If you run into errors using THIS program, PLEASE contact me with the error
and what you were doing to encounter it so that I may work on fixing it for the next
version.

