From e82a63616e6ae963c8141bda85579d94c6d78cfb Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 28 Jul 2023 14:44:00 +0100
Subject: [PATCH 01/29] using a lower threshold to retrieve code examples

---
 todo.txt                                      | 15 +++++++++------
 wafl/connectors/llm_code_creator_connector.py |  2 +-
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/todo.txt b/todo.txt
index 26ce3600..a525d0c2 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,15 +1,18 @@
 ### TODO
 
-/* make all tests pass
-* REMOVE computer FROM UTTERANCES!! (after activation)
-
-* modify wafl_llm to have a config file for the models to use/download
-* add a standard variable for the dialogue history to be used in rules space
-* only files declared with #using can be used in rules
+* why does sqrt throw exception when eval(code)?
 * rewrite documentation
 * push to main!
 
 
+/* make all tests pass
+/* REMOVE computer FROM UTTERANCES!! (after activation)
+
+/* modify wafl_llm to have a config file for the models to use/download
+/* add a standard variable for the dialogue history to be used in rules space
+/* only files declared with #using can be used in rules
+
+
 * retrievers for in-context learning
   /* all answerers and extractors
   /* create adversarial examples for task extractor
diff --git a/wafl/connectors/llm_code_creator_connector.py b/wafl/connectors/llm_code_creator_connector.py
index 456f5f80..48cd1dde 100644
--- a/wafl/connectors/llm_code_creator_connector.py
+++ b/wafl/connectors/llm_code_creator_connector.py
@@ -32,7 +32,7 @@ async def _get_answer_prompt(self, text: str, task: str, function_name: str = No
 
         function_name = function_name.split("=")[-1]
         retrieved_items = await self._knowledge.ask_for_facts(
-            Query.create_from_text(task), threshold=0.1
+            Query.create_from_text(task), threshold=0.
         )
         retrieved_items = "\n\n\n".join(
             [item.text for item in retrieved_items][::-1][:5]

From 441986992bba5bf1354ddcb121f97cd0ee086159 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 28 Jul 2023 15:13:56 +0100
Subject: [PATCH 02/29] solved splitting after = character for generation

---
 wafl/connectors/llm_code_creator_connector.py | 2 +-
 wafl/inference/backward_inference.py          | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/wafl/connectors/llm_code_creator_connector.py b/wafl/connectors/llm_code_creator_connector.py
index 48cd1dde..56e0d06d 100644
--- a/wafl/connectors/llm_code_creator_connector.py
+++ b/wafl/connectors/llm_code_creator_connector.py
@@ -32,7 +32,7 @@ async def _get_answer_prompt(self, text: str, task: str, function_name: str = No
 
         function_name = function_name.split("=")[-1]
         retrieved_items = await self._knowledge.ask_for_facts(
-            Query.create_from_text(task), threshold=0.
+            Query.create_from_text(task), threshold=0.0
         )
         retrieved_items = "\n\n\n".join(
             [item.text for item in retrieved_items][::-1][:5]
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index 827ee595..a165105d 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -669,7 +669,11 @@ async def _process_text_generation(self, cause_text, knowledge_name, substitutio
         if "=" not in cause_text:
             return Answer(text="False")
 
-        variable, prompt = cause_text.split("=")
+        position_of_assignment_operator = cause_text.find("=")
+        variable, prompt = (
+            cause_text[:position_of_assignment_operator].strip(),
+            cause_text[position_of_assignment_operator + 1 :].strip(),
+        )
         variable = variable.strip()
         prompt = prompt.strip()
         answer = await self._prompt_predictor.predict(prompt)

From 8f7fc7f27c5603b9659026423e05612e2956ff8d Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 28 Jul 2023 15:34:56 +0100
Subject: [PATCH 03/29] improved prompt for chitchat

---
 wafl/connectors/llm_chitchat_answer_connector.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/wafl/connectors/llm_chitchat_answer_connector.py b/wafl/connectors/llm_chitchat_answer_connector.py
index aa8d63be..bd1e9735 100644
--- a/wafl/connectors/llm_chitchat_answer_connector.py
+++ b/wafl/connectors/llm_chitchat_answer_connector.py
@@ -40,6 +40,8 @@ async def _get_answer_prompt(self, text, query, dialogue=None):
         prompt = f"""
 The user and the bot talk.
 The bot ends every utterance line with <|EOS|>.
+This bot answers are short and to the point. Do not use more than one sentence to reply.
+The bot should not repeat itself. Every reply should be different from the previous ones.
 some examples are as follows:
 
 

From db2c060e8a6bf5beb7ee480f3fd163bc2bb8175c Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 28 Jul 2023 15:46:44 +0100
Subject: [PATCH 04/29] The input form is deleted after entering the query

---
 wafl/frontend/index.html   |  5 ++---
 wafl/scheduler/web_loop.py | 15 +++++++++++++--
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/wafl/frontend/index.html b/wafl/frontend/index.html
index b902907d..d33a3d59 100644
--- a/wafl/frontend/index.html
+++ b/wafl/frontend/index.html
@@ -108,7 +108,7 @@
     </div>
     <pre id="messages" class="grid grid-flow-col"
          data-hx-post="/load_messages"
-         hx-swap="innerHTML scroll:bottom"
+         hx-swap="innerHTML"
          hx-target="#messages"
          hx-trigger="every 1s"
     >
@@ -117,8 +117,7 @@
     <div class="controls">
         <input autofocus name="query" id="query" class="input" type="text" placeholder="Type here your query"
                data-hx-post="/input"
-               hx-swap="innerHTML scroll:bottom"
-               hx-target="#messages"
+               hx-swap="outerHTML"
                hx-trigger="keyup[keyCode==13]">
         <div style="display:inline-block;cursor:pointer;"
              data-hx-post="/thumbs_up"
diff --git a/wafl/scheduler/web_loop.py b/wafl/scheduler/web_loop.py
index 10a5f760..53afd5be 100644
--- a/wafl/scheduler/web_loop.py
+++ b/wafl/scheduler/web_loop.py
@@ -34,8 +34,19 @@ async def run(self):
         async def handle_input():
             query = request.form["query"]
             self._interface.input_queue.append(query)
-            conversation = await self._get_conversation()
-            return conversation
+            return f"""
+<input autofocus name="query" id="query" class="input" type="text" placeholder="{query}"
+               data-hx-post="/input"
+               hx-swap="outerHTML"
+               hx-trigger="keyup[keyCode==13]">
+<div data-hx-post="/load_messages"
+         hx-swap="innerHTML"
+         hx-target="#messages"
+         hx-trigger="load"
+         style="display:none;"
+         >
+</div>            
+            """.strip()
 
         @app.route("/reset_conversation", methods=["POST"])
         async def reset_conversation():

From 532016a8d41718328e5d451bbd3ed7822ce013d9 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sun, 30 Jul 2023 17:49:01 +0100
Subject: [PATCH 05/29] added .. to import declarations

---
 changelog.txt                      |  5 +++++
 tests/backward_import/functions.py |  0
 tests/backward_import/rules.wafl   |  1 +
 tests/greetings/rules.wafl         |  8 ++++++--
 tests/test_dependencies.py         | 22 ++++++++++++++++++++++
 todo.txt                           |  9 +++++++--
 wafl/parsing/preprocess.py         | 25 ++++++++++++++-----------
 7 files changed, 55 insertions(+), 15 deletions(-)
 create mode 100644 changelog.txt
 create mode 100644 tests/backward_import/functions.py
 create mode 100644 tests/backward_import/rules.wafl

diff --git a/changelog.txt b/changelog.txt
new file mode 100644
index 00000000..a2f15855
--- /dev/null
+++ b/changelog.txt
@@ -0,0 +1,5 @@
+### v 0.0. 70
+
+* Added the keyword RETRIEVE to get list of relevant items from the knowledge base
+* On-the-spot rule generation
+* mapping lists onto queries
diff --git a/tests/backward_import/functions.py b/tests/backward_import/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/backward_import/rules.wafl b/tests/backward_import/rules.wafl
new file mode 100644
index 00000000..9e689d5b
--- /dev/null
+++ b/tests/backward_import/rules.wafl
@@ -0,0 +1 @@
+the color of the sky is green
\ No newline at end of file
diff --git a/tests/greetings/rules.wafl b/tests/greetings/rules.wafl
index 5e4c3261..103f53b1 100644
--- a/tests/greetings/rules.wafl
+++ b/tests/greetings/rules.wafl
@@ -1,6 +1,6 @@
 #using facts
 #using rules
-
+#using ../backward_import
 
 this bot is doing well
 
@@ -13,4 +13,8 @@ the user wants to know the time
 
 
 the user is italian
-  something needs to be said in italian
\ No newline at end of file
+  something needs to be said in italian
+
+the user's name has five letters
+  result = what is the color of the sky?
+  say The sky is {result}
\ No newline at end of file
diff --git a/tests/test_dependencies.py b/tests/test_dependencies.py
index e4d5a764..ae3bcc73 100644
--- a/tests/test_dependencies.py
+++ b/tests/test_dependencies.py
@@ -15,6 +15,7 @@
   
 the user's name is alberto
   the user is italian
+
 """.strip()
 
 
@@ -132,3 +133,24 @@ def test__functions_can_be_called_from_a_2_level_deep_dependency(self):
         print(interface.get_utterances_list())
         expected = "bot: Ciao!"
         assert interface.get_utterances_list()[-1] == expected
+
+    def test__rules_can_be_imported_using_prior_folders(self):
+        tmp_filename = "test.wafl"
+        with open(tmp_filename, "w") as file:
+            file.write(wafl_dependency)
+
+        interface = DummyInterface(
+            to_utter=[
+                "My name is Maria",
+            ]
+        )
+        knowledge = ProjectKnowledge(tmp_filename)
+        conversation_events = ConversationEvents(
+            ProjectKnowledge(tmp_filename),
+            interface=interface,
+            code_path=knowledge.get_dependencies_list(),
+        )
+        asyncio.run(conversation_events.process_next())
+        print(interface.get_utterances_list())
+        expected = "bot: The sky is green"
+        assert interface.get_utterances_list()[-1] == expected
\ No newline at end of file
diff --git a/todo.txt b/todo.txt
index a525d0c2..aef936e6 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,10 +1,15 @@
 ### TODO
 
-* why does sqrt throw exception when eval(code)?
+* add #using ../
+* make it so it is possible to navigate among levels of tasks
+   * e.g.: what is the name of the list? that's not what i meant
+* split bullet lists into lists for mapping onto a query
+   * add something for merging as well
+
 * rewrite documentation
 * push to main!
 
-
+/* why does sqrt throw exception when eval(code)?
 /* make all tests pass
 /* REMOVE computer FROM UTTERANCES!! (after activation)
 
diff --git a/wafl/parsing/preprocess.py b/wafl/parsing/preprocess.py
index c171d4af..522d3bca 100644
--- a/wafl/parsing/preprocess.py
+++ b/wafl/parsing/preprocess.py
@@ -14,23 +14,26 @@ def get_all_functions_names(module_name):
     return functions
 
 
-def clean_module_name(name):
-    if not name:
+def clean_module_name(module_name):
+    if not module_name:
         raise RuntimeError(
-            f"The name {name} is empty and cannot be used as a python module"
+            f"The name {module_name} is empty and cannot be used as a python module"
         )
 
-    if name[0] == "/":
-        name = name[1:]
+    names = module_name.split("/")
+    return_path = []
+    for name in names:
+        if name and name != "." and name != "..":
+            return_path.append(name)
 
-    if name and name[-1] == "/":
-        name = name[:-1]
+        if name == "..":
+            return_path.pop()
 
-    name = name.replace("/", ".")
-    if name:
-        name += "."
+    if not return_path:
+        return ""
 
-    return name
+    return_path = ".".join(return_path) + "."
+    return return_path
 
 
 def create_preprocessed(

From b4588804a3a6823ccc5adde15daf5b015f993c7b Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 4 Aug 2023 18:37:29 +0100
Subject: [PATCH 06/29] non-informative answers are considered 'unknown'

---
 requirements.txt                     |  2 +-
 setup.py                             |  2 +-
 tests/test_dependencies.py           |  6 ++--
 todo.txt                             | 13 ++++++--
 wafl/data/dialogues.csv              |  7 ++---
 wafl/extractors/dataclasses.py       |  4 +--
 wafl/extractors/entailer.py          | 13 ++++++++
 wafl/inference/backward_inference.py | 46 ++++++++++++++++++++++++----
 wafl/inference/utils.py              |  2 +-
 9 files changed, 74 insertions(+), 21 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 1af10c87..7dd80bbe 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -12,7 +12,7 @@ sklearn==0.0
 python-Levenshtein==0.12.2
 wave==0.0.2
 fuzzywuzzy==0.18.0
-PyAudio==0.2.11
+PyAudio==0.2.13
 num2words==0.5.12
 word2number==1.1
 aiohttp==3.8.4
diff --git a/setup.py b/setup.py
index 547f3de1..d629aea4 100644
--- a/setup.py
+++ b/setup.py
@@ -51,7 +51,7 @@
         "python-Levenshtein==0.12.2",
         "wave==0.0.2",
         "fuzzywuzzy==0.18.0",
-        "PyAudio==0.2.11",
+        "PyAudio==0.2.13",
         "pyctcdecode==0.2.1",
         "num2words==0.5.12",
         "word2number==1.1",
diff --git a/tests/test_dependencies.py b/tests/test_dependencies.py
index ae3bcc73..a5a16002 100644
--- a/tests/test_dependencies.py
+++ b/tests/test_dependencies.py
@@ -28,7 +28,7 @@ def test__knowledge_dependencies_are_populated(self):
         knowledge = ProjectKnowledge(tmp_filename)
         expected = {
             "/": ["/greetings"],
-            "/greetings": ["/facts", "/rules"],
+            "/greetings": ["/facts", "/rules", "/../backward_import"],
             "/greetings/facts": [],
             "/greetings/rules": [],
         }
@@ -40,7 +40,7 @@ def test__knowledge_dictionary_is_populated(self):
             file.write(wafl_dependency)
 
         knowledge = ProjectKnowledge(tmp_filename)
-        expected = ["/", "/greetings", "/greetings/facts", "/greetings/rules"]
+        expected = ["/", "/greetings", "/greetings/facts", "/greetings/rules", "/greetings/../backward_import"]
         self.assertEqual(expected, list(knowledge._knowledge_dict.keys()))
 
     def test__rules_are_called_from_dependency_list(self):
@@ -153,4 +153,4 @@ def test__rules_can_be_imported_using_prior_folders(self):
         asyncio.run(conversation_events.process_next())
         print(interface.get_utterances_list())
         expected = "bot: The sky is green"
-        assert interface.get_utterances_list()[-1] == expected
\ No newline at end of file
+        assert interface.get_utterances_list()[-1] == expected
diff --git a/todo.txt b/todo.txt
index aef936e6..607a242a 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,14 +1,21 @@
 ### TODO
 
-* add #using ../
+
 * make it so it is possible to navigate among levels of tasks
    * e.g.: what is the name of the list? that's not what i meant
+   * INTERRUPTIONS: nevermind, nothing, no one, not what i meant
+   * questions: answering a question with a question should trigger a new resolution tree
+
 * split bullet lists into lists for mapping onto a query
    * add something for merging as well
+* add init-default (with modified wafl_home) and init (as empty)
 
 * rewrite documentation
 * push to main!
+* push wafl-llm to main
+  * and docker
 
+/* add #using ../
 /* why does sqrt throw exception when eval(code)?
 /* make all tests pass
 /* REMOVE computer FROM UTTERANCES!! (after activation)
@@ -30,8 +37,8 @@
   Find a good way to entail what you need.
 
   - Issues were:
-     - Tetriever is not very good. There are a lot other rules scooped up when asking for a task
-     - Interrution rule must not be used for tasks
+     - Retriever is not very good. There are a lot other rules scooped up when asking for a task
+     - Interruption rule must not be used for tasks
      - Text-generation tasks are understood as questions, therefore no text generation
 
 * Maybe you need to add text_generation task right before searching the answer in rules
diff --git a/wafl/data/dialogues.csv b/wafl/data/dialogues.csv
index b3b7b8db..3bc410fa 100644
--- a/wafl/data/dialogues.csv
+++ b/wafl/data/dialogues.csv
@@ -17,13 +17,12 @@ bot: I believe it was Christopher Reeve<|EOS|>"
 "In the dialogue below a user is speaking to a bot:
 user: what is the color of the sun
 The bot remembers: the sun is bright yellow
-bot: The sun is bright yellow<|EOS|>
-"
+bot: The sun is bright yellow<|EOS|>"
 "In the dialogue below a user is speaking to a bot:
 user: what is the height of my truck
-The bot remembers: The user's truck is 8ft
 The bot remembers: The user is Italian
 The bot remembers: The user has a one bedroom flat
+The bot remembers: The user's truck is 8ft
 bot: The user's truck is 8ft<|EOS|>"
 "In the dialogue below a user is speaking to a bot:
 user: My flat is a one bedroom
@@ -31,8 +30,8 @@ bot: nice to know<|EOS|>
 user: is my flat a 2 bedroom
 bot: no, it is a 1 bedroom<|EOS|>"
 "In the dialogue below a user is speaking to a bot:
-the bot remembers: The user's name is John
 the bot remembers: The user is tall
+the bot remembers: The user's name is John
 user: is my name Jane
 bot: no, your name is John<|EOS|>"
 "In the dialogue below a user is speaking to a bot:
diff --git a/wafl/extractors/dataclasses.py b/wafl/extractors/dataclasses.py
index 052232e6..17830601 100644
--- a/wafl/extractors/dataclasses.py
+++ b/wafl/extractors/dataclasses.py
@@ -40,8 +40,8 @@ def create_false():
         return Answer(text="false")
 
     @staticmethod
-    def create_neutral():
-        return Answer(text="unknown")
+    def create_neutral(variable=None):
+        return Answer(text="unknown", variable=variable)
 
     @staticmethod
     def create_from_text(text):
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index 3d97592a..407a3049 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -1,3 +1,4 @@
+import functools
 from typing import Dict, Union
 from wafl.connectors.entailment_connector import EntailmentConnector
 
@@ -6,6 +7,7 @@ class Entailer:
     def __init__(self, logger=None):
         self._logger = logger
         self._connector = EntailmentConnector()
+        self._cache = {}
 
     async def get_relation(self, premise: str, hypothesis: str) -> Dict[str, float]:
         return await self._connector.predict(premise, hypothesis)
@@ -21,6 +23,10 @@ async def entails(
         if self._logger:
             self._logger.write("Starting entailment procedure.")
 
+        arguments = (premise, hypothesis, threshold, contradiction_threshold, return_threshold)
+        if arguments in self._cache:
+            return self._cache[arguments]
+
         prediction = await self.get_relation(premise, hypothesis)
         if prediction["entailment"] > threshold:
             if self._logger:
@@ -29,8 +35,10 @@ async def entails(
                 self._logger.write(f"Entailment: The results are {str(prediction)}")
 
             if return_threshold:
+                self._cache[arguments] = prediction["entailment"]
                 return prediction["entailment"]
 
+            self._cache[arguments] = "True"
             return "True"
 
         if prediction["contradiction"] < contradiction_threshold:
@@ -44,16 +52,21 @@ async def entails(
 
         if prediction["entailment"] > threshold:
             if return_threshold:
+                self._cache[arguments] = prediction["entailment"]
                 return prediction["entailment"]
 
+            self._cache[arguments] = "True"
             return "True"
 
         if return_threshold:
+            self._cache[arguments] = 0
             return 0
 
         if prediction["neutral"] > threshold:
+            self._cache[arguments] = "Unknown"
             return "Unknown"
 
+        self._cache[arguments] = "False"
         return "False"
 
     async def is_neutral(
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index a165105d..6767d1bb 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -161,6 +161,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
+            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+                answer = Answer.create_neutral(variable=answer.variable)
+
             self._log("Answers in working memory: " + answer.text, depth)
             return answer
 
@@ -169,6 +172,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
+            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+                answer = Answer.create_neutral(variable=answer.variable)
+
             self._log("Answers in working memory: " + answer.text, depth)
             return answer
 
@@ -177,6 +183,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
+            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+                answer = Answer.create_neutral(variable=answer.variable)
+
             self._log("Answers by asking the user: " + answer.text, depth)
             return answer
 
@@ -225,8 +234,6 @@ async def _look_for_answer_in_rules(
 
         for rule in rules:
             index = 0
-            substitutions = {}
-
             substitutions = create_default_substitutions(self._interface)
             rule_effect_text = rule.effect.text
             knowledge_name = rule.knowledge_name
@@ -491,7 +498,7 @@ async def _look_for_answer_by_asking_the_user(
                 await self._interface.output(query.text)
                 user_input_text = await self._interface.input()
                 self._log(f"The user replies: {user_input_text}")
-                if await self._query_has_better_match(user_input_text):
+                if await self._query_has_better_match(query.text, user_input_text):
                     self._log(f"Found a better match for {user_input_text}", depth)
                     task_text = (
                         await self._task_extractor.extract(user_input_text)
@@ -791,11 +798,38 @@ async def _process_retrieve_command(self, cause_text):
         facts = await self._knowledge.ask_for_facts_with_threshold(query, threshold=0.5)
         return [Answer(text=item[0].text, variable=variable) for item in facts]
 
-    async def _query_has_better_match(self, text: str):
-        if is_question(text):
+    async def _query_has_better_match(
+        self,
+        query: str,
+        user_answer: str,
+    ):
+        if is_question(user_answer):
             return True
 
-        if await self._knowledge.has_better_match(text):
+        if await self._knowledge.has_better_match(user_answer):
             return True
 
         return False
+
+    async def _answer_makes_sense(
+        self, query: str, user_answer: str, entailer: "Entailer"
+    ):
+        result = await entailer.entails(
+            f"bot: {query} user: {user_answer}",
+            "the user refuses to answer",
+            threshold=0.9,
+            return_threshold=True
+        )
+        if result:
+            return False
+
+        result = await entailer.entails(
+            f"bot: {query} user: {user_answer}",
+            "The answer gives no information",
+            threshold=0.9,
+            return_threshold=True
+        )
+        if result:
+            return False
+
+        return True
diff --git a/wafl/inference/utils.py b/wafl/inference/utils.py
index 1e935fbd..0fb46bb1 100644
--- a/wafl/inference/utils.py
+++ b/wafl/inference/utils.py
@@ -315,5 +315,5 @@ def get_causes_list(text: str) -> List[str]:
 def create_default_substitutions(interface: "BaseInterface") -> Dict[str, str]:
     substitutions = {}
     dialogue = " ".join(interface.get_utterances_list())
-    update_substitutions_from_results("_dialogue", dialogue, substitutions)
+    update_substitutions_from_results(dialogue, "_dialogue", substitutions)
     return substitutions

From 709981a9f601e32b6cf051ce0faaf81f0253b693 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 5 Aug 2023 09:53:30 +0100
Subject: [PATCH 07/29] changed the threshold for facts retrieval

---
 tests/test_dependencies.py         |  1 +
 todo.txt                           | 14 +++++++++-----
 wafl/answerer/dialogue_answerer.py |  2 +-
 3 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/tests/test_dependencies.py b/tests/test_dependencies.py
index a5a16002..7efa6ceb 100644
--- a/tests/test_dependencies.py
+++ b/tests/test_dependencies.py
@@ -29,6 +29,7 @@ def test__knowledge_dependencies_are_populated(self):
         expected = {
             "/": ["/greetings"],
             "/greetings": ["/facts", "/rules", "/../backward_import"],
+            '/greetings/../backward_import': [],
             "/greetings/facts": [],
             "/greetings/rules": [],
         }
diff --git a/todo.txt b/todo.txt
index 607a242a..f5ca3a95 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,13 +1,9 @@
 ### TODO
 
 
-* make it so it is possible to navigate among levels of tasks
-   * e.g.: what is the name of the list? that's not what i meant
-   * INTERRUPTIONS: nevermind, nothing, no one, not what i meant
-   * questions: answering a question with a question should trigger a new resolution tree
-
 * split bullet lists into lists for mapping onto a query
    * add something for merging as well
+* If the inference fail, should you try to improvise?
 * add init-default (with modified wafl_home) and init (as empty)
 
 * rewrite documentation
@@ -15,6 +11,14 @@
 * push wafl-llm to main
   * and docker
 
+
+
+/* make it so it is possible to navigate among levels of tasks
+/   * e.g.: what is the name of the list? that's not what i meant
+/   * INTERRUPTIONS: nevermind, nothing, no one, not what i meant
+/   * questions: answering a question with a question should trigger a new resolution tree
+    -> resolution: before answer_is_informative() I added an entailment check whether the answer makes sense/user doesn't want to answer
+
 /* add #using ../
 /* why does sqrt throw exception when eval(code)?
 /* make all tests pass
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index 0ec63dee..d8eca599 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -21,7 +21,7 @@ async def answer(self, query_text, policy):
 
         query = Query.create_from_text(query_text)
         facts_and_thresholds = await self._knowledge.ask_for_facts_with_threshold(
-            query, is_from_user=True, knowledge_name="/", threshold=0.1
+            query, is_from_user=True, knowledge_name="/", threshold=0.5
         )
         texts = cluster_facts(facts_and_thresholds)
         for text in texts[::-1]:

From db2de13fd7caf7a58a3a74b3092cb4f8ff2f3d44 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 5 Aug 2023 16:34:13 +0100
Subject: [PATCH 08/29] using only the arbiter answer to dispatch the query

---
 tests/test_dependencies.py           | 10 ++++-
 tests/test_task_creation.py          |  2 +-
 wafl/answerer/arbiter_answerer.py    | 64 ++++++++++++++++++++--------
 wafl/events/answerer_creator.py      | 13 ------
 wafl/extractors/entailer.py          |  8 +++-
 wafl/inference/backward_inference.py | 20 ++++++---
 wafl/policy/answerer_policy.py       | 13 ------
 7 files changed, 76 insertions(+), 54 deletions(-)

diff --git a/tests/test_dependencies.py b/tests/test_dependencies.py
index 7efa6ceb..5003a23c 100644
--- a/tests/test_dependencies.py
+++ b/tests/test_dependencies.py
@@ -29,7 +29,7 @@ def test__knowledge_dependencies_are_populated(self):
         expected = {
             "/": ["/greetings"],
             "/greetings": ["/facts", "/rules", "/../backward_import"],
-            '/greetings/../backward_import': [],
+            "/greetings/../backward_import": [],
             "/greetings/facts": [],
             "/greetings/rules": [],
         }
@@ -41,7 +41,13 @@ def test__knowledge_dictionary_is_populated(self):
             file.write(wafl_dependency)
 
         knowledge = ProjectKnowledge(tmp_filename)
-        expected = ["/", "/greetings", "/greetings/facts", "/greetings/rules", "/greetings/../backward_import"]
+        expected = [
+            "/",
+            "/greetings",
+            "/greetings/facts",
+            "/greetings/rules",
+            "/greetings/../backward_import",
+        ]
         self.assertEqual(expected, list(knowledge._knowledge_dict.keys()))
 
     def test__rules_are_called_from_dependency_list(self):
diff --git a/tests/test_task_creation.py b/tests/test_task_creation.py
index 6ca48887..dea4db39 100644
--- a/tests/test_task_creation.py
+++ b/tests/test_task_creation.py
@@ -123,7 +123,7 @@ def list_subfolders(folder_name):
 
     subfolders = []
     for subfolder in os.listdir(folder_name):
-        if os.path.isdir(subfolder):
+        if os.path.isdir(os.path.join(folder_name, subfolder)):
             subfolders.append(subfolder)
     return subfolders
             """.strip()
diff --git a/wafl/answerer/arbiter_answerer.py b/wafl/answerer/arbiter_answerer.py
index 3a22a32c..dd0db6b4 100644
--- a/wafl/answerer/arbiter_answerer.py
+++ b/wafl/answerer/arbiter_answerer.py
@@ -2,10 +2,12 @@
 
 from wafl.answerer.base_answerer import BaseAnswerer
 from wafl.answerer.dialogue_answerer import DialogueAnswerer
+from wafl.answerer.inference_answerer import InferenceAnswerer
 from wafl.config import Configuration
 from wafl.events.narrator import Narrator
 from wafl.extractors.entailer import Entailer
 from wafl.extractors.task_extractor import TaskExtractor
+from wafl.inference.backward_inference import BackwardInference
 from wafl.inference.utils import answer_is_informative
 from wafl.extractors.dataclasses import Answer, Query
 
@@ -28,27 +30,16 @@ async def answer(self, query_text, policy):
             Query.create_from_text(task.text),
             knowledge_name="/",
         ):
-            return Answer(text="unknown")
+            simple_task += ". There is a rule for that request."
 
-        if await self._knowledge.ask_for_rule_backward(
+        elif await self._knowledge.ask_for_rule_backward(
             Query.create_from_text(simple_task),
             knowledge_name="/",
         ):
-            return Answer(text="unknown")
+            simple_task += ". There is a rule for that request."
 
-        if (
-            not task.is_neutral()
-            and self._config.get_value("improvise_tasks")
-            and await self._entailer.entails(
-                simple_task,
-                f"The user gives an order or request",
-                return_threshold=True,
-                threshold=0.95,
-            )
-        ):
-            self._interface.bot_has_spoken(False)
-            policy.improvise = True
-            return Answer(text="unknown")
+        else:
+            simple_task += ". There is no rule for that request."
 
         score = 1
         keys_and_scores = []
@@ -79,9 +70,48 @@ async def answer(self, query_text, policy):
 
     @staticmethod
     def create_answerer(knowledge, interface, code_path, logger):
+        narrator = Narrator(interface)
         return ArbiterAnswerer(
             {
-                "The user chats": DialogueAnswerer(knowledge, interface, logger),
+                "The user makes small talk and there is no rule for that query": DialogueAnswerer(
+                    knowledge, interface, logger
+                ),
+                "The user gives an order or request and there is a rule for that query": InferenceAnswerer(
+                    interface,
+                    BackwardInference(
+                        knowledge,
+                        interface,
+                        narrator,
+                        code_path,
+                        logger=logger,
+                        generate_rules=False,
+                    ),
+                    logger,
+                ),
+                "The user gives an order or request and there is no rule for that query": InferenceAnswerer(
+                    interface,
+                    BackwardInference(
+                        knowledge,
+                        interface,
+                        narrator,
+                        code_path,
+                        logger=logger,
+                        generate_rules=True,
+                    ),
+                    logger,
+                ),
+                "The user gives a command and and there is no rule for that query": InferenceAnswerer(
+                    interface,
+                    BackwardInference(
+                        knowledge,
+                        interface,
+                        narrator,
+                        code_path,
+                        logger=logger,
+                        generate_rules=True,
+                    ),
+                    logger,
+                ),
             },
             knowledge,
             interface,
diff --git a/wafl/events/answerer_creator.py b/wafl/events/answerer_creator.py
index 64629684..c167badf 100644
--- a/wafl/events/answerer_creator.py
+++ b/wafl/events/answerer_creator.py
@@ -1,24 +1,11 @@
 from wafl.answerer.arbiter_answerer import ArbiterAnswerer
-from wafl.answerer.dialogue_answerer import DialogueAnswerer
-from wafl.answerer.inference_answerer import InferenceAnswerer
 from wafl.answerer.list_answerer import ListAnswerer
-from wafl.events.narrator import Narrator
-from wafl.inference.backward_inference import BackwardInference
 
 
 def create_answerer(knowledge, interface, code_path, logger):
-    narrator = Narrator(interface)
     return ListAnswerer(
         [
             ArbiterAnswerer.create_answerer(knowledge, interface, code_path, logger),
-            InferenceAnswerer(
-                interface,
-                BackwardInference(
-                    knowledge, interface, narrator, code_path, logger=logger
-                ),
-                logger,
-            ),
-            DialogueAnswerer(knowledge, interface, logger),
         ],
         interface,
         logger,
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index 407a3049..f039c710 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -23,7 +23,13 @@ async def entails(
         if self._logger:
             self._logger.write("Starting entailment procedure.")
 
-        arguments = (premise, hypothesis, threshold, contradiction_threshold, return_threshold)
+        arguments = (
+            premise,
+            hypothesis,
+            threshold,
+            contradiction_threshold,
+            return_threshold,
+        )
         if arguments in self._cache:
             return self._cache[arguments]
 
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index 6767d1bb..c022a5dd 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -53,7 +53,7 @@ def __init__(
         narrator: "Narrator",
         module_names=None,
         max_depth: int = 3,
-        generate_rules: bool = True,
+        generate_rules: bool = False,
         logger=None,
     ):
         self._max_depth = max_depth
@@ -161,7 +161,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
-            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+            if not await self._answer_makes_sense(
+                query.text, answer.text, self._extractor.get_entailer()
+            ):
                 answer = Answer.create_neutral(variable=answer.variable)
 
             self._log("Answers in working memory: " + answer.text, depth)
@@ -172,7 +174,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
-            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+            if not await self._answer_makes_sense(
+                query.text, answer.text, self._extractor.get_entailer()
+            ):
                 answer = Answer.create_neutral(variable=answer.variable)
 
             self._log("Answers in working memory: " + answer.text, depth)
@@ -183,7 +187,9 @@ async def _compute_recursively(
         )
         candidate_answers.append(answer)
         if answer and answer_is_informative(answer):
-            if not await self._answer_makes_sense(query.text, answer.text, self._extractor.get_entailer()):
+            if not await self._answer_makes_sense(
+                query.text, answer.text, self._extractor.get_entailer()
+            ):
                 answer = Answer.create_neutral(variable=answer.variable)
 
             self._log("Answers by asking the user: " + answer.text, depth)
@@ -220,7 +226,7 @@ async def _look_for_answer_in_rules(
         rules = await self._knowledge.ask_for_rule_backward(
             query, knowledge_name=query_knowledge_name
         )
-        if not rules and self._generate_rules and policy.improvise:
+        if not rules and self._generate_rules:
             self._log(f"Creating rules for the task: {query.text}", depth)
             rules_answer = await self._task_creator.extract(query.text)
             if not rules_answer.is_neutral():
@@ -818,7 +824,7 @@ async def _answer_makes_sense(
             f"bot: {query} user: {user_answer}",
             "the user refuses to answer",
             threshold=0.9,
-            return_threshold=True
+            return_threshold=True,
         )
         if result:
             return False
@@ -827,7 +833,7 @@ async def _answer_makes_sense(
             f"bot: {query} user: {user_answer}",
             "The answer gives no information",
             threshold=0.9,
-            return_threshold=True
+            return_threshold=True,
         )
         if result:
             return False
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index 7e105ca6..4004dc1b 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -7,19 +7,6 @@ def __init__(self, interface, logger=None):
         self._logger = logger
         self._connector = LLMAnswerPolicyConnector()
         self._max_num_past_utterances = 3
-        self.improvise = False
 
     async def accept(self, result: str):
         return True
-
-    def _get_unique_items(self, dialogue_items):
-        unique_dialogue_items = [dialogue_items[0]]
-        prior_items = set()
-        for index, item in enumerate(dialogue_items[1:]):
-            prior_item = dialogue_items[index]
-            if item not in prior_item:
-                unique_dialogue_items.append(item)
-
-            prior_items.add(item)
-
-        return unique_dialogue_items

From b9b4336a1fb53864188eab44f5506b34a0d3c35f Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 5 Aug 2023 18:03:28 +0100
Subject: [PATCH 09/29] using [{.....}] to split text into single items

---
 tests/test_list_type.py              |  8 +++----
 wafl/answerer/arbiter_answerer.py    |  2 --
 wafl/inference/backward_inference.py |  2 +-
 wafl/inference/utils.py              | 35 +++++++++++++++++++++++++---
 4 files changed, 37 insertions(+), 10 deletions(-)

diff --git a/tests/test_list_type.py b/tests/test_list_type.py
index bc3c31ed..1a25869b 100644
--- a/tests/test_list_type.py
+++ b/tests/test_list_type.py
@@ -12,10 +12,10 @@
 
 the user wants to write a book
     theme = what is the book about?
-    list_of_chapters = Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings:
-    SAY {list_of_chapters}
-    chapter_texts = Generate a full paragraph based on this chapter title "{list_of_chapters}". The theme of the paragraph is {theme}. Include the characters "Alberto" and "Maria". Write at least three sentences.
-    SAY {chapter_texts}
+    list_of_chapters = Generate a bullet list of 4 chapters names for a book. The theme of the book is {theme}.
+    SAY [{list_of_chapters}]
+    chapter_texts = Generate a full paragraph based on this chapter title "[{list_of_chapters}]". Include the characters "Alberto" and "Maria". Write at least three sentences.
+    SAY [{chapter_texts}]
 
 """
 
diff --git a/wafl/answerer/arbiter_answerer.py b/wafl/answerer/arbiter_answerer.py
index dd0db6b4..ce83742c 100644
--- a/wafl/answerer/arbiter_answerer.py
+++ b/wafl/answerer/arbiter_answerer.py
@@ -1,5 +1,3 @@
-import random
-
 from wafl.answerer.base_answerer import BaseAnswerer
 from wafl.answerer.dialogue_answerer import DialogueAnswerer
 from wafl.answerer.inference_answerer import InferenceAnswerer
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index c022a5dd..fac152f5 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -309,7 +309,7 @@ async def _look_for_answer_in_rules(
 
                 if len(answers) > 1:
                     answer = Answer.create_from_text(
-                        str([item.text for item in answers])
+                        str([item.text for item in answers])[1:-1]
                     )
 
                 else:
diff --git a/wafl/inference/utils.py b/wafl/inference/utils.py
index 0fb46bb1..0004ab92 100644
--- a/wafl/inference/utils.py
+++ b/wafl/inference/utils.py
@@ -285,7 +285,31 @@ def get_list_from_string(text: str) -> List[Any]:
 
 
 def get_list_like_element(text: str) -> str:
-    return re.sub(r".*\[(.*)].*", r"[\1]", text, re.MULTILINE).strip()
+    start_pos = text.find("[")
+    if start_pos == -1:
+        return ""
+
+    end_pos = text.find("]", start_pos)
+    if end_pos == -1:
+        return ""
+
+    return text[start_pos : end_pos + 1]
+
+
+def create_python_list_from_bullet_list(text: str) -> List[str]:
+    new_list = text.split("\n")
+    if len(new_list) != 1:
+        return new_list
+
+    new_list = text.split("', '")
+    if len(new_list) != 1:
+        return new_list
+
+    new_list = text.split(",")
+    if len(new_list) != 1:
+        return new_list
+
+    return [text]
 
 
 def get_causes_list(text: str) -> List[str]:
@@ -301,10 +325,15 @@ def get_causes_list(text: str) -> List[str]:
         return [text]
 
     list_like_element = get_list_like_element(text)
-    if not string_is_python_list(list_like_element):
+    if not list_like_element:
         return [text]
 
-    items = get_list_from_string(list_like_element)
+    if not string_is_python_list(list_like_element):
+        items = create_python_list_from_bullet_list(list_like_element[1:-1])
+
+    else:
+        items = get_list_from_string(list_like_element)
+
     causes_list = []
     for item in items:
         causes_list.append(text.replace(list_like_element, item))

From 240377982ad31d09226b156cde895282dfb7f32e Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sun, 13 Aug 2023 18:42:21 +0100
Subject: [PATCH 10/29] updaded the Docs with the new commands

---
 documentation/build/doctrees/chitchat.doctree | Bin 3171 -> 3186 bytes
 .../doctrees/directory_structure.doctree      | Bin 7252 -> 7267 bytes
 .../build/doctrees/environment.pickle         | Bin 97015 -> 106667 bytes
 documentation/build/doctrees/examples.doctree | Bin 2775 -> 2790 bytes
 documentation/build/doctrees/index.doctree    | Bin 5015 -> 5058 bytes
 .../build/doctrees/installation.doctree       | Bin 7688 -> 7330 bytes
 .../build/doctrees/introduction.doctree       | Bin 3513 -> 3528 bytes
 documentation/build/doctrees/license.doctree  | Bin 5254 -> 5269 bytes
 documentation/build/doctrees/rules.doctree    | Bin 18728 -> 25100 bytes
 .../doctrees/rules_and_backtracking.doctree   | Bin 5039 -> 5054 bytes
 .../build/doctrees/running_WAFL.doctree       | Bin 5746 -> 5761 bytes
 .../build/doctrees/wafl_init.doctree          | Bin 10258 -> 10273 bytes
 .../build/html/_sources/index.rst.txt         |   4 +-
 .../build/html/_sources/installation.rst.txt  |  12 +--
 .../build/html/_sources/rules.rst.txt         |  86 +++++++++++++++++-
 .../build/html/_sources/wafl_init.rst.txt     |   2 +-
 documentation/build/html/examples.html        |   2 +
 documentation/build/html/index.html           |  10 +-
 documentation/build/html/installation.html    |  10 +-
 documentation/build/html/introduction.html    |   4 +-
 documentation/build/html/objects.inv          | Bin 415 -> 424 bytes
 documentation/build/html/rules.html           |  66 +++++++++++++-
 documentation/build/html/searchindex.js       |   2 +-
 documentation/source/index.rst                |   2 +-
 documentation/source/installation.rst         |   2 +-
 documentation/source/rules.rst                |  86 +++++++++++++++++-
 documentation/source/wafl_init.rst            |   2 +-
 todo.txt                                      |  14 ++-
 28 files changed, 267 insertions(+), 37 deletions(-)

diff --git a/documentation/build/doctrees/chitchat.doctree b/documentation/build/doctrees/chitchat.doctree
index 056234f96a54f3c7529f896ae74f8edc28930ea0..09b85081a139b903c6cb416605b607d2a5d811ba 100644
GIT binary patch
delta 35
qcmaDX@kxTEfpu#7MiwVV0T=y@{M=Oi#GK?*{qp>x?9J|sGTZ>#pbLip

delta 20
bcmew)@mPYTfpu!cMiwVVM$^q<j56E+N{9v9

diff --git a/documentation/build/doctrees/directory_structure.doctree b/documentation/build/doctrees/directory_structure.doctree
index d79bfa68db5d4e38305252af1023e422790dea2e..fe38c9fb3ecdd257b9577974424dda78f5cfce85 100644
GIT binary patch
delta 35
qcmca&@z{c;fpu!cMwSRh0e}6B{M=Oi#GK?*{qp>x?9H)^-=zTJV+^|h

delta 20
bcmaECam9kAfpx0qMwSRhMu*KgjNhdIPd^6_

diff --git a/documentation/build/doctrees/environment.pickle b/documentation/build/doctrees/environment.pickle
index f31eef6e881a0a991c7305f9984ad5a72ee6e7d5..96ef2532fc0a045be940d25c49be49bd3211905e 100644
GIT binary patch
literal 106667
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

literal 97015
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
CGY-rE

diff --git a/documentation/build/doctrees/examples.doctree b/documentation/build/doctrees/examples.doctree
index 63605e650d5d39002c7965dab4722d9b33e37bef..e598031f2bc3071889e42f8e699353c8646f60b9 100644
GIT binary patch
delta 35
rcmcaE`b?CifpzNbjVw-#0xtR)`MIh3i8;xs`sMjW*_+)NCvXA)<ID_C

delta 20
ccmaDRdR>&IfpzMcjVw-#jHa8z7$<N708Xj~qW}N^

diff --git a/documentation/build/doctrees/index.doctree b/documentation/build/doctrees/index.doctree
index dd36c87a4673a81908fdfff200ed2b14d32191e7..d562a985a6df7b96b5e3029e7e2bac784305c3b8 100644
GIT binary patch
delta 181
zcmbQPen_3AfpzNkjVv3P1RV7<@^e%56LXSN^~>{%vL|n2Dlk+JPt8dN3M-W4D}+0`
z`KT8w80Z=3nV2f1<R_QrrskC-mSpDVDNe~?kDZbs*rPc)fLVkMqGWS2vjCH~S~<i7
w-I9FW^2D?p-C|t>AT%-6MKNJYVum!(1liarJ?c;$AUi=i;C61_!1|mQ0B1=&T>t<8

delta 135
zcmX@4K3$!qfpu!nMwX3Cj7F1>G8G6Zgs0{t=jWy>l;kUfJG%L(7f<$M78g-M6Mob%
zvv_j@vjCH=d^tpeZb`mwd16|QZn17kesXDUYF<fVNoIcDl*A0_*eMyZu~T{!ph`hz
OgOsWlZ@$g?oEHF4yfAkF

diff --git a/documentation/build/doctrees/installation.doctree b/documentation/build/doctrees/installation.doctree
index ed580c5dcc1fba64c95b64b548cbe89091d55d78..5379ef1077d283c5aae8ab91d7a58fad46da9811 100644
GIT binary patch
delta 237
zcmeCMS!BuDz&drh%tlsEMgb4~jQreG{luK)RQ>Y&qU_E7jJ+((4k`+h@3QL1swfm>
z7AR!q6_+ID<S3LUrsYh@V2_=WA=U#`!K9+F*^liQqd2z;SQ@A{vjnCFD7IOh!-R$L
z`{WoNW2MC8<kaHg%%q%Dg|wplT!oU1RG{*b)S|S+<Wz;?%#_s0b9onYKrJ9a&o|~+
ZpnHGt#Z3Od#|~m|{=uiiJ9)3HHvoo8QDy)D

delta 494
zcmZ2v*<r)lz&iD>>_%2kMn=ocag4nzj5d?svFc2gVUvKcHm9;3V-)5rPfW{E$jr+u
znUcXCJ0(M`hjX(NhY1Vg+sWlT#uDY3B^e5d3I(M}Ihn}{o&gGpDJey%#l@4)@T?-J
zg!da`^ki-R7!Ih((VMmTb$IJDID7btD~n4~bK`S?MkS`FPMJJKvvEr86pakl3^tHr
zjSM}QK#x>NW=T$}LTO$~YEe#RUaCS#e!fC+Mt)I=9?Z%3l(bHPm@J+3iIIUJLndQ#
zn4o&BZiaN$dmz6wDWeE(lZ0npNorAAVsffNab`*?mo5yz?7^)7Vhhkv1||lE$qj5W
zlQ;0Q2$yDPXB0wh%8<>_DNRb9Y``Mv)x(;TT9%qK#ha;zrKGYTbxIF=xMPr?r=R<j
x9u|-vr+D-9uodT*7A2=n0cy+8&Uy=SymUqo&;!gMqcY^Yc}kNKCx^>;0|5W7ry2kN

diff --git a/documentation/build/doctrees/introduction.doctree b/documentation/build/doctrees/introduction.doctree
index c6f608af6c4550094c35cbc5ec439f4e62e81704..7f22361d106f03b73b088d618de140b128987f66 100644
GIT binary patch
delta 35
qcmdlfeL|Y0fpzNMjVxY_0v`Gq`MIh3i8;xs`sMjW*_-_tvv>g8Aq(;V

delta 20
bcmX>hy;GW{fpzM-jVxY_jFy|@7_)c)N!<oU

diff --git a/documentation/build/doctrees/license.doctree b/documentation/build/doctrees/license.doctree
index d1fd64b986e0ccc1990056179900c2ede3db26ae..a9ef0d9ca56969b92ae269de4f988d1f26a8d671 100644
GIT binary patch
delta 35
qcmZqEoT|yvz&f>SBZ~v0fU|x^er~FMVoq|ZetCXT_GVW`M_~ZU1PeL<

delta 20
bcmbQL*`~?Tz&f>hBZ~tgqsitFMn_=)K=cKU

diff --git a/documentation/build/doctrees/rules.doctree b/documentation/build/doctrees/rules.doctree
index db30d473183196b9f187d11b84865c1862763f85..b4f25f6236fef2c84abbed2d9a998e96e28344aa 100644
GIT binary patch
delta 6147
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
D-iYnY

delta 1499
zcmZ{kZERCz6vua-_BLBsZM(J$k+ni1b8M~MShqqatgEFu*=EP+24l`a>~eF}j=fYT
z6Gn(1yjl|6nTbK(V+<Kn1~=#z6QfRJbO|iMp!16Y0TWGpNi@+A@Hx-*-p~ZUoF_Ri
zzw<xmxzEkd!|5rI_DgU2TF*&M0Bf}r1edY=@A!^AfnSumA%aV#0rc1dcwh7VIBI_l
zBHC?x81RfEioK3bT<?tF4M!KIUG2Er*@b_)8j!iVaBo=<Pr26N)v_t*!C_~x+##<}
zwn9;nTp?RzpB#|=n?t!>=<=>d=q|?r@6dl|1@7Bij3wm{LWT<Q1S^*6s2Jb%r6Gj3
zd|j}QA|66c6e1h6H~i%Qc~QA?c`2I!T&!{9Uk@B(hXGrn8*Nchg-a{@p@GBvc%?D|
z7fj&!LSRfwJv0UInIXj%=jG>hXx*A6wx~ms!mD*wCjfplbK7+9V$EZ~e$^A7)XO`o
z-8dY)0(Z>ZZawhI!vhc#vMix`SdJ-wozu$-*4B&Tp;@TpA$>W0ywZ!8YCPI#?K8l_
zjK-Aug*R30(Q4Pe4=lm(hx#PzV7RI!P|`-k6$*Dg6>g;1Z}G4#Llq1!hWnsbC@5}f
zg<+u}Tc|)mY<dAEO$E>K%B)bZ?U6=c2XzHm;pGbO=7w`{)X28INPdQwH;#ZJ`ed5x
z-~-V|E9|oezis}<J#RWYWPe9)m(tGg!$g!V6wETuu)C#}@q^DIz07-PNWH&lQQX(>
zLD&*+WWN*;t~2~N9%B3;!hS*ETg45J&VdzU(Prs@NlhmD-5!f^Ed{!u0#7yujTL(=
zShcC1@q?hM37y$A$if!<Bo(v0PEMw6Oa27z#Q!kc?q((|IRAL^p1Ho(b<j__%Zw}L
zKs*_)k`9@zFSedyBcio5Z49I>Jh2+!0Iv+-iPa_2VIzRCwmUc&aaw5WM1SjUC5Jes
z{d<bz?Rceh#OR^@+;JJ$oIc-i@-lpTYcK2(_w7lqfv>5RSEeWYr8%?sE6iw<>5l-u
zGql)dMGk+)X<X>}18&k)*v{%s>-H@$qxEd>W31Y$UD$EWGHJCI6)C`tJRy%O<NP@*
zIWlL-%#tbNpM&Bc^DG&e%p95b$b8P_D4&wKMdojAa`}?%&gU~@FYV5ZPVb$rQmBV2
zPrNGdsz9p(t16SkR0U5JELCvSoV<!Eg|Je2TprO?(JxU~MSn6~75##ARrK<8RrCUN
gRrE%LDzUg+-aa@qG?pD2%RD`j862I~z8Z+bzo!hrG5`Po

diff --git a/documentation/build/doctrees/rules_and_backtracking.doctree b/documentation/build/doctrees/rules_and_backtracking.doctree
index 2e6ef0ac2a5f34069e36284847c40d34be900ca4..220b51a94259c69f1231a0377ecd92b9639c17fb 100644
GIT binary patch
delta 35
qcmZ3lzE7Q{fpzNUjVy7D0zvv2`MIh3i8;xs`sMjW*_)FYeS`qrPYebC

delta 20
bcmdm|zFwWBfpzMVjVy7DjLw^j7=45QN}~o^

diff --git a/documentation/build/doctrees/running_WAFL.doctree b/documentation/build/doctrees/running_WAFL.doctree
index 8d838fcd636213d0749733ac3cd64e5d70d21a98..c5cdcd61035bbae3ef345f48136b06911fe6e6c2 100644
GIT binary patch
delta 35
qcmeyQ)2PeRz&f>TBa0WKfQNoYer~FMVoq|ZetCXT_GW)ZWl;duMGJxe

delta 20
bcmZqF{iMUvz&bU3Ba0U!qvhr}MrBa|M)3vK

diff --git a/documentation/build/doctrees/wafl_init.doctree b/documentation/build/doctrees/wafl_init.doctree
index 28a3be058ab2a899e06d00a16be63a69ec39f0f5..d90adfbbfdf42301f0f828bb37ac69defbd71dbc 100644
GIT binary patch
delta 35
qcmbOfurPq7fpx0bMwSpp0ayKu{M=Oi#GK?*{qp>x?9GvkJJkTrV+-K`

delta 20
bcmZ1&Fe!kgfpseTMwSppMzhTsj62l;MB4^6

diff --git a/documentation/build/html/_sources/index.rst.txt b/documentation/build/html/_sources/index.rst.txt
index b2d5fe7a..b032dffc 100644
--- a/documentation/build/html/_sources/index.rst.txt
+++ b/documentation/build/html/_sources/index.rst.txt
@@ -3,8 +3,8 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to WAFL's documentation!
-================================
+Welcome to WAFL's 0.0.45 documentation!
+=======================================
 
 .. toctree::
    :maxdepth: 3
diff --git a/documentation/build/html/_sources/installation.rst.txt b/documentation/build/html/_sources/installation.rst.txt
index dadf8de7..1624cd84 100644
--- a/documentation/build/html/_sources/installation.rst.txt
+++ b/documentation/build/html/_sources/installation.rst.txt
@@ -9,21 +9,21 @@ Both can be installed on the same machine.
    :align: center
 
 Interface side
----------
+--------------
 
 The first part is local to your machine and needs to have access to a microphone and speaker.
 To install it, run the following commands:
 
 .. code-block:: bash
 
-    sudo apt-get install portaudio19-dev ffmpeg
-    pip install wafl
+    $ sudo apt-get install portaudio19-dev ffmpeg
+    $ pip install wafl
 
 After installing the requirements, you can initialize the interface by running the following command:
 
 .. code-block:: bash
 
-    wafl init
+    $ wafl init
 
 which creates a `config.json` file that you can edit to change the default settings.
 A standard rule file is also created as `wafl.rules`.
@@ -33,13 +33,13 @@ Please see the examples in the following chapters.
 LLM side (needs a GPU)
 ----------------------
 
-The second part is a server that runs on a machine with a public IP address.
+The second part is a server that runs on a machine accessible from the interface side.
 This last machine will need to have a GPU to run the Large Language Model at a convenient speed.
 This part can be run using a docker image by running the script
 
 .. code-block:: bash
 
-    docker run -p8080:8080 --env NVIDIA_DISABLE_REQUIRE=1 --gpus all fractalego/wafl-llm:latest
+    $ docker run -p8080:8080 --env NVIDIA_DISABLE_REQUIRE=1 --gpus all fractalego/wafl-llm:latest
 
 
 The interface side has a `config.json` file that needs to be filled with the IP address of the LLM side.
diff --git a/documentation/build/html/_sources/rules.rst.txt b/documentation/build/html/_sources/rules.rst.txt
index 2def6baa..eb2aef73 100644
--- a/documentation/build/html/_sources/rules.rst.txt
+++ b/documentation/build/html/_sources/rules.rst.txt
@@ -33,11 +33,13 @@ One simple rule example can be
         SAY Hello, my name is Computer
 
 The rule above will be triggered when the user asks what is this bot's name.
-There are 7 types of actions:
+There are 9 types of actions:
 **SAY**,
 **REMEMBER**,
+**RETRIEVE**,
 **asking a question**,
 **generate a text**,
+**item-wise execution**,
 **triggering of another rule**,
 **code execution**,
 **entailment**.
@@ -46,8 +48,31 @@ There are 7 types of actions:
 SAY command
 -----------
 
-This command will make the bot say something.
-For example the rule above will make the bot say "Hello, my name is computer".
+This command has two uses:
+
+1) This command will make the bot say something. For example the rule above will make the bot say "Hello, my name is computer".
+
+2) This command will append to the return value of a rule. For example consider the following set
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = the user asks about themselves
+      SAY {user_qualities}
+
+    The user asks about themselves
+      SAY The user is tall
+
+
+When the user asks "how am I like", the first rule will be triggered.
+In turn, the first rule will trigger the second one.
+The output of the second rule will fill the value for user_qualities.
+
+At the end of the inference cycle the bot will reply
+
+.. code-block:: text
+
+    bot: The user is tall
 
 REMEMBER command
 ----------------
@@ -60,6 +85,26 @@ for example the rule below will make the bot remember the user's name.
     The user says their name is John
         REMEMBER The user's name is John
 
+RETRIEVE command
+----------------
+
+This command will retrieve a list of elements from memory.
+The retrieved items are selected through embedding similarity
+for example the rule below will retrieve a list of elements and display it.
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {user_qualities}
+
+
+The output would be the list of all the retrieved items
+
+.. code-block:: text
+
+    bot: [item1, item2, item3, ...]
+
 Asking a question
 -----------------
 
@@ -102,6 +147,29 @@ The text will be generated by the line "the italian version of {name}" according
 The only difference with asking question is that the text on the right hand side of `=` is a statement
 and not a question.
 
+
+Item-wise execution
+-------------------
+
+A list of items in a `variable` can be executed item-wise through the command `{[variable]}`
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {[user_qualities]}
+
+
+The output would be the retrieved items line by line
+
+.. code-block:: text
+
+    bot: item1
+    bot: item2
+    bot: item3
+    bot: ...
+
+
 Triggering of another rule
 --------------------------
 
@@ -166,6 +234,18 @@ For example the prior function can be written as follows
         while "% Do you want to continue? %":
             "% SAY I am happy to continue %"
 
+
+*Creating functions on-the-fly*
+
+The system can create a function from a description by including the description within the <...> brackets
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        greet({name}) < print on STDOUT the value of the input argument >
+
+
 Entailment
 ----------
 
diff --git a/documentation/build/html/_sources/wafl_init.rst.txt b/documentation/build/html/_sources/wafl_init.rst.txt
index 469574d1..c6ca95f6 100644
--- a/documentation/build/html/_sources/wafl_init.rst.txt
+++ b/documentation/build/html/_sources/wafl_init.rst.txt
@@ -58,4 +58,4 @@ This rule is activated when the user says "bring yourself online", and the actio
 - `start_llm.sh` is a script that starts the LLM locally.
   It simply starts a docker container with the LLM image.
 
-- The `testcases.txt` file contains the test cases that can be used to test the LLM.
\ No newline at end of file
+- The `testcases.txt` file contains the test cases that can be used to test the LLM.
diff --git a/documentation/build/html/examples.html b/documentation/build/html/examples.html
index 4b5fd113..61b270f0 100644
--- a/documentation/build/html/examples.html
+++ b/documentation/build/html/examples.html
@@ -89,8 +89,10 @@ <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this head
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#say-command">SAY command</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#remember-command">REMEMBER command</a></li>
+<li class="toctree-l2"><a class="reference internal" href="rules.html#retrieve-command">RETRIEVE command</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#asking-a-question">Asking a question</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#generate-a-text">Generate a text</a></li>
+<li class="toctree-l2"><a class="reference internal" href="rules.html#item-wise-execution">Item-wise execution</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#code-execution">Code execution</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules.html#entailment">Entailment</a></li>
diff --git a/documentation/build/html/index.html b/documentation/build/html/index.html
index 3f17dc72..3783d890 100644
--- a/documentation/build/html/index.html
+++ b/documentation/build/html/index.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Welcome to WAFL’s documentation! &mdash; WAFL  documentation</title>
+  <title>Welcome to WAFL’s 0.0.45 documentation! &mdash; WAFL  documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -62,7 +62,7 @@
           <div role="navigation" aria-label="Page navigation">
   <ul class="wy-breadcrumbs">
       <li><a href="#" class="icon icon-home" aria-label="Home"></a></li>
-      <li class="breadcrumb-item active">Welcome to WAFL’s documentation!</li>
+      <li class="breadcrumb-item active">Welcome to WAFL’s 0.0.45 documentation!</li>
       <li class="wy-breadcrumbs-aside">
             <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
       </li>
@@ -72,8 +72,8 @@
           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
            <div itemprop="articleBody">
              
-  <section id="welcome-to-wafl-s-documentation">
-<h1>Welcome to WAFL’s documentation!<a class="headerlink" href="#welcome-to-wafl-s-documentation" title="Permalink to this heading"></a></h1>
+  <section id="welcome-to-wafl-s-0-0-45-documentation">
+<h1>Welcome to WAFL’s 0.0.45 documentation!<a class="headerlink" href="#welcome-to-wafl-s-0-0-45-documentation" title="Permalink to this heading"></a></h1>
 <div class="toctree-wrapper compound">
 <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
 <ul>
@@ -96,8 +96,10 @@ <h1>Welcome to WAFL’s documentation!<a class="headerlink" href="#welcome-to-wa
 <li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#say-command">SAY command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#remember-command">REMEMBER command</a></li>
+<li class="toctree-l3"><a class="reference internal" href="rules.html#retrieve-command">RETRIEVE command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#asking-a-question">Asking a question</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#generate-a-text">Generate a text</a></li>
+<li class="toctree-l3"><a class="reference internal" href="rules.html#item-wise-execution">Item-wise execution</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#code-execution">Code execution</a></li>
 <li class="toctree-l3"><a class="reference internal" href="rules.html#entailment">Entailment</a></li>
diff --git a/documentation/build/html/installation.html b/documentation/build/html/installation.html
index 4a54f402..3ec91a15 100644
--- a/documentation/build/html/installation.html
+++ b/documentation/build/html/installation.html
@@ -86,12 +86,12 @@ <h1>Installation<a class="headerlink" href="#installation" title="Permalink to t
 <h2>Interface side<a class="headerlink" href="#interface-side" title="Permalink to this heading"></a></h2>
 <p>The first part is local to your machine and needs to have access to a microphone and speaker.
 To install it, run the following commands:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>portaudio19-dev<span class="w"> </span>ffmpeg
-pip<span class="w"> </span>install<span class="w"> </span>wafl
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>apt-get<span class="w"> </span>install<span class="w"> </span>portaudio19-dev<span class="w"> </span>ffmpeg
+$<span class="w"> </span>pip<span class="w"> </span>install<span class="w"> </span>wafl
 </pre></div>
 </div>
 <p>After installing the requirements, you can initialize the interface by running the following command:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>wafl<span class="w"> </span>init
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>wafl<span class="w"> </span>init
 </pre></div>
 </div>
 <p>which creates a <cite>config.json</cite> file that you can edit to change the default settings.
@@ -100,10 +100,10 @@ <h2>Interface side<a class="headerlink" href="#interface-side" title="Permalink
 </section>
 <section id="llm-side-needs-a-gpu">
 <h2>LLM side (needs a GPU)<a class="headerlink" href="#llm-side-needs-a-gpu" title="Permalink to this heading"></a></h2>
-<p>The second part is a server that runs on a machine with a public IP address.
+<p>The second part is a server that runs on a machine accessible from the interface side.
 This last machine will need to have a GPU to run the Large Language Model at a convenient speed.
 This part can be run using a docker image by running the script</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>docker<span class="w"> </span>run<span class="w"> </span>-p8080:8080<span class="w"> </span>--env<span class="w"> </span><span class="nv">NVIDIA_DISABLE_REQUIRE</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>--gpus<span class="w"> </span>all<span class="w"> </span>fractalego/wafl-llm:latest
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>-p8080:8080<span class="w"> </span>--env<span class="w"> </span><span class="nv">NVIDIA_DISABLE_REQUIRE</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>--gpus<span class="w"> </span>all<span class="w"> </span>fractalego/wafl-llm:latest
 </pre></div>
 </div>
 <p>The interface side has a <cite>config.json</cite> file that needs to be filled with the IP address of the LLM side.
diff --git a/documentation/build/html/introduction.html b/documentation/build/html/introduction.html
index 7ceae670..6b3ed08c 100644
--- a/documentation/build/html/introduction.html
+++ b/documentation/build/html/introduction.html
@@ -18,7 +18,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="Installation" href="installation.html" />
-    <link rel="prev" title="Welcome to WAFL’s documentation!" href="index.html" /> 
+    <link rel="prev" title="Welcome to WAFL’s 0.0.45 documentation!" href="index.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -88,7 +88,7 @@ <h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to t
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="index.html" class="btn btn-neutral float-left" title="Welcome to WAFL’s documentation!" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="index.html" class="btn btn-neutral float-left" title="Welcome to WAFL’s 0.0.45 documentation!" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="installation.html" class="btn btn-neutral float-right" title="Installation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/build/html/objects.inv b/documentation/build/html/objects.inv
index f714dbcbddffc65d15b127126ae29e26e35f22fc..6c7d4ba3004848f5016f70417fdd5e8a7ac4b8de 100644
GIT binary patch
delta 306
zcmV-20nPrO1E>R#e}B!G=*FG#BQY71i7sZ@Fz{^2P?*4LobJ4a*YhOO0#mS)xM|?`
z|7hWrw-R~FkUA81!f?8}raZE$#ZJ+OxFbSZ;ArenJG4E=-a?+bAcum-B+#=!;KaJ4
z0+$yg7E(`fM;g#l3ph<y#rB{^bE3igGA_w%i;bCM2a1~xD1REdyMNyNe0@8*uGZDf
zE%oNU1C0!&(O163AyaDFm1Q$eZ=H#cp*6xEZxNe$ip_*5$w9l~A|ndsP1ummhzqxH
z99BsP_E%r5Al^r&{uA2{*!s^d(zgFIp9uv2+qevlnrTt*89$))52>3)WZ}p<sMlz&
z`BLpC+tlNf$}6gwr-F%0^CS+K<!yP)z=HWb=v&qR`D7oemRc4+{TY_!Bc>xJzc79!
EDZ0s?00000

delta 297
zcmV+^0oMMg1D^wse}5)!-5Ea;lQEg-VwMd9&z4AG0<Uqp^BP{ylL!R{u#>oH;P?M%
z;gt^(`M{7m6t}`~y1Ah|vFiaxMeoy&2x)<%v2*9pP8=r-b?Sl~3m&pS&jNuH8;=TH
zU65H!J*FM$K}#**v{)58fC}bJqxm^3NwKBI%CQH<%?K0?-GARbZGXPL9rdnh1dR-(
z(N{k1kSVq7+Lpre>k9EPv_|-Itzw1eSRq774%#(0m{2rt<A#hzTsZ!5-ee)#UwpBG
zbP<*MPi!~i;6J-b+v(3>77+cfVHq7A)1o^t{(;s%r0!Rdm80sQUZb_<OSK<q--YqC
vRfXq*g)D<44kDQ4Lwn4~qWLZAJJtjFWbdkzS~h?C8MfsC(}2k@=T0N!1Im)j

diff --git a/documentation/build/html/rules.html b/documentation/build/html/rules.html
index 1b67453d..6fa5418e 100644
--- a/documentation/build/html/rules.html
+++ b/documentation/build/html/rules.html
@@ -51,8 +51,10 @@
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Rules</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="#say-command">SAY command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#remember-command">REMEMBER command</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#retrieve-command">RETRIEVE command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#asking-a-question">Asking a question</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#generate-a-text">Generate a text</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#item-wise-execution">Item-wise execution</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#triggering-of-another-rule">Triggering of another rule</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#code-execution">Code execution</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#entailment">Entailment</a></li>
@@ -117,18 +119,38 @@ <h1>Rules<a class="headerlink" href="#rules" title="Permalink to this heading">
 </pre></div>
 </div>
 <p>The rule above will be triggered when the user asks what is this bot’s name.
-There are 7 types of actions:
+There are 9 types of actions:
 <strong>SAY</strong>,
 <strong>REMEMBER</strong>,
+<strong>RETRIEVE</strong>,
 <strong>asking a question</strong>,
 <strong>generate a text</strong>,
+<strong>item-wise execution</strong>,
 <strong>triggering of another rule</strong>,
 <strong>code execution</strong>,
 <strong>entailment</strong>.</p>
 <section id="say-command">
 <h2>SAY command<a class="headerlink" href="#say-command" title="Permalink to this heading"></a></h2>
-<p>This command will make the bot say something.
-For example the rule above will make the bot say “Hello, my name is computer”.</p>
+<p>This command has two uses:</p>
+<ol class="arabic simple">
+<li><p>This command will make the bot say something. For example the rule above will make the bot say “Hello, my name is computer”.</p></li>
+<li><p>This command will append to the return value of a rule. For example consider the following set</p></li>
+</ol>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
+  user_qualities = the user asks about themselves
+  SAY {user_qualities}
+
+The user asks about themselves
+  SAY The user is tall
+</pre></div>
+</div>
+<p>When the user asks “how am I like”, the first rule will be triggered.
+In turn, the first rule will trigger the second one.
+The output of the second rule will fill the value for user_qualities.</p>
+<p>At the end of the inference cycle the bot will reply</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: The user is tall
+</pre></div>
+</div>
 </section>
 <section id="remember-command">
 <h2>REMEMBER command<a class="headerlink" href="#remember-command" title="Permalink to this heading"></a></h2>
@@ -139,6 +161,21 @@ <h2>REMEMBER command<a class="headerlink" href="#remember-command" title="Permal
 </pre></div>
 </div>
 </section>
+<section id="retrieve-command">
+<h2>RETRIEVE command<a class="headerlink" href="#retrieve-command" title="Permalink to this heading"></a></h2>
+<p>This command will retrieve a list of elements from memory.
+The retrieved items are selected through embedding similarity
+for example the rule below will retrieve a list of elements and display it.</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
+  user_qualities = RETRIEVE how is the user like
+  SAY {user_qualities}
+</pre></div>
+</div>
+<p>The output would be the list of all the retrieved items</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: [item1, item2, item3, ...]
+</pre></div>
+</div>
+</section>
 <section id="asking-a-question">
 <h2>Asking a question<a class="headerlink" href="#asking-a-question" title="Permalink to this heading"></a></h2>
 <p>Typing a question (with or without question mark) will return a variable.
@@ -172,6 +209,22 @@ <h2>Generate a text<a class="headerlink" href="#generate-a-text" title="Permalin
 The only difference with asking question is that the text on the right hand side of <cite>=</cite> is a statement
 and not a question.</p>
 </section>
+<section id="item-wise-execution">
+<h2>Item-wise execution<a class="headerlink" href="#item-wise-execution" title="Permalink to this heading"></a></h2>
+<p>A list of items in a <cite>variable</cite> can be executed item-wise through the command <cite>{[variable]}</cite></p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
+  user_qualities = RETRIEVE how is the user like
+  SAY {[user_qualities]}
+</pre></div>
+</div>
+<p>The output would be the retrieved items line by line</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: item1
+bot: item2
+bot: item3
+bot: ...
+</pre></div>
+</div>
+</section>
 <section id="triggering-of-another-rule">
 <h2>Triggering of another rule<a class="headerlink" href="#triggering-of-another-rule" title="Permalink to this heading"></a></h2>
 <p>A rule can trigger another rule as follows</p>
@@ -220,6 +273,13 @@ <h2>Code execution<a class="headerlink" href="#code-execution" title="Permalink
         <span class="s2">&quot;% SAY I am happy to continue %&quot;</span>
 </pre></div>
 </div>
+<p><em>Creating functions on-the-fly</em></p>
+<p>The system can create a function from a description by including the description within the &lt;…&gt; brackets</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
+    name = what is the user&#39;s name?
+    greet({name}) &lt; print on STDOUT the value of the input argument &gt;
+</pre></div>
+</div>
 </section>
 <section id="entailment">
 <h2>Entailment<a class="headerlink" href="#entailment" title="Permalink to this heading"></a></h2>
diff --git a/documentation/build/html/searchindex.js b/documentation/build/html/searchindex.js
index f454c95e..b149212f 100644
--- a/documentation/build/html/searchindex.js
+++ b/documentation/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["chitchat", "directory_structure", "examples", "index", "installation", "introduction", "license", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init"], "filenames": ["chitchat.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst"], "titles": ["Chitchat", "Directory structure", "Examples", "Welcome to WAFL\u2019s documentation!", "Installation", "Introduction", "License", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init"], "terms": {"wafl": [0, 1, 2, 4, 5, 7], "improvis": 0, "all": [0, 4, 6, 8, 9], "convers": [0, 10], "unless": 0, "rule": [0, 1, 2, 3, 4, 5, 9, 10], "i": [0, 1, 4, 5, 6, 7, 8, 9, 10], "trigger": [0, 2, 3, 8, 10], "thi": [0, 4, 6, 7, 9, 10], "possibl": 0, "thank": 0, "llm": [0, 3, 5, 7, 10], "connect": [0, 6], "aspiration": 0, "system": [0, 4, 7, 9], "one": [0, 1, 8, 10], "dai": 0, "abl": 0, "gener": [0, 2, 3, 10], "its": [0, 5, 8], "own": 0, "accord": [0, 1, 7], "context": 0, "yet": 0, "too": 0, "far": 0, "off": 0, "futur": 0, "consid": 1, "follow": [1, 4, 5, 6, 7], "your": [1, 4, 5, 7], "project": 1, "function": [1, 7, 10], "py": [1, 7, 10], "1": [1, 4, 7, 10], "fact": [1, 7], "greet": [1, 7], "2": [1, 7], "interrupt": [1, 10], "The": [1, 4, 5, 6, 7, 8, 9, 10], "can": [1, 4, 7, 9, 10], "organis": [1, 5], "nest": 1, "each": [1, 7], "must": 1, "contain": [1, 7, 9, 10], "first": [1, 4, 7, 8], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 7, 9, 10], "infer": [1, 5, 8], "within": [1, 8], "file": [1, 4, 6, 7, 9, 10], "syntax": [1, 7], "keyword": 1, "folder_nam": 1, "includ": [1, 6], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 7, 8, 10], "ar": [1, 7, 8, 9, 10], "part": [1, 4], "For": [1, 7, 8, 10], "exampl": [1, 3, 4, 7, 8, 9, 10], "abov": [1, 6, 7], "subfold": 1, "limit": [1, 6], "below": [1, 7, 10], "more": [1, 8], "inform": 1, "you": [1, 4, 7, 8, 9], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 7], "run": [2, 3, 4], "init": [2, 3, 4], "chitchat": [2, 3], "sai": [2, 3, 8, 10], "command": [2, 3, 4, 9, 10], "rememb": [2, 3], "ask": [2, 3], "question": [2, 3], "text": [2, 3], "anoth": [2, 3], "code": [2, 3], "execut": [2, 3, 8, 9, 10], "entail": [2, 3], "backtrack": [2, 3], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 10], "side": [3, 7, 10], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 10], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 7, 8], "version": [4, 5, 7], "built": 4, "two": [4, 7, 8], "both": 4, "same": 4, "machin": [4, 10], "local": [4, 9, 10], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 9], "creat": [4, 5, 10], "config": [4, 9, 10], "json": [4, 9, 10], "edit": 4, "chang": [4, 9], "default": [4, 9], "set": [4, 10], "A": [4, 6, 7, 10], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 7, 8], "public": 4, "ip": 4, "address": 4, "last": 4, "larg": [4, 5], "languag": [4, 5, 10], "model": [4, 5, 7, 10], "conveni": 4, "speed": 4, "docker": [4, 10], "imag": [4, 10], "script": [4, 10], "p8080": 4, "8080": [4, 10], "env": 4, "nvidia_disable_requir": 4, "fractalego": [4, 6], "latest": 4, "ha": [4, 7], "fill": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 7], "framework": 5, "home": 5, "assist": 5, "It": [5, 9, 10], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 9], "an": [5, 6, 8], "chain": 5, "thought": 5, "intend": 5, "progress": 5, "current": 5, "user": [5, 7, 8, 9, 10], "while": [5, 7], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 7, 10], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 7], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 9], "deal": 6, "without": [6, 7], "restrict": 6, "right": [6, 7], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 7, 10], "so": [6, 8], "subject": 6, "condit": [6, 7, 8, 10], "notic": [6, 7], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 9], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 10], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 7], "liabil": 6, "whether": 6, "action": [6, 7, 8, 10], "contract": 6, "tort": 6, "otherwis": [6, 7, 8], "aris": 6, "from": [6, 7], "out": 6, "WITH": 6, "format": 7, "3": 7, "indent": 7, "number": 7, "space": 7, "return": [7, 8, 9, 10], "true": [7, 8, 10], "fals": [7, 8], "valu": 7, "If": 7, "stop": 7, "next": [7, 8], "demo": 7, "found": 7, "end": [7, 8], "when": [7, 10], "encount": 7, "new": [7, 8], "singl": 7, "bot": [7, 8], "": [7, 8], "name": [7, 8, 9, 10], "comput": [7, 9, 10], "There": [7, 9], "actor": 7, "One": 7, "simpl": 7, "what": [7, 10], "hello": [7, 10], "my": [7, 8], "7": [7, 10], "type": 7, "make": [7, 8], "someth": 7, "john": [7, 8], "mark": 7, "variabl": 7, "later": 7, "ye": 7, "No": 7, "truth": 7, "thei": 7, "want": [7, 9], "never": 7, "similar": [7, 8], "fashion": 7, "italian_nam": 7, "italian": 7, "line": [7, 9], "differ": 7, "hand": 7, "statement": 7, "done": 7, "python": 7, "defin": [7, 9], "call": 7, "def": 7, "print": 7, "argument": 7, "howev": [7, 8], "doe": [7, 9, 10], "activ": [7, 8, 9, 10], "f": 7, "avail": 7, "prior": 7, "written": [7, 10], "date": 7, "todai": 7, "continu": 7, "am": [7, 8], "happi": [7, 8], "oper": [7, 9], "rh": 7, "lh": 7, "lsh": 7, "input": 8, "satisfi": 8, "most": 8, "relev": 8, "go": 8, "through": 8, "list": [8, 10], "fail": 8, "until": 8, "feel": 8, "well": 8, "ok": 8, "jane": 8, "Then": 8, "becaus": 8, "veri": 8, "result": [8, 9], "appli": 8, "recurs": 8, "truncat": 8, "start": [8, 10], "branch": 8, "few": 9, "how": 9, "four": 9, "mode": 9, "main": 9, "loop": 9, "wait": 9, "speak": 9, "word": [9, 10], "whatev": 9, "web": 9, "listen": [9, 10], "http": 9, "request": 9, "port": [9, 10], "8889": 9, "act": 9, "chatbot": [9, 10], "webserv": 9, "testcas": [9, 10], "txt": [9, 10], "l": 10, "start_llm": 10, "sh": 10, "configur": 10, "allow_interrupt": 10, "allow": 10, "waking_up_word": 10, "wake": 10, "up": 10, "waking_up_sound": 10, "sound": 10, "woken": 10, "deactivate_sound": 10, "listener_model": 10, "openai": 10, "whisper": 10, "tini": 10, "en": 10, "speech": 10, "recognit": 10, "support": 10, "listener_hotword_logp": 10, "8": 10, "threshold": 10, "log": 10, "probabl": 10, "hotword": 10, "listener_volume_threshold": 10, "0": 10, "6": 10, "volum": 10, "listener_silence_timeout": 10, "silenc": 10, "timeout": 10, "model_host": 10, "127": 10, "host": 10, "model_port": 10, "guid": 10, "top": 10, "bring": 10, "yourself": 10, "onlin": 10, "time": 10, "data": 10, "These": 10, "everi": 10, "minut": 10, "mai": 10, "simpli": 10}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"chitchat": 0, "directori": 1, "structur": 1, "exampl": 2, "welcom": 3, "wafl": [3, 9, 10], "": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "rule": [7, 8], "sai": 7, "command": 7, "rememb": 7, "ask": 7, "question": 7, "gener": 7, "text": 7, "trigger": 7, "anoth": 7, "code": 7, "execut": 7, "entail": 7, "backtrack": 8, "run": [9, 10], "audio": 9, "server": 9, "cli": 9, "test": 9, "init": 10}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Chitchat": [[0, "chitchat"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"]], "Welcome to WAFL\u2019s documentation!": [[3, "welcome-to-wafl-s-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Rules": [[7, "rules"]], "SAY command": [[7, "say-command"]], "REMEMBER command": [[7, "remember-command"]], "Asking a question": [[7, "asking-a-question"]], "Generate a text": [[7, "generate-a-text"]], "Triggering of another rule": [[7, "triggering-of-another-rule"]], "Code execution": [[7, "code-execution"]], "Entailment": [[7, "entailment"]], "Rules and backtracking": [[8, "rules-and-backtracking"]], "Running WAFL": [[9, "running-wafl"]], "wafl run-audio": [[9, "wafl-run-audio"]], "wafl run-server": [[9, "wafl-run-server"]], "wafl run-cli": [[9, "wafl-run-cli"]], "wafl run-tests": [[9, "wafl-run-tests"]], "Running wafl init": [[10, "running-wafl-init"]]}, "indexentries": {}})
\ No newline at end of file
+Search.setIndex({"docnames": ["chitchat", "directory_structure", "examples", "index", "installation", "introduction", "license", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init"], "filenames": ["chitchat.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst"], "titles": ["Chitchat", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init"], "terms": {"wafl": [0, 1, 2, 4, 5, 7], "improvis": 0, "all": [0, 4, 6, 7, 8, 9], "convers": [0, 10], "unless": 0, "rule": [0, 1, 2, 3, 4, 5, 9, 10], "i": [0, 1, 4, 5, 6, 7, 8, 9, 10], "trigger": [0, 2, 3, 8, 10], "thi": [0, 4, 6, 7, 9, 10], "possibl": 0, "thank": 0, "llm": [0, 3, 5, 7, 10], "connect": [0, 6], "aspiration": 0, "system": [0, 4, 7, 9], "one": [0, 1, 7, 8, 10], "dai": 0, "abl": 0, "gener": [0, 2, 3, 10], "its": [0, 5, 8], "own": 0, "accord": [0, 1, 7], "context": 0, "yet": 0, "too": 0, "far": 0, "off": 0, "futur": 0, "consid": [1, 7], "follow": [1, 4, 5, 6, 7], "your": [1, 4, 5, 7], "project": 1, "function": [1, 7, 10], "py": [1, 7, 10], "1": [1, 4, 7, 10], "fact": [1, 7], "greet": [1, 7], "2": [1, 7], "interrupt": [1, 10], "The": [1, 4, 5, 6, 7, 8, 9, 10], "can": [1, 4, 7, 9, 10], "organis": [1, 5], "nest": 1, "each": [1, 7], "must": 1, "contain": [1, 7, 9, 10], "first": [1, 4, 7, 8], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 7, 9, 10], "infer": [1, 5, 7, 8], "within": [1, 7, 8], "file": [1, 4, 6, 7, 9, 10], "syntax": [1, 7], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 7], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 7, 8, 10], "ar": [1, 7, 8, 9, 10], "part": [1, 4], "For": [1, 7, 8, 10], "exampl": [1, 3, 4, 7, 8, 9, 10], "abov": [1, 6, 7], "subfold": 1, "limit": [1, 6], "below": [1, 7, 10], "more": [1, 8], "inform": 1, "you": [1, 4, 7, 8, 9], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 7], "run": [2, 3, 4], "init": [2, 3, 4], "chitchat": [2, 3], "sai": [2, 3, 8, 10], "command": [2, 3, 4, 9, 10], "rememb": [2, 3], "retriev": [2, 3], "ask": [2, 3], "question": [2, 3], "text": [2, 3], "item": [2, 3], "wise": [2, 3], "execut": [2, 3, 8, 9, 10], "anoth": [2, 3], "code": [2, 3], "entail": [2, 3], "backtrack": [2, 3], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 10], "side": [3, 7, 10], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 10], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 7, 8], "version": [4, 5, 7], "built": 4, "two": [4, 7, 8], "both": 4, "same": 4, "machin": [4, 10], "local": [4, 9, 10], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 9], "creat": [4, 5, 7, 10], "config": [4, 9, 10], "json": [4, 9, 10], "edit": 4, "chang": [4, 9], "default": [4, 9], "set": [4, 7, 10], "A": [4, 6, 7, 10], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 7, 8], "from": [4, 6, 7], "last": 4, "larg": [4, 5], "languag": [4, 5, 10], "model": [4, 5, 7, 10], "conveni": 4, "speed": 4, "docker": [4, 10], "imag": [4, 10], "script": [4, 10], "p8080": 4, "8080": [4, 10], "env": 4, "nvidia_disable_requir": 4, "fractalego": [4, 6], "latest": 4, "ha": [4, 7], "fill": [4, 7], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 7], "framework": 5, "home": 5, "assist": 5, "It": [5, 9, 10], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 9], "an": [5, 6, 8], "chain": 5, "thought": 5, "intend": 5, "progress": 5, "current": 5, "user": [5, 7, 8, 9, 10], "while": [5, 7], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 7, 10], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 7], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 9], "deal": 6, "without": [6, 7], "restrict": 6, "right": [6, 7], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 7, 10], "so": [6, 8], "subject": 6, "condit": [6, 7, 8, 10], "notic": [6, 7], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 9], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 10], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 7], "liabil": 6, "whether": 6, "action": [6, 7, 8, 10], "contract": 6, "tort": 6, "otherwis": [6, 7, 8], "aris": 6, "out": 6, "WITH": 6, "format": 7, "3": 7, "indent": 7, "number": 7, "space": 7, "return": [7, 8, 9, 10], "true": [7, 8, 10], "fals": [7, 8], "valu": 7, "If": 7, "stop": 7, "next": [7, 8], "demo": 7, "found": 7, "end": [7, 8], "when": [7, 10], "encount": 7, "new": [7, 8], "singl": 7, "bot": [7, 8], "": [7, 8], "name": [7, 8, 9, 10], "comput": [7, 9, 10], "There": [7, 9], "actor": 7, "One": 7, "simpl": 7, "what": [7, 10], "hello": [7, 10], "my": [7, 8], "9": 7, "type": 7, "make": [7, 8], "someth": 7, "append": 7, "how": [7, 9], "like": 7, "user_qu": 7, "about": 7, "themselv": 7, "tall": 7, "am": [7, 8], "turn": 7, "output": 7, "At": 7, "cycl": 7, "repli": 7, "john": [7, 8], "list": [7, 8, 10], "element": 7, "memori": 7, "select": 7, "through": [7, 8], "embed": 7, "similar": [7, 8], "displai": 7, "would": 7, "item1": 7, "item2": 7, "item3": 7, "mark": 7, "variabl": 7, "later": 7, "ye": 7, "No": 7, "truth": 7, "thei": 7, "want": [7, 9], "never": 7, "fashion": 7, "italian_nam": 7, "italian": 7, "line": [7, 9], "differ": 7, "hand": 7, "statement": 7, "_variable_": [], "_": [], "done": 7, "python": 7, "defin": [7, 9], "call": 7, "def": 7, "print": 7, "argument": 7, "howev": [7, 8], "doe": [7, 9, 10], "activ": [7, 8, 9, 10], "f": 7, "avail": 7, "prior": 7, "written": [7, 10], "date": 7, "todai": 7, "continu": 7, "happi": [7, 8], "oper": [7, 9], "rh": 7, "lh": 7, "lsh": 7, "input": [7, 8], "satisfi": 8, "most": 8, "relev": 8, "go": 8, "fail": 8, "until": 8, "feel": 8, "well": 8, "ok": 8, "jane": 8, "Then": 8, "becaus": 8, "veri": 8, "result": [8, 9], "appli": 8, "recurs": 8, "truncat": 8, "start": [8, 10], "branch": 8, "few": 9, "four": 9, "mode": 9, "main": 9, "loop": 9, "wait": 9, "speak": 9, "word": [9, 10], "whatev": 9, "web": 9, "listen": [9, 10], "http": 9, "request": 9, "port": [9, 10], "8889": 9, "act": 9, "chatbot": [9, 10], "webserv": 9, "testcas": [9, 10], "txt": [9, 10], "l": 10, "start_llm": 10, "sh": 10, "configur": 10, "allow_interrupt": 10, "allow": 10, "waking_up_word": 10, "wake": 10, "up": 10, "waking_up_sound": 10, "sound": 10, "woken": 10, "deactivate_sound": 10, "listener_model": 10, "openai": 10, "whisper": 10, "tini": 10, "en": 10, "speech": 10, "recognit": 10, "support": 10, "listener_hotword_logp": 10, "8": 10, "threshold": 10, "log": 10, "probabl": 10, "hotword": 10, "listener_volume_threshold": 10, "0": 10, "6": 10, "volum": 10, "listener_silence_timeout": 10, "7": 10, "silenc": 10, "timeout": 10, "model_host": 10, "127": 10, "host": 10, "model_port": 10, "guid": 10, "top": 10, "bring": 10, "yourself": 10, "onlin": 10, "time": 10, "data": 10, "These": 10, "everi": 10, "minut": 10, "mai": 10, "simpli": 10, "fly": 7, "descript": 7, "bracket": 7, "stdout": 7}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"chitchat": 0, "directori": 1, "structur": 1, "exampl": 2, "welcom": 3, "wafl": [3, 9, 10], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "rule": [7, 8], "sai": 7, "command": 7, "rememb": 7, "retriev": 7, "ask": 7, "question": 7, "gener": 7, "text": 7, "item": 7, "wise": 7, "execut": 7, "trigger": 7, "anoth": 7, "code": 7, "entail": 7, "backtrack": 8, "run": [9, 10], "audio": 9, "server": 9, "cli": 9, "test": 9, "init": 10, "creat": [], "function": [], "fly": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Chitchat": [[0, "chitchat"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Rules and backtracking": [[8, "rules-and-backtracking"]], "Running WAFL": [[9, "running-wafl"]], "wafl run-audio": [[9, "wafl-run-audio"]], "wafl run-server": [[9, "wafl-run-server"]], "wafl run-cli": [[9, "wafl-run-cli"]], "wafl run-tests": [[9, "wafl-run-tests"]], "Running wafl init": [[10, "running-wafl-init"]], "Rules": [[7, "rules"]], "SAY command": [[7, "say-command"]], "REMEMBER command": [[7, "remember-command"]], "RETRIEVE command": [[7, "retrieve-command"]], "Asking a question": [[7, "asking-a-question"]], "Generate a text": [[7, "generate-a-text"]], "Item-wise execution": [[7, "item-wise-execution"]], "Triggering of another rule": [[7, "triggering-of-another-rule"]], "Code execution": [[7, "code-execution"]], "Entailment": [[7, "entailment"]]}, "indexentries": {}})
\ No newline at end of file
diff --git a/documentation/source/index.rst b/documentation/source/index.rst
index 26b6b11c..b032dffc 100644
--- a/documentation/source/index.rst
+++ b/documentation/source/index.rst
@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 Welcome to WAFL's 0.0.45 documentation!
-================================
+=======================================
 
 .. toctree::
    :maxdepth: 3
diff --git a/documentation/source/installation.rst b/documentation/source/installation.rst
index 6e4153ac..1624cd84 100644
--- a/documentation/source/installation.rst
+++ b/documentation/source/installation.rst
@@ -9,7 +9,7 @@ Both can be installed on the same machine.
    :align: center
 
 Interface side
----------
+--------------
 
 The first part is local to your machine and needs to have access to a microphone and speaker.
 To install it, run the following commands:
diff --git a/documentation/source/rules.rst b/documentation/source/rules.rst
index 2def6baa..eb2aef73 100644
--- a/documentation/source/rules.rst
+++ b/documentation/source/rules.rst
@@ -33,11 +33,13 @@ One simple rule example can be
         SAY Hello, my name is Computer
 
 The rule above will be triggered when the user asks what is this bot's name.
-There are 7 types of actions:
+There are 9 types of actions:
 **SAY**,
 **REMEMBER**,
+**RETRIEVE**,
 **asking a question**,
 **generate a text**,
+**item-wise execution**,
 **triggering of another rule**,
 **code execution**,
 **entailment**.
@@ -46,8 +48,31 @@ There are 7 types of actions:
 SAY command
 -----------
 
-This command will make the bot say something.
-For example the rule above will make the bot say "Hello, my name is computer".
+This command has two uses:
+
+1) This command will make the bot say something. For example the rule above will make the bot say "Hello, my name is computer".
+
+2) This command will append to the return value of a rule. For example consider the following set
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = the user asks about themselves
+      SAY {user_qualities}
+
+    The user asks about themselves
+      SAY The user is tall
+
+
+When the user asks "how am I like", the first rule will be triggered.
+In turn, the first rule will trigger the second one.
+The output of the second rule will fill the value for user_qualities.
+
+At the end of the inference cycle the bot will reply
+
+.. code-block:: text
+
+    bot: The user is tall
 
 REMEMBER command
 ----------------
@@ -60,6 +85,26 @@ for example the rule below will make the bot remember the user's name.
     The user says their name is John
         REMEMBER The user's name is John
 
+RETRIEVE command
+----------------
+
+This command will retrieve a list of elements from memory.
+The retrieved items are selected through embedding similarity
+for example the rule below will retrieve a list of elements and display it.
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {user_qualities}
+
+
+The output would be the list of all the retrieved items
+
+.. code-block:: text
+
+    bot: [item1, item2, item3, ...]
+
 Asking a question
 -----------------
 
@@ -102,6 +147,29 @@ The text will be generated by the line "the italian version of {name}" according
 The only difference with asking question is that the text on the right hand side of `=` is a statement
 and not a question.
 
+
+Item-wise execution
+-------------------
+
+A list of items in a `variable` can be executed item-wise through the command `{[variable]}`
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {[user_qualities]}
+
+
+The output would be the retrieved items line by line
+
+.. code-block:: text
+
+    bot: item1
+    bot: item2
+    bot: item3
+    bot: ...
+
+
 Triggering of another rule
 --------------------------
 
@@ -166,6 +234,18 @@ For example the prior function can be written as follows
         while "% Do you want to continue? %":
             "% SAY I am happy to continue %"
 
+
+*Creating functions on-the-fly*
+
+The system can create a function from a description by including the description within the <...> brackets
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        greet({name}) < print on STDOUT the value of the input argument >
+
+
 Entailment
 ----------
 
diff --git a/documentation/source/wafl_init.rst b/documentation/source/wafl_init.rst
index 469574d1..c6ca95f6 100644
--- a/documentation/source/wafl_init.rst
+++ b/documentation/source/wafl_init.rst
@@ -58,4 +58,4 @@ This rule is activated when the user says "bring yourself online", and the actio
 - `start_llm.sh` is a script that starts the LLM locally.
   It simply starts a docker container with the LLM image.
 
-- The `testcases.txt` file contains the test cases that can be used to test the LLM.
\ No newline at end of file
+- The `testcases.txt` file contains the test cases that can be used to test the LLM.
diff --git a/todo.txt b/todo.txt
index f5ca3a95..233c84f5 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,17 +1,23 @@
 ### TODO
 
+* rewrite documentation
+   * talk about the system will improvise the rules
+   * explain arbiter pipeline
 
-* split bullet lists into lists for mapping onto a query
-   * add something for merging as well
-* If the inference fail, should you try to improvise?
 * add init-default (with modified wafl_home) and init (as empty)
 
-* rewrite documentation
+
 * push to main!
 * push wafl-llm to main
   * and docker
 
+* add import from files in rules space
+* make stand-alone connectors (no need for server-side)
+
 
+/* split bullet lists into lists for mapping onto a query
+/   * add something for merging as well
+/* If the inference fail, should you try to improvise?
 
 /* make it so it is possible to navigate among levels of tasks
 /   * e.g.: what is the name of the list? that's not what i meant

From 282f5f973db26b325c8d584517d90dfad645bcb2 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Wed, 16 Aug 2023 11:06:30 +0100
Subject: [PATCH 11/29] updated README and documentation frontpage

---
 README.md                                     |  11 +++-----
 .../build/doctrees/environment.pickle         | Bin 106667 -> 110175 bytes
 .../build/doctrees/running_WAFL.doctree       | Bin 5761 -> 8203 bytes
 .../build/html/_sources/running_WAFL.rst.txt  |  16 ++++--------
 documentation/build/html/index.html           |   8 +++---
 documentation/build/html/running_WAFL.html    |  19 +++++++-------
 documentation/build/html/searchindex.js       |   2 +-
 documentation/source/directory_structure.rst  |   2 +-
 documentation/source/running_WAFL.rst         |  24 +++++++-----------
 todo.txt                                      |   3 ++-
 10 files changed, 35 insertions(+), 50 deletions(-)

diff --git a/README.md b/README.md
index 47ba83eb..94084eb2 100644
--- a/README.md
+++ b/README.md
@@ -65,29 +65,26 @@ Running WAFL
 This document contains a few examples of how to use the `wafl` CLI.
 There are four modes in which to run the system
 
-![Basic CLI commands](images/wafl-commands.png)
-
-
-## wafl run-audio
+## $ wafl run-audio
 
 This is the main mode of operation. It will run the system in a loop, waiting for the user to speak a command.
 The activation word is the name defined in config.json.
 The default name is "computer", but you can change it to whatever you want.
 
 
-## wafl run-server
+## $ wafl run-server
 
 It runs a local web server that listens for HTTP requests on port 8889.
 The server will act as a chatbot, executing commands and returning the result as defined in the rules.
 
 
-## wafl run-cli
+## $ wafl run-cli
 
 This command works as for the run-server command, but it will listen for commands on the command line.
 It does not run a webserver and is useful for testing purposes.
 
 
-## wafl run-tests
+## $ wafl run-tests
 
 This command will run all the tests defined in the file testcases.txt.
 
diff --git a/documentation/build/doctrees/environment.pickle b/documentation/build/doctrees/environment.pickle
index 96ef2532fc0a045be940d25c49be49bd3211905e..15f90a84aa0d029288b8c6bc0575d8ea0fb34318 100644
GIT binary patch
literal 110175
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

literal 106667
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

diff --git a/documentation/build/doctrees/running_WAFL.doctree b/documentation/build/doctrees/running_WAFL.doctree
index c5cdcd61035bbae3ef345f48136b06911fe6e6c2..a87874aee057a15e6734d09c098bb884a1ca77bf 100644
GIT binary patch
literal 8203
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
Z&<ir3I-@Q%DRVxx^n>n~te&+u{|BtWhTi}H

delta 846
zcma)*O=uHA6vsPmHqFOwB5E39VmeX^ZJMkXPq|d|Bo#rZ2L+MsW|OxeyBqeS#e*L`
zh^B5pm=SN{)k{lAz@xo*_9PU7f_PFC#Dk}5oovh|QUqa`!<+fP-~YWg^XS}WiND7`
zS)b|fHfKaVUeo28N(o)uq_^n;@ZPE<VLw<d<D0f4JDPH4L#{STimB_eQL&|_QHx=W
z%W}gh<MXnuDfq&ri+FVY=S-^^Wvr-%qgt^Th3OlVd`O?X%P|%8jvba!kCz)vM7{7(
zMLo{7H0ovk>4JJOg*nnHvZLC}zK04F)@&D+;0k0xfE;je3W|`w?5;t4P$J=@>GYr+
zY`I2Bb}O3cdxIG-L3X$d(#TF&TCR?zD<acML3_Thf@Wj398j??YX;WMii*uDHk+!&
zx@8&?CZ9r2$&1kP{Ez><{SIv~Zh?FiB7BlruaaN<5=xL_xQImZGm<}>3{2aqwXRwt
z*N5Ww>2Q)+cswXYY)_Pu>V6L2LFie)N;6iQJdYGnlDvtOP-?)Egn*?qv=Qj<;F$8#
zr}QQ$x$eWLfza!Kl4q12k>ZO;AlKsslw*|H@f6tb9D9UGkXP{xdhaLgPb8fqCxmVE
zCCE9?a`su5vLq!QWu00Oi)gNURjeODrS5L>BX_Mnji#pRA-2I5Jb(^t!ydea1K4-H
zs3GgBbF1k;n+5-73$|L&X~A9#4q7gpX1`%57MQro#BC<-!9Mi6-;PHR*_~ba4Kax-
ASO5S3

diff --git a/documentation/build/html/_sources/running_WAFL.rst.txt b/documentation/build/html/_sources/running_WAFL.rst.txt
index fb26b50e..57424211 100644
--- a/documentation/build/html/_sources/running_WAFL.rst.txt
+++ b/documentation/build/html/_sources/running_WAFL.rst.txt
@@ -3,35 +3,29 @@ Running WAFL
 This document contains a few examples of how to use the `wafl` CLI.
 There are four modes in which to run the system
 
-
-.. image:: _static/wafl-commands.png
-   :alt: Basic CLI commands
-   :align: center
-
-
-wafl run-audio
+$ wafl run-audio
 --------------
 
-This is the main mode of operation. It will run the system in a loop, waiting for the user to speak a command.
+It will run the system in a loop, waiting for the user to speak a command.
 The activation word is the name defined in config.json.
 The default name is "computer", but you can change it to whatever you want.
 
 
-wafl run-server
+$ wafl run-server
 ---------------
 
 It runs a local web server that listens for HTTP requests on port 8889.
 The server will act as a chatbot, executing commands and returning the result as defined in the rules.
 
 
-wafl run-cli
+$ wafl run-cli
 ------------
 
 This command works as for the run-server command, but it will listen for commands on the command line.
 It does not run a webserver and is useful for testing purposes.
 
 
-wafl run-tests
+$ wafl run-tests
 --------------
 
 This command will run all the tests defined in the file testcases.txt.
diff --git a/documentation/build/html/index.html b/documentation/build/html/index.html
index 3783d890..99f24d69 100644
--- a/documentation/build/html/index.html
+++ b/documentation/build/html/index.html
@@ -84,10 +84,10 @@ <h1>Welcome to WAFL’s 0.0.45 documentation!<a class="headerlink" href="#welcom
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-audio">wafl run-audio</a></li>
-<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-server">wafl run-server</a></li>
-<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-cli">wafl run-cli</a></li>
-<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-tests">wafl run-tests</a></li>
+<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-audio">$ wafl run-audio</a></li>
+<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-server">$ wafl run-server</a></li>
+<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-cli">$ wafl run-cli</a></li>
+<li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-tests">$ wafl run-tests</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a><ul>
diff --git a/documentation/build/html/running_WAFL.html b/documentation/build/html/running_WAFL.html
index cf143580..2efe072e 100644
--- a/documentation/build/html/running_WAFL.html
+++ b/documentation/build/html/running_WAFL.html
@@ -45,10 +45,10 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Running WAFL</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="#wafl-run-audio">wafl run-audio</a></li>
-<li class="toctree-l2"><a class="reference internal" href="#wafl-run-server">wafl run-server</a></li>
-<li class="toctree-l2"><a class="reference internal" href="#wafl-run-cli">wafl run-cli</a></li>
-<li class="toctree-l2"><a class="reference internal" href="#wafl-run-tests">wafl run-tests</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#wafl-run-audio">$ wafl run-audio</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#wafl-run-server">$ wafl run-server</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#wafl-run-cli">$ wafl run-cli</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#wafl-run-tests">$ wafl run-tests</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
@@ -83,25 +83,24 @@
 <h1>Running WAFL<a class="headerlink" href="#running-wafl" title="Permalink to this heading"></a></h1>
 <p>This document contains a few examples of how to use the <cite>wafl</cite> CLI.
 There are four modes in which to run the system</p>
-<img alt="Basic CLI commands" class="align-center" src="_images/wafl-commands.png" />
 <section id="wafl-run-audio">
-<h2>wafl run-audio<a class="headerlink" href="#wafl-run-audio" title="Permalink to this heading"></a></h2>
-<p>This is the main mode of operation. It will run the system in a loop, waiting for the user to speak a command.
+<h2>$ wafl run-audio<a class="headerlink" href="#wafl-run-audio" title="Permalink to this heading"></a></h2>
+<p>It will run the system in a loop, waiting for the user to speak a command.
 The activation word is the name defined in config.json.
 The default name is “computer”, but you can change it to whatever you want.</p>
 </section>
 <section id="wafl-run-server">
-<h2>wafl run-server<a class="headerlink" href="#wafl-run-server" title="Permalink to this heading"></a></h2>
+<h2>$ wafl run-server<a class="headerlink" href="#wafl-run-server" title="Permalink to this heading"></a></h2>
 <p>It runs a local web server that listens for HTTP requests on port 8889.
 The server will act as a chatbot, executing commands and returning the result as defined in the rules.</p>
 </section>
 <section id="wafl-run-cli">
-<h2>wafl run-cli<a class="headerlink" href="#wafl-run-cli" title="Permalink to this heading"></a></h2>
+<h2>$ wafl run-cli<a class="headerlink" href="#wafl-run-cli" title="Permalink to this heading"></a></h2>
 <p>This command works as for the run-server command, but it will listen for commands on the command line.
 It does not run a webserver and is useful for testing purposes.</p>
 </section>
 <section id="wafl-run-tests">
-<h2>wafl run-tests<a class="headerlink" href="#wafl-run-tests" title="Permalink to this heading"></a></h2>
+<h2>$ wafl run-tests<a class="headerlink" href="#wafl-run-tests" title="Permalink to this heading"></a></h2>
 <p>This command will run all the tests defined in the file testcases.txt.</p>
 </section>
 </section>
diff --git a/documentation/build/html/searchindex.js b/documentation/build/html/searchindex.js
index b149212f..49fa82c7 100644
--- a/documentation/build/html/searchindex.js
+++ b/documentation/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["chitchat", "directory_structure", "examples", "index", "installation", "introduction", "license", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init"], "filenames": ["chitchat.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst"], "titles": ["Chitchat", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init"], "terms": {"wafl": [0, 1, 2, 4, 5, 7], "improvis": 0, "all": [0, 4, 6, 7, 8, 9], "convers": [0, 10], "unless": 0, "rule": [0, 1, 2, 3, 4, 5, 9, 10], "i": [0, 1, 4, 5, 6, 7, 8, 9, 10], "trigger": [0, 2, 3, 8, 10], "thi": [0, 4, 6, 7, 9, 10], "possibl": 0, "thank": 0, "llm": [0, 3, 5, 7, 10], "connect": [0, 6], "aspiration": 0, "system": [0, 4, 7, 9], "one": [0, 1, 7, 8, 10], "dai": 0, "abl": 0, "gener": [0, 2, 3, 10], "its": [0, 5, 8], "own": 0, "accord": [0, 1, 7], "context": 0, "yet": 0, "too": 0, "far": 0, "off": 0, "futur": 0, "consid": [1, 7], "follow": [1, 4, 5, 6, 7], "your": [1, 4, 5, 7], "project": 1, "function": [1, 7, 10], "py": [1, 7, 10], "1": [1, 4, 7, 10], "fact": [1, 7], "greet": [1, 7], "2": [1, 7], "interrupt": [1, 10], "The": [1, 4, 5, 6, 7, 8, 9, 10], "can": [1, 4, 7, 9, 10], "organis": [1, 5], "nest": 1, "each": [1, 7], "must": 1, "contain": [1, 7, 9, 10], "first": [1, 4, 7, 8], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 7, 9, 10], "infer": [1, 5, 7, 8], "within": [1, 7, 8], "file": [1, 4, 6, 7, 9, 10], "syntax": [1, 7], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 7], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 7, 8, 10], "ar": [1, 7, 8, 9, 10], "part": [1, 4], "For": [1, 7, 8, 10], "exampl": [1, 3, 4, 7, 8, 9, 10], "abov": [1, 6, 7], "subfold": 1, "limit": [1, 6], "below": [1, 7, 10], "more": [1, 8], "inform": 1, "you": [1, 4, 7, 8, 9], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 7], "run": [2, 3, 4], "init": [2, 3, 4], "chitchat": [2, 3], "sai": [2, 3, 8, 10], "command": [2, 3, 4, 9, 10], "rememb": [2, 3], "retriev": [2, 3], "ask": [2, 3], "question": [2, 3], "text": [2, 3], "item": [2, 3], "wise": [2, 3], "execut": [2, 3, 8, 9, 10], "anoth": [2, 3], "code": [2, 3], "entail": [2, 3], "backtrack": [2, 3], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 10], "side": [3, 7, 10], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 10], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 7, 8], "version": [4, 5, 7], "built": 4, "two": [4, 7, 8], "both": 4, "same": 4, "machin": [4, 10], "local": [4, 9, 10], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 9], "creat": [4, 5, 7, 10], "config": [4, 9, 10], "json": [4, 9, 10], "edit": 4, "chang": [4, 9], "default": [4, 9], "set": [4, 7, 10], "A": [4, 6, 7, 10], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 7, 8], "from": [4, 6, 7], "last": 4, "larg": [4, 5], "languag": [4, 5, 10], "model": [4, 5, 7, 10], "conveni": 4, "speed": 4, "docker": [4, 10], "imag": [4, 10], "script": [4, 10], "p8080": 4, "8080": [4, 10], "env": 4, "nvidia_disable_requir": 4, "fractalego": [4, 6], "latest": 4, "ha": [4, 7], "fill": [4, 7], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 7], "framework": 5, "home": 5, "assist": 5, "It": [5, 9, 10], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 9], "an": [5, 6, 8], "chain": 5, "thought": 5, "intend": 5, "progress": 5, "current": 5, "user": [5, 7, 8, 9, 10], "while": [5, 7], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 7, 10], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 7], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 9], "deal": 6, "without": [6, 7], "restrict": 6, "right": [6, 7], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 7, 10], "so": [6, 8], "subject": 6, "condit": [6, 7, 8, 10], "notic": [6, 7], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 9], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 10], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 7], "liabil": 6, "whether": 6, "action": [6, 7, 8, 10], "contract": 6, "tort": 6, "otherwis": [6, 7, 8], "aris": 6, "out": 6, "WITH": 6, "format": 7, "3": 7, "indent": 7, "number": 7, "space": 7, "return": [7, 8, 9, 10], "true": [7, 8, 10], "fals": [7, 8], "valu": 7, "If": 7, "stop": 7, "next": [7, 8], "demo": 7, "found": 7, "end": [7, 8], "when": [7, 10], "encount": 7, "new": [7, 8], "singl": 7, "bot": [7, 8], "": [7, 8], "name": [7, 8, 9, 10], "comput": [7, 9, 10], "There": [7, 9], "actor": 7, "One": 7, "simpl": 7, "what": [7, 10], "hello": [7, 10], "my": [7, 8], "9": 7, "type": 7, "make": [7, 8], "someth": 7, "append": 7, "how": [7, 9], "like": 7, "user_qu": 7, "about": 7, "themselv": 7, "tall": 7, "am": [7, 8], "turn": 7, "output": 7, "At": 7, "cycl": 7, "repli": 7, "john": [7, 8], "list": [7, 8, 10], "element": 7, "memori": 7, "select": 7, "through": [7, 8], "embed": 7, "similar": [7, 8], "displai": 7, "would": 7, "item1": 7, "item2": 7, "item3": 7, "mark": 7, "variabl": 7, "later": 7, "ye": 7, "No": 7, "truth": 7, "thei": 7, "want": [7, 9], "never": 7, "fashion": 7, "italian_nam": 7, "italian": 7, "line": [7, 9], "differ": 7, "hand": 7, "statement": 7, "_variable_": [], "_": [], "done": 7, "python": 7, "defin": [7, 9], "call": 7, "def": 7, "print": 7, "argument": 7, "howev": [7, 8], "doe": [7, 9, 10], "activ": [7, 8, 9, 10], "f": 7, "avail": 7, "prior": 7, "written": [7, 10], "date": 7, "todai": 7, "continu": 7, "happi": [7, 8], "oper": [7, 9], "rh": 7, "lh": 7, "lsh": 7, "input": [7, 8], "satisfi": 8, "most": 8, "relev": 8, "go": 8, "fail": 8, "until": 8, "feel": 8, "well": 8, "ok": 8, "jane": 8, "Then": 8, "becaus": 8, "veri": 8, "result": [8, 9], "appli": 8, "recurs": 8, "truncat": 8, "start": [8, 10], "branch": 8, "few": 9, "four": 9, "mode": 9, "main": 9, "loop": 9, "wait": 9, "speak": 9, "word": [9, 10], "whatev": 9, "web": 9, "listen": [9, 10], "http": 9, "request": 9, "port": [9, 10], "8889": 9, "act": 9, "chatbot": [9, 10], "webserv": 9, "testcas": [9, 10], "txt": [9, 10], "l": 10, "start_llm": 10, "sh": 10, "configur": 10, "allow_interrupt": 10, "allow": 10, "waking_up_word": 10, "wake": 10, "up": 10, "waking_up_sound": 10, "sound": 10, "woken": 10, "deactivate_sound": 10, "listener_model": 10, "openai": 10, "whisper": 10, "tini": 10, "en": 10, "speech": 10, "recognit": 10, "support": 10, "listener_hotword_logp": 10, "8": 10, "threshold": 10, "log": 10, "probabl": 10, "hotword": 10, "listener_volume_threshold": 10, "0": 10, "6": 10, "volum": 10, "listener_silence_timeout": 10, "7": 10, "silenc": 10, "timeout": 10, "model_host": 10, "127": 10, "host": 10, "model_port": 10, "guid": 10, "top": 10, "bring": 10, "yourself": 10, "onlin": 10, "time": 10, "data": 10, "These": 10, "everi": 10, "minut": 10, "mai": 10, "simpli": 10, "fly": 7, "descript": 7, "bracket": 7, "stdout": 7}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"chitchat": 0, "directori": 1, "structur": 1, "exampl": 2, "welcom": 3, "wafl": [3, 9, 10], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "rule": [7, 8], "sai": 7, "command": 7, "rememb": 7, "retriev": 7, "ask": 7, "question": 7, "gener": 7, "text": 7, "item": 7, "wise": 7, "execut": 7, "trigger": 7, "anoth": 7, "code": 7, "entail": 7, "backtrack": 8, "run": [9, 10], "audio": 9, "server": 9, "cli": 9, "test": 9, "init": 10, "creat": [], "function": [], "fly": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Chitchat": [[0, "chitchat"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Rules and backtracking": [[8, "rules-and-backtracking"]], "Running WAFL": [[9, "running-wafl"]], "wafl run-audio": [[9, "wafl-run-audio"]], "wafl run-server": [[9, "wafl-run-server"]], "wafl run-cli": [[9, "wafl-run-cli"]], "wafl run-tests": [[9, "wafl-run-tests"]], "Running wafl init": [[10, "running-wafl-init"]], "Rules": [[7, "rules"]], "SAY command": [[7, "say-command"]], "REMEMBER command": [[7, "remember-command"]], "RETRIEVE command": [[7, "retrieve-command"]], "Asking a question": [[7, "asking-a-question"]], "Generate a text": [[7, "generate-a-text"]], "Item-wise execution": [[7, "item-wise-execution"]], "Triggering of another rule": [[7, "triggering-of-another-rule"]], "Code execution": [[7, "code-execution"]], "Entailment": [[7, "entailment"]]}, "indexentries": {}})
\ No newline at end of file
+Search.setIndex({"docnames": ["chitchat", "directory_structure", "examples", "index", "installation", "introduction", "license", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init"], "filenames": ["chitchat.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst"], "titles": ["Chitchat", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init"], "terms": {"wafl": [0, 1, 2, 4, 5, 7], "improvis": 0, "all": [0, 4, 6, 7, 8, 9], "convers": [0, 10], "unless": 0, "rule": [0, 1, 2, 3, 4, 5, 9, 10], "i": [0, 1, 4, 5, 6, 7, 8, 9, 10], "trigger": [0, 2, 3, 8, 10], "thi": [0, 4, 6, 7, 9, 10], "possibl": 0, "thank": 0, "llm": [0, 3, 5, 7, 10], "connect": [0, 6], "aspiration": 0, "system": [0, 4, 7, 9], "one": [0, 1, 7, 8, 10], "dai": 0, "abl": 0, "gener": [0, 2, 3, 10], "its": [0, 5, 8], "own": 0, "accord": [0, 1, 7], "context": 0, "yet": 0, "too": 0, "far": 0, "off": 0, "futur": 0, "consid": [1, 7], "follow": [1, 4, 5, 6, 7], "your": [1, 4, 5, 7], "project": 1, "function": [1, 7, 10], "py": [1, 7, 10], "1": [1, 4, 7, 10], "fact": [1, 7], "greet": [1, 7], "2": [1, 7], "interrupt": [1, 10], "The": [1, 4, 5, 6, 7, 8, 9, 10], "can": [1, 4, 7, 9, 10], "organis": [1, 5], "nest": 1, "each": [1, 7], "must": 1, "contain": [1, 7, 9, 10], "first": [1, 4, 7, 8], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 7, 9, 10], "infer": [1, 5, 7, 8], "within": [1, 7, 8], "file": [1, 4, 6, 7, 9, 10], "syntax": [1, 7], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 7], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 7, 8, 10], "ar": [1, 7, 8, 9, 10], "part": [1, 4], "For": [1, 7, 8, 10], "exampl": [1, 3, 4, 7, 8, 9, 10], "abov": [1, 6, 7], "subfold": 1, "limit": [1, 6], "below": [1, 7, 10], "more": [1, 8], "inform": 1, "you": [1, 4, 7, 8, 9], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 7], "run": [2, 3, 4], "init": [2, 3, 4], "chitchat": [2, 3], "sai": [2, 3, 8, 10], "command": [2, 3, 4, 9, 10], "rememb": [2, 3], "retriev": [2, 3], "ask": [2, 3], "question": [2, 3], "text": [2, 3], "item": [2, 3], "wise": [2, 3], "execut": [2, 3, 8, 9, 10], "anoth": [2, 3], "code": [2, 3], "entail": [2, 3], "backtrack": [2, 3], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 10], "side": [3, 7, 10], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 10], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 7, 8], "version": [4, 5, 7], "built": 4, "two": [4, 7, 8], "both": 4, "same": 4, "machin": [4, 10], "local": [4, 9, 10], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 9], "creat": [4, 5, 7, 10], "config": [4, 9, 10], "json": [4, 9, 10], "edit": 4, "chang": [4, 9], "default": [4, 9], "set": [4, 7, 10], "A": [4, 6, 7, 10], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 7, 8], "from": [4, 6, 7], "last": 4, "larg": [4, 5], "languag": [4, 5, 10], "model": [4, 5, 7, 10], "conveni": 4, "speed": 4, "docker": [4, 10], "imag": [4, 10], "script": [4, 10], "p8080": 4, "8080": [4, 10], "env": 4, "nvidia_disable_requir": 4, "fractalego": [4, 6], "latest": 4, "ha": [4, 7], "fill": [4, 7], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 7], "framework": 5, "home": 5, "assist": 5, "It": [5, 9, 10], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 9], "an": [5, 6, 8], "chain": 5, "thought": 5, "intend": 5, "progress": 5, "current": 5, "user": [5, 7, 8, 9, 10], "while": [5, 7], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 7, 10], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 7], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 9], "deal": 6, "without": [6, 7], "restrict": 6, "right": [6, 7], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 7, 10], "so": [6, 8], "subject": 6, "condit": [6, 7, 8, 10], "notic": [6, 7], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 9], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 10], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 7], "liabil": 6, "whether": 6, "action": [6, 7, 8, 10], "contract": 6, "tort": 6, "otherwis": [6, 7, 8], "aris": 6, "out": 6, "WITH": 6, "format": 7, "3": 7, "indent": 7, "number": 7, "space": 7, "return": [7, 8, 9, 10], "true": [7, 8, 10], "fals": [7, 8], "valu": 7, "If": 7, "stop": 7, "next": [7, 8], "demo": 7, "found": 7, "end": [7, 8], "when": [7, 10], "encount": 7, "new": [7, 8], "singl": 7, "bot": [7, 8], "": [7, 8], "name": [7, 8, 9, 10], "comput": [7, 9, 10], "There": [7, 9], "actor": 7, "One": 7, "simpl": 7, "what": [7, 10], "hello": [7, 10], "my": [7, 8], "9": 7, "type": 7, "make": [7, 8], "someth": 7, "append": 7, "how": [7, 9], "like": 7, "user_qu": 7, "about": 7, "themselv": 7, "tall": 7, "am": [7, 8], "turn": 7, "output": 7, "At": 7, "cycl": 7, "repli": 7, "john": [7, 8], "list": [7, 8, 10], "element": 7, "memori": 7, "select": 7, "through": [7, 8], "embed": 7, "similar": [7, 8], "displai": 7, "would": 7, "item1": 7, "item2": 7, "item3": 7, "mark": 7, "variabl": 7, "later": 7, "ye": 7, "No": 7, "truth": 7, "thei": 7, "want": [7, 9], "never": 7, "fashion": 7, "italian_nam": 7, "italian": 7, "line": [7, 9], "differ": 7, "hand": 7, "statement": 7, "_variable_": [], "_": [], "done": 7, "python": 7, "defin": [7, 9], "call": 7, "def": 7, "print": 7, "argument": 7, "howev": [7, 8], "doe": [7, 9, 10], "activ": [7, 8, 9, 10], "f": 7, "avail": 7, "prior": 7, "written": [7, 10], "date": 7, "todai": 7, "continu": 7, "happi": [7, 8], "oper": 7, "rh": 7, "lh": 7, "lsh": 7, "input": [7, 8], "satisfi": 8, "most": 8, "relev": 8, "go": 8, "fail": 8, "until": 8, "feel": 8, "well": 8, "ok": 8, "jane": 8, "Then": 8, "becaus": 8, "veri": 8, "result": [8, 9], "appli": 8, "recurs": 8, "truncat": 8, "start": [8, 10], "branch": 8, "few": 9, "four": 9, "mode": 9, "main": [], "loop": 9, "wait": 9, "speak": 9, "word": [9, 10], "whatev": 9, "web": 9, "listen": [9, 10], "http": 9, "request": 9, "port": [9, 10], "8889": 9, "act": 9, "chatbot": [9, 10], "webserv": 9, "testcas": [9, 10], "txt": [9, 10], "l": 10, "start_llm": 10, "sh": 10, "configur": 10, "allow_interrupt": 10, "allow": 10, "waking_up_word": 10, "wake": 10, "up": 10, "waking_up_sound": 10, "sound": 10, "woken": 10, "deactivate_sound": 10, "listener_model": 10, "openai": 10, "whisper": 10, "tini": 10, "en": 10, "speech": 10, "recognit": 10, "support": 10, "listener_hotword_logp": 10, "8": 10, "threshold": 10, "log": 10, "probabl": 10, "hotword": 10, "listener_volume_threshold": 10, "0": 10, "6": 10, "volum": 10, "listener_silence_timeout": 10, "7": 10, "silenc": 10, "timeout": 10, "model_host": 10, "127": 10, "host": 10, "model_port": 10, "guid": 10, "top": 10, "bring": 10, "yourself": 10, "onlin": 10, "time": 10, "data": 10, "These": 10, "everi": 10, "minut": 10, "mai": 10, "simpli": 10, "fly": 7, "descript": 7, "bracket": 7, "stdout": 7}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"chitchat": 0, "directori": 1, "structur": 1, "exampl": 2, "welcom": 3, "wafl": [3, 9, 10], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "rule": [7, 8], "sai": 7, "command": 7, "rememb": 7, "retriev": 7, "ask": 7, "question": 7, "gener": 7, "text": 7, "item": 7, "wise": 7, "execut": 7, "trigger": 7, "anoth": 7, "code": 7, "entail": 7, "backtrack": 8, "run": [9, 10], "audio": 9, "server": 9, "cli": 9, "test": 9, "init": 10, "creat": [], "function": [], "fly": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Chitchat": [[0, "chitchat"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Rules and backtracking": [[8, "rules-and-backtracking"]], "Running wafl init": [[10, "running-wafl-init"]], "Rules": [[7, "rules"]], "SAY command": [[7, "say-command"]], "REMEMBER command": [[7, "remember-command"]], "RETRIEVE command": [[7, "retrieve-command"]], "Asking a question": [[7, "asking-a-question"]], "Generate a text": [[7, "generate-a-text"]], "Item-wise execution": [[7, "item-wise-execution"]], "Triggering of another rule": [[7, "triggering-of-another-rule"]], "Code execution": [[7, "code-execution"]], "Entailment": [[7, "entailment"]], "Running WAFL": [[9, "running-wafl"]], "$ wafl run-audio": [[9, "wafl-run-audio"]], "$ wafl run-server": [[9, "wafl-run-server"]], "$ wafl run-cli": [[9, "wafl-run-cli"]], "$ wafl run-tests": [[9, "wafl-run-tests"]]}, "indexentries": {}})
\ No newline at end of file
diff --git a/documentation/source/directory_structure.rst b/documentation/source/directory_structure.rst
index 40c9b870..37167e75 100644
--- a/documentation/source/directory_structure.rst
+++ b/documentation/source/directory_structure.rst
@@ -39,5 +39,5 @@ Only the rules and facts that are included will be part of the inference.
 For example, the keyword `#using facts` within greetings/ (2) will not include the folder above it.
 Inference in a subfolder is limited the the rules and facts that are part of that folder or below it.
 
-For more information, you can have a look at the (still early) project in
+For more complete example, you can have a look at the (still early) project in
 `wafl_home <https://github.com/fractalego/wafl_home>`_.
\ No newline at end of file
diff --git a/documentation/source/running_WAFL.rst b/documentation/source/running_WAFL.rst
index fb26b50e..7cfc03c0 100644
--- a/documentation/source/running_WAFL.rst
+++ b/documentation/source/running_WAFL.rst
@@ -3,36 +3,30 @@ Running WAFL
 This document contains a few examples of how to use the `wafl` CLI.
 There are four modes in which to run the system
 
+$ wafl run-audio
+----------------
 
-.. image:: _static/wafl-commands.png
-   :alt: Basic CLI commands
-   :align: center
-
-
-wafl run-audio
---------------
-
-This is the main mode of operation. It will run the system in a loop, waiting for the user to speak a command.
+It will run the system in a loop, waiting for the user to speak a command.
 The activation word is the name defined in config.json.
 The default name is "computer", but you can change it to whatever you want.
 
 
-wafl run-server
----------------
+$ wafl run-server
+-----------------
 
 It runs a local web server that listens for HTTP requests on port 8889.
 The server will act as a chatbot, executing commands and returning the result as defined in the rules.
 
 
-wafl run-cli
-------------
+$ wafl run-cli
+--------------
 
 This command works as for the run-server command, but it will listen for commands on the command line.
 It does not run a webserver and is useful for testing purposes.
 
 
-wafl run-tests
---------------
+$ wafl run-tests
+----------------
 
 This command will run all the tests defined in the file testcases.txt.
 
diff --git a/todo.txt b/todo.txt
index 233c84f5..dfc6b1e1 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,8 +1,9 @@
 ### TODO
 
 * rewrite documentation
-   * talk about the system will improvise the rules
+   * talk about how the system will improvises rules
    * explain arbiter pipeline
+   * update config description (possibly with stand-alone connection)
 
 * add init-default (with modified wafl_home) and init (as empty)
 

From fd7bc1d58a461193ea5a486d1d5904c8444714f8 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Wed, 16 Aug 2023 16:19:16 +0100
Subject: [PATCH 12/29] Added modus operandi

---
 documentation/build/doctrees/chitchat.doctree | Bin 3186 -> 0 bytes
 .../doctrees/directory_structure.doctree      | Bin 7267 -> 7277 bytes
 .../build/doctrees/environment.pickle         | Bin 110175 -> 111414 bytes
 documentation/build/doctrees/examples.doctree | Bin 2790 -> 2731 bytes
 documentation/build/doctrees/index.doctree    | Bin 5058 -> 5116 bytes
 documentation/build/doctrees/rules.doctree    | Bin 25100 -> 2938 bytes
 .../build/doctrees/running_WAFL.doctree       | Bin 8203 -> 5443 bytes
 .../build/doctrees/wafl_init.doctree          | Bin 10273 -> 9994 bytes
 .../build/html/_images/wafl-commands.png      | Bin 11342 -> 0 bytes
 .../build/html/_sources/chitchat.rst.txt      |   8 -
 .../html/_sources/directory_structure.rst.txt |   2 +-
 .../build/html/_sources/examples.rst.txt      |   3 -
 .../build/html/_sources/index.rst.txt         |   2 +
 .../build/html/_sources/rules.rst.txt         | 262 +-----------------
 .../build/html/_sources/running_WAFL.rst.txt  |   8 +-
 .../build/html/_sources/wafl_init.rst.txt     |   2 +-
 .../build/html/_static/wafl-commands.png      | Bin 11342 -> 0 bytes
 documentation/build/html/chitchat.html        | 123 --------
 .../build/html/directory_structure.html       |  12 +-
 documentation/build/html/examples.html        |  24 +-
 documentation/build/html/genindex.html        |   3 +
 documentation/build/html/index.html           |  33 ++-
 documentation/build/html/installation.html    |   3 +
 documentation/build/html/introduction.html    |   3 +
 documentation/build/html/license.html         |   3 +
 documentation/build/html/objects.inv          | Bin 424 -> 478 bytes
 documentation/build/html/rules.html           | 244 ++--------------
 .../build/html/rules_and_backtracking.html    |  20 +-
 documentation/build/html/running_WAFL.html    |   7 +-
 documentation/build/html/search.html          |   3 +
 documentation/build/html/searchindex.js       |   2 +-
 documentation/build/html/wafl_init.html       |  14 +-
 documentation/source/_static/arbiter.png      | Bin 0 -> 44224 bytes
 .../source/_static/wafl-commands.png          | Bin 11342 -> 0 bytes
 .../source/automatic_rules_creation.rst       |   3 +
 documentation/source/chitchat.rst             |   8 -
 documentation/source/examples.rst             |   3 -
 documentation/source/index.rst                |   2 +
 .../source/query_processing_pipeline.rst      |  16 ++
 documentation/source/rules.rst                | 262 +-----------------
 documentation/source/wafl_init.rst            |   8 +-
 documentation/source/writing_the_rules.rst    | 261 +++++++++++++++++
 42 files changed, 402 insertions(+), 942 deletions(-)
 delete mode 100644 documentation/build/doctrees/chitchat.doctree
 delete mode 100644 documentation/build/html/_images/wafl-commands.png
 delete mode 100644 documentation/build/html/_sources/chitchat.rst.txt
 delete mode 100644 documentation/build/html/_static/wafl-commands.png
 delete mode 100644 documentation/build/html/chitchat.html
 create mode 100644 documentation/source/_static/arbiter.png
 delete mode 100644 documentation/source/_static/wafl-commands.png
 create mode 100644 documentation/source/automatic_rules_creation.rst
 delete mode 100644 documentation/source/chitchat.rst
 create mode 100644 documentation/source/query_processing_pipeline.rst
 create mode 100644 documentation/source/writing_the_rules.rst

diff --git a/documentation/build/doctrees/chitchat.doctree b/documentation/build/doctrees/chitchat.doctree
deleted file mode 100644
index 09b85081a139b903c6cb416605b607d2a5d811ba..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3186
zcmdT`L2uhO6mF9^wiCxm+O-(arqeKVZL!4OVTWPB4n>Du(gej&Y^Oq?CCVgBks3)Q
z_MyObD6jy$mHRXMb^9pEvK?TDorV=PB0fGoK7Q|eANgD7&*|V!_0Juef^j(?ku;Sm
zrN+Bns**CN()y47#qa*TfA0F4TpLyDgnD-e9tq<j)l~X--VKAh<-&}b^<6^~%av@G
zvku#3-FN;u>${HSR?xL6*L%gdO&GC0_`qf7EuDwG*JeKWI*;9gU{`n^yMElJ$+q2Y
zlij7;5nNJ#Sx$)CBi3p@DJ@PFPO;5X6Ef~5f*1oMzB`iS^;a(~i`8I4l9{Gi@F`u_
zl4+Ro?2tWT1NNA0vlI8jn5mqOiAd=9TIt!^(CB1*O)@cF=12k{<2uPP(5ntS(gsI)
za=ukgaO^(LMy8q+Y#p8XFE4+59bI!FBAypoU2#Jrf>EO671gE+Y@$*MYD`2TT?!g;
z6XD>~Db+L`?Y(6f<A0%y;S)?-M&t}G3STsO{rV!}HaH-pMCoXXsZm{xhwi^ipeZ^K
zAJ>RqvL~Ug>@yUTeGaaCf!|a7p5gZbg<@Z^Gj_sGf$7e&P{4LnvzT?<UoTC;b%hx)
zT%1+_n1!)4uQ67VMk!fD6M$SnrJ^a76ia}rHIcfO6~ur#Nt8~xoGx($dKScuR8~b@
zug|ImQrT4<7Sx_bpl1Vrn6pYn8PN!mMO;>aveK5Cw)OZwA7NF|@Be*8yQ_-QmI9R&
z)#^c(bl9-1QDYAQw(ET>ilFWOnM<vru+u=RyKb12I%rSaD$QVNsTIfd47C=7fP@~m
znwaT83z>Si`!f+Gq-H6q?C{d{8*(Y_F-XBOV@Y0MuwQQzBlZl#y=GWyfzg3gNgNa^
z%woF^^3n_M?qy0@(1@;0p5Ju`L6Bvc$Ma0-+`}?7(1#*UR33ERAmpRkLItfX@in(B
zUg{)vY!)=adFck47E0S#&?_qZ`Ig&bM6|<>JEn6EtSqsmSvqxGC#92eitUEiL`z@=
z4^2r9OW$ge&~PaKhZ}NPls2X^QK7}W>z6h=`}WLmd_UftjH%X2$I!G?Pz{_zs)_aP
zP?dHwN~enA-N~()TOrt$8`eQr2`raB-ki9#(jA2Z7@)*}kHCSvI}k)pOERT^JH>bl
z*QUF#X^@XNr3J`=Z8(^5>2{$S8O{hecp4YDfcV_AT{k49Rq@K?wm2Adkd}E7x2yxI
zm4SnBS`rZg9#$4WD@~~V%2XIyrYfH2flo(tj?00@>nkgYBsRu{!)?XS!#L$8s3H#1
zWZ7MI13PsC9L9kEmAWG6LE{!@9CuT=YafO$Y+|Sm*CEOqqNS+!KHeAY5d1t2Ed|=h
zDOf0Y&aJ;Vdgg`&En<Lzdrc-4V1r<p5ab>@!+pxEEzEc0G0bLEEG$!Ur1W&`-Gks+
zB>>MDf{*f8l%ogx+0(DT0iHvhCAY!{%PRbr%kbz_68Ji!dc>*Csy)#2V`g)K&H9#1
z&_bzY{=DZ-K*&69d$T=2Y>L2;8+T+D(vo@1_>>9!K;9jp0`CVVC+M<YOEk3sQ1`2G
zJ&c7)NCWK&9#F^!g|C|pC|3|-^{gzgMR=uEPp?J<ZonRuaG8MvOI5fRbi$OATYfwb
z<Q0n4tr#9yGY`(>6Plub7f69oYO%?K1YWb4=7ftF4@!+UNtO0-^CSdWMOJItjoYU3
zDm>I&uhtSYFQ~|6%F!G)wnR@Uv<bvHMpB@b#WNGMNyD@3J=AW)T0h-jMzpLQ?1mP?
zs}J^WFxKDf4ZAR|9}IR;Aj9{by}2>$bNszv1LF?Xi&d>YNH|I!wnxO;5_)p!SEspd
zsr`^ViknZAXzO3Oesas$diOUX_LsX>i|%d2hqh`P#QeeSSk25Gw+F>YR2lTZyZuB7
z0bp?kTp8V0jr}7I|H1zR_T&ADKEi9*px*U{t#E9Z_giySvVATSQKo?+(@?FwG-z8R
L1L3|cC!@asR$tsL

diff --git a/documentation/build/doctrees/directory_structure.doctree b/documentation/build/doctrees/directory_structure.doctree
index fe38c9fb3ecdd257b9577974424dda78f5cfce85..6f17a3b221e31f556b0d17fca91b1d438a3d073c 100644
GIT binary patch
delta 80
zcmaEC@z#Q+fpu!qMwVTIQf+SeMGCq3MX3tO`MCu-sU@ijsTGMJ*5o)Lv&o!74pRO&
Lm28d^V&wt=unrud

delta 66
zcmaEB@z{c;fpu!cMwVTIqK$6(MGCq3MX3szd1?7Yxrrs2`FWFX2$qR@VUyXMA;iiB
E09Qm9+5i9m

diff --git a/documentation/build/doctrees/environment.pickle b/documentation/build/doctrees/environment.pickle
index 15f90a84aa0d029288b8c6bc0575d8ea0fb34318..86ff33ff252e281880831efcfde7e44f0977c944 100644
GIT binary patch
literal 111414
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
Z3UvX0m;Euga&4}xdX&sEovlv}{r{F&=mh`(

literal 110175
zcmeIb3!Gd>bti1=HKWmt-j?MTzDPJoLNl`bz_zf#V`*d!l1B1K#x}<E^mN~u?yH{e
zc0VKy#$ZEYH2H48goY5pve|5au;F1|VPis;Y}k-wvmw7tvLDHYM@$HT<YTjB*+AGV
z-~WHA?xXI#-96LOGk(Ov+&f)Ww;rd?Id#sdQ>PwT{mvB^U3?M$xtpuyT)udI$S$7E
zS4zbhyI5<u8}F#+3)zuS(mNWvA8kC`*yXNFm&=VYw=Y}D)GD@}%~u-kEB56|Gxol8
zA!F}5SE`%|{j63p`_84O3j0vL&dSrZe5tr^lJzr<byOSf8kCc&ZVG)nzpARGdL?6{
zicG0Em7i|71A0W>?==TihChV0rL%UWlFy>yha2wds$HwgknHm{yI4i{s*ML4Zcn*V
za_kJCvFe`T!^ax#+DxfDTggx7khJx>Yp=V0uQgnlv@5leb<nPr3VHM)U9aUzfXMo2
z&ia}?Q!b=yb~RN_*K%y2FXg8-((Xq4e5O#(+RU!m71f8nTy3V1s^#n%3~-|wSE^FW
z`bm;sB~UYdy*(+FfJ)cf<@#hQQ>~_^@&ybRt*)0(jHCfcazcd$6i`#u`qWhZe8XLr
zDHRHUg}}yLccPNDD|Yr!9?$_)#{r_DN|kt1v8%O8JyWYAy9RhRs_sCsK7)BlO_eG$
z>6+kBPgT_g7@SgnS=SH=Pz)ae^oR4)Lz1+*mYysirS~-7lGK+eW$nSqLMd|w-yh3Y
zYx&|dbL#F^8A#biLxp_tOf{7U4m8}A|KrV%qV}`tLS3eOSMHMBHg_d3zA^TeM((oQ
z<+<DOhr3D7cq%l}7h!CyRZ3o(+nyU?$sQmO5v7qkq(1Gb*abUXwf%(EwNf@c>;GIU
zKT}gPwZ@qGqPLJPPS?}Z7~BdQ6-f`)VN~gYodPK+98|xnjkL<&t{{~1zLjY$rimTf
z9;%c|wTFiu^70;j2=IScS8Pq&z^e1LRJu?ool8yCU-!D%RIQROR)Lc;t8;FTF2kX^
zeKYAQ&@crO1&QQ~S^K=Ms+a9ZdhWH-tK3U+`&9QfXtc45m?O*zXr^A98oYV1nx9r*
z=U$MzT9w_HFUIkG#hyLhQ2Vp?RJvZMr79&LfCk$3bT*657X=f6@D(tWoL$ANUeL9&
zz)UGy2M`GtKVx&Plu4B)Nzf^LRLKWfSI4tb)f}Lt>L+4mOEc-bH%V9F>lvVPsa7o2
z>{P{`0x=XbcB)!VgAvWCp7cu<iXT+H#P#LbX)?hoNOV?)CFry{2d+{eXYpqiIHm!h
z!M-UdQ!1+|)03OKB6p=i%MBhwNlk*i0ky_d`oJ06E~n0=D@9C--<eI-dbtdOtp+&{
z=*G4IgfizKg_)UBF@<tu1jv^T_kr3|b~#@tO?y)#Ng$w5(q;h^nLM~cYO0V%+j^eX
zmjT0cWfpiOkabs-K`cT8{Y9)Q0FW$8jj=Ie<3^PhV$csG2O0e{>0%i~R87?@pixyr
zZ!uph=QC$!8*@@<z5bobPZvwzFAu11x0=bA$Y~(C&RnComN#)*G!p~k!e6PZT?P+7
zda<;ZyDoRVYIp+}TrPzISQSWV-q)KX-F^^2^w^;8>N@WW5Vi-KzFMK00)xp<&3Z}e
zn3Mr_RccjllzsIoTbTwrc}eT4fNAZ)I?&RG^yW}nDlLQqj`-jquqpxf)^NUFgSam4
za@TsCL|D-ZCyfQAR~BwCKfnpH0H6>4D2(2&tNN}|*qOp|mrGakRV-))bUaroV9oGx
zZ$K8NNpMWzUb$_#Lo%I`>@n9nZ|@Zu<sx?#(-mKm5^6=v{eJHE`PJqiEft~-$?H>j
z`5LGVtw`EBNz+R;n7<^d9(hA<<nB_*Y6V5>g?u$<R~lY%y|Vfe0aga7W`ooX*`ip>
zPv!A}+fy%|DVENGdxRRVW@Jsz{e?>Gm9OggYy&AWEvnxcN-B-r;iPGlvb`kTyNd0v
z@2aTkMY%+>(+j_3<gUs6glbX2%#%5cLaqV@xS~e$m8wz&HYP({(sb+>tzyjtgdYyK
z4~~%nm4iAxLf9(foJs5S)VX|?baavWN{vSNCa9TwH($g$j%o#RDjQgzQp?c=mAp~v
zgfN$><b^R3hVp^Rfd~LTG+D1fF7t9W$v5XJdCCr4FR+02L2%2z4u#VN)nLxby-@R2
zkt+o0JSj_MYz}3FFi-JFl_!|zZlMTiS%wg-dFe(ehf!B*sao68N+L8?kF`<(_-+Y&
zK$`BCl&SPtk$+TT?!~!XlAGI|+oS&2k=v=tZ;<lfu9dVozDrcq5Cu~8au(7nR$mce
zq!}eQR)LR`X^=LSBS}^tVIc-|OT}~nRT2ff>@8BK;`^M*d`6g+e5yJU2yj3%rsr<W
z-KOeR(rXw8<U0++av@*S$T6qNs|?C>DXk}{8nvh>xTZ2FFzV*qZPLXc-Is$`4b>pi
zs;bpE*cD)Yv1+F)nH=T4P=`oX-nV*cREOADBtumv9SX!x-P!G`Ka@#SJNR~n%cs|2
zABRvtt(*Ewg$X19%&tELN=`1-YvnqnAx~IaEy9`}o<eOb{}5^*mO#wrk|Kjs6Reg(
zu5_N3uwuy4AFBp*UwxjcL7+z}01NYLsarMcjWUDf8dQ5omT^5R6p*uuub^AOq^Y5D
zNuem<O~jP~I;sq!G4Kn!Sn}kr+>g|VRI9QULzJU(Q}NbRsrH5xc?A+RT0!in<s7gv
z(dFEi<!ZHZ^}xP;nQU>$sb=j${%mEaXxH`?%QO3Q+1sz*XIF3Bhlv=RnJElr*fA8=
z5EIdXHAdOUdao(X3%TyDc+D<o4X@eVuvPc{kF)tIR@+%woL9W&einMbE96%MY@oEE
zXT$sUI*58n>DNcoJxxNR29V-@F2WnVbgC>Qd@rNl%cygGn^UDXdx=<uODPd5P+nHP
z%l)i?gVfR$q*CZmWiIu~6v&!9J%)<+Wry!RcFY<ZK0adII&yq?^w{mghYpR8oI3UL
zhHCke;8Uf4K?_gMK%+l4Ja*^Z!*}AlW5;eU<cCU?Y44kUD(>e&Dbrky+}?5)!YopV
znHc&8mF+Qik&SY%b$e;|7-BKcf)KL`tbqVk$9hwP)+1H*sj4(Hm!yp<31$~yrZ7uD
zL2|B8Ib=cVuNmk|VEKjmOc8(%_l;%FgV{nPR_T|iFKVT7!9Hsjz*j^xq|!E~N^Dgn
zVvIUmZD_4tQ7q|hZBZXe9$7!6UJ3y6-FlS=Wm(i9awJLLrqV-;hA)yx{w9?#)&Q+L
zkq~+(OQkbNgscGTOrcb%l+IOw@bb+%{f$Uk&Rb#cQt7&XYB>*)n|!39ZLal_qq~k-
z&H(FVJ=0%+2|=98oC)*`)zB4WPb$X~w8A(ND<rx(cpGdd`3mMEXk&d)6UA22fwX;D
zkY2GLgmt5q%GqfVv^~gf3Kvm&FZ34qI+Rt*&)8TGytxnM&<IDt{pjl0N9ke)QVW*_
zscw7FlFkVL;;wk@3q2gaGALI86@ewsVA=M1aOdrn&x_QrDqRZ-(E<b}98|T6R0WfS
z2vh{b<>{jr`}8xw;sI7_th=14GwCx}j1`*Gz=FR@SV47>Emfd?!Bz{cC($@Nh%~Y;
zZ2}$Vi&G^UKE#gcQMu|5REx`<Z=$q&^@*ZwVT8675=pJnl;xWf2ae~f8M}aG5g@My
zw7=PFB7xL5dU<im@p6(0)$exz6t~y2U1%)2#H*r+;n}rxz5wE^dyv`g<z^}+*b01e
zhd=LZqUJ$1lcOl;_UyTB@C`d&GNJkPfD|d(=Li^Nuc{YeO;Egii{#O6<4Y92^2(k`
z)mo=EBn_n}ori%G)`?opSC%(qQu%BOR#cJt(HxLO%5J8O6zh9Z-o{Ky$-igpS)hDY
zrq}I(9dWvt=78j{(iHj*o&yBz;rdq~b6-mxCtsvE=JwLS0P82z;sI@z1+ReG4pT)f
zR{?FN#H0rvC0)8SQ!XosHEwB<0-K~j;&8SytHpqj3#q3*jTTF1pt5<G&d*ea-~=u3
zUfyM}-sa0GnCpsZ+Hg~o>C73J2&*}ikp8@|JPQkVF~tR?UVIRX7uDQssy18pEN;5w
zB|u{klwBxeeJ^IUK@Li|yVlPUm41u=(<=x$Va(aR;-ZVVx^4}!v-Vk9X((K{tL@?-
zsK+n1Jt(G|^UMhD#ruO|>w{uSIr1wAwR2_?C<P-TjsL=E27?MV1{I)~Se=rpsMs?!
z4x0Iw2Hz^{n#V!s{3<RBip=DTkWDHxsR9HKF#P}|A&6D6f-8K@-Q`yj>Z39s!<^w~
zZU|b?>gHPErAIJR!7#4~N>O+wMu4hl)c~OdJqbbGFQyEA4+M2>3+j?#LuF8M^M-x(
zYGvPKzPK-!uh;U0;FA!f{Cd?loBVIQjNmIPXb6%pcMM3>*i3;ES_9QW4DrFR5y+&F
zGcZEY<|>JTmz%g4m_^(ku0B`-H0KmOM~Wn<dO;=^JWosV#O?<nVvsa~*409@QD=zt
zS`5nii+-IUq6zS_2;KUur*DPx;wpp#(Ezqq(rmSo2Ptz&tJf#p0VVUxh7pMA=*8|9
zBSrB<4Axx(DG_#S?ED4$V(axro4>O4oYY%p{#Ki}ua{fPT>`fkpi^e~w?TUAuhfgQ
zNT<~PTCaURO_oYwj$j5~%!2@XGr4>X%L-|+0=qu4x5+z|E@p*6LH^I2q2%iJ=ZoOF
zSXxB^aeE4om!X<B+%5iskFn|vD%2<FD4*37y_2;(4#4;uJP)IvdgE<Kt+3UhOylSZ
zce@_EpP0jb4z?m{gyN;q%)Hw7WS+O->VJs+)T6!b*2pKSYbbwNB*RIcO)Fa$yRjvb
zOKp+qmqgMP+io0P8Ec;#claRMt!gdH<Ta|E#?f1_y{0)TrwnMK>^qG)ce9ZWg8^*p
z*iO;|gpBX@0xmSQQKH@Dt{0^bYqZ`~a94ogy8~h>#A20JTSu!%HP9<<SkoaJaK8i=
zSipDAy(EKDXJBH6sFH%@z)cL`#Ra#&jC~H0lrUZwb`zzSBe^=HKtR22AGSeRG9=54
z0UM_>p>Kb}`xa)ev|yNB8OqzWDX9Q>ypQaGHSs&6ruF%vVOYs!-SzlDxNYh@_dy9X
zilWu}q?x+O6Hu#mVM>`d=3tpjV;@ZPG>GBuHsLkEbchweSE!}rbXg34OW2n0Z5?9I
zSGGEHE8TWGSMGpktHJ!jCYrm;?UyQ3-kw6;?FD&J2v$=W5a*r4fA-Rm)l+BwDVf%E
z_ET?j12R`>(>n?tA?k#m*%={Zm7Xj9XQqcJRi}S&IG}W$^#6UgDU(no&TQTv<}xa=
zaMh<h9wP~r{HI2pvyemZ>!ue!;oSX~br<`RRK#I5;}&9Wue(m~(?K`qZn)Ya0kVTn
ztt2~mN8_g&<BeU;Cr}T$-X+3q^O=3MbEQGhN)4C^-t~AehPN3E5WfN_<A(_XBqZ`S
zq-*Ymznbw&WCgSFwubXM=_2M>@6Bc#&XY)TK8FVf;SRtsMj19;IG3KSHdu9vJ8iVc
z5yK%$a+@k=ljyfAqZu<|nY)~iqE2^%=2D>HBBc!U2c<>7qGN&bI9XdspVP)$EJTDw
z0Tf?^STAHn!J#^&KF{6YedYWm>dzf=p27=?qw`m6ZnYA4j52QTL2rH0g;m*Ary)AX
zeERu6)leN;BSLqr;ruNtUCY6#E<0ai!W!M#F_$b1o3QoCwA&ZbN5}(L=0(MT8bM<M
zMvl>}R!bxP>ctjI@Pk6Q7*QU8k3&x_4dI+S{(3ad_tB{H*L?hMKG+B6AMtPxb?8g8
z&s%ZDsl)jJ>N>ijKB?fc7K2YuSJLI2KSKg*_q<4v=kkSum7jq~a29)i7MO*FrGg8D
z@-wjNMey;emA1HsTluO5jboZdqU=!L=^TFJKWto8^Yr(qVNpGUA|?D~TgQ$axAHX>
zK$S(XPdkgOp@uhaf6qZbecjOLq2{A+Wo$mi1d_xC=ZEMiu)z5d-Vl`kS-pO&UKit2
zB(9WK-C2#d8-lvbt<%H$WoA|-ApmA;ElMZ~QuFiVaJ8I=!39eOW@UD-fV4UbFOL~Z
zX01e<MS9kn#Iy<UOYj;g+O*LC>{SbUm@;XYybKKUT&2C4!F*6tr<sEj6`t{6R^crX
z%<QaP+iPJ{PERQFAfa1R=?W^Dvhqc#XsS*vG%~}_=7AVEavA5)q}fH_h_jv5k?=#v
z(UXiEb_4@MD@@wNMk6N)Gksq!)sk=@b4;P`fQu{y`F&O@RcKNORtR@}re48H01J`w
z0fZ3er6|rD5<J~aWYe-%Ou^3)o_>%y*St#kg!wDNw*kH}cdf>IY$)Id_dTIi%+N=0
zooY!*X7Ga4KSj-V2k1ydW{t+rU@e1*qDG_8X3yRh%7kD)Kv|F8BuXSi%6esfq0fz0
zwysbqp4AT<=5R3amW(mlm}svF68bB4nH$MkSX>d69XG*>32;H8tyjH5tKHRN4#M!(
zYabyhN!%5|=qdVQe;3Yn7u={|8+Pw<uQa9J6kIGzl@u5_Oh4F|S;MZ<pt7OazN33p
zBqvgZa~cQ^mqw{KwrlBLX=X$|b~pN_EP#j}DUfDNX;=L4+$}H+gSpYgClK?-eD6{~
zBv4!+jzo1C2cESTxdYky49sY@R(b$fNr3Pw#t5p>8ze=xuBZ_NNo8zcW=kp9HBky)
zp;!#*@eq6|Sb{xSEU<YxHJ~oovz566oLBbtTsVO$nh?@)`!OCmN-D(|h@*G)eD{zR
zTE#lZU%rw7Eam0^toCA*QpWqn@r^G|(x?n=%=raE<`Slf0t1@y9bh5xAbs$fYi|Hi
z#uX}4HFMs_iq>M=$MYZQ&7GZtmOcyLjq@qrPY$NqLP@LwrVf*=COIEutyj^0jSX*@
zsMNlg+I7X|K}Afc35whR_=@Zd_+*@{+C}tR=jYhog0$Nt<q%d`m@9e}*>l(0g=3{M
zcBFz`Qy0E|lbHV+7$7u8Xe?CUpo4}}mB5K))Hdb+Sc4ywRgvDqMD@3`my6AAJgV+m
zCe!}QLXt68Rq`!<vWN($a0K?*pa`?5a3G`YBGjLyi2<4hymBHGZwjZVau2{NP@SEb
zEERk&OewlGlIWLSYt*>bYgInlY}60V2wOdn{E}#0I_Dy{5A>fY)k%<4|9TGUzu$q;
zi;}b+5;8~@&Zkvzd_i~N2?<wQ(z%hm&QF$^Tj#mN(uWdX^<~M5G|2{n0%W_70e76Q
z;t>+?d}YV^W|NFv&UeflcgrDfAIt)KR({*2IGtF+kYb+X49klDDgH$PWHD0A8df4I
z&1d2jyC*tTX%g&z5$z@_FCRFFg8(pjSCk|Q2l&!CioAYJ0mvw>&Vt?gdwhmQvY3ht
zNdI0OAd7)?ATRzdD-J6YCg?rYZvgI9PzMSr<$Ui8O;ok-{RlQchx(psy!WZbBlyqq
zytHX|3nhzBgqUxw(7&D5uKl}F>P?}NQ((hYrs;A`s}2e@blX8Aq57s_oDdsiVx7S!
zY!3aoPWrR(wxiwFHCRFSgQh|~35t1xhyc(_7D=E|S1#av!DoqZ53;?_gT@Uye}4Kr
zw2fe006`DH0R*4k=~JvhvC2OK0aq8MTCIhEc|e_5fbazix?MR-qY@S=9%67q=Tla}
zqMn0X=1W#7xMOj-)*4xaFDM-};3;d8*m;71;tx;5bf8#6CS9Z%0;c+O5oV+;7%Xf+
zX$#H+H2Ng4;Gw<|*d0STGxchXh6uPb6s-xVc8F6qVL>CYCc@M;K^ui_P2tcDOc=0&
z=+9ty@_Ur7S`ftxs7!ieO$1rmWN+Q78sWCU%O_I4(PEb)cBxk{-RK~8h+$H}`G2%n
zC6ozogW7X|%muR>4z5HDdHrE%8C=5c3*cxr`ok8DE=1$k7!~VbFf<^Jz;m_CquGm=
zL;nG~7!sG<^(GFO1MLsvhuKK~s;<gAJ*-aT9roTE-Sr)yq}k1uun=qb+GYsw!nVk5
z0&7!@7R;_#U4odqikb$_>BZY~sixGix9y=QsnFw3p@ABZ7AUMyT2h1t1`KNUhilqx
zr6Yqv5`&rvG@|CSgubR7!;a>6-PsQ~X#((ih2eNqitX5ojqVE>Ts&mLy4AEtt$wDZ
z&+L`zN64la@bk-5FJdxcRDeEDj_0vzY?jej45kh*gsg>C20UH!A4_<(mqinoHvdip
zYwZLjM6hUV3dF3>Q@(7jOaR_=Y0f*m=zf?W9&3TlPL#{^hsWS`OmVQjV02~!uWHf2
z!kMWPa2WR7<1jB-2tbVmrq%engko1UL9s7Kc=&ZY>-5{iwgGho{UZ?cb%G%>n{&`f
z1!2Lf2#79B@N&MzrSfn1_%<GM&Uf(CXXu>2!{44*<$RZA#GW6}-qlS26QR9(&p;a^
z+G}q{YeIwK*25=`9U2)=(Lw&@6Cgo3gR2CcYT3?+GasmvhxMq{lG6rs%KhD;z7xg5
ztYir1lVw=okF<2ng7b%0ZC33ofv~yF?QIVE)eZF>1{csyKWaNF+Fhx40@Vmh@F#X3
z)iYH&H;(iuq))o*=}DZN!`{+R->A=JFr2gni<dXLD%^D8c?@pEQS$#y2Nd)lBh=rc
z?~^uc0&K-YD$Q~F!=N{5`wcB<JH|Y=B~P2znqnhclcv^e^syF=E{dUWG#*3wd2b$`
zaoA)6V?i^p-kSl1i6-RxHRL7FY~<a`0r6jY77&K9a<l?{msXBz=Eor2N6C9;;H*vd
zCXp#%7~e}Po<-#|mj?StTlAc^K=Nb`yI?<uHv^8X6=rvPmOgylCo6o45m2mKJ*Tm0
zaIE^|5O(tRO>sW~XV#`m5(q^KCg_K+>|TdVRD7ZZDmqsqGprQ7w6npObfLUA2@ta<
z|Gq^}7Q%)+Js{MMb1mw2Up!CnYsJ91jvW%+i$DS+y8*8-IQGncMtu-ObOh<-pa3JP
z8-)7bR44ddc1(OgoIBXtgLrs)fbMjn9?)vmyF_Yxl1VLEd&oa+FxX^>!Xj{D3(V?J
zrVLF<!(kugBAGSWa4@$XoIqCU*x7(p=(cWRTQ}n|=G-FB15CIL4~-_`FyP!SdBgI&
zL!Jlac?eHugpb2`VBYRjuOoPkIivD?r96)^V})~!uhq_R^%|3`6Y@NX=LP33Je_eq
zPVvDVap!J6Ud6{fe%ihK>pnhS&By(GyoQel_;@WIV@^t*6L@0lD9!YD!jSJwN^(Y?
zS$W#>oRa6XJah8Q<Eh~7$nP`!UEpH|j|)x_PmH;Q7dD8UGTvj(gLukTuv6h*RX%Ex
zQ|F)D+jY+3ucO@5b<Q#EJRh@oTyS2;Ke<!uJcPgIoY%|qVLZ{$8|23u@s!O~=Mnk+
zD4rLbH}P-TEOp+DKgXP(#1mdtkKu)F$_wiC)9U4_*IVVa%lRe=?<qcB&d1C6_^*6?
z36Hw-c&ON%6uBVT7wXQ>>MZ$K6lVGOM(<<i_oRk~YVTd@^=`b-v-haid)4cG>h+82
z^-JpY%Xnej@8|0x=L2{-zk-L_hjc!SKT*#|)$0ko#+;9<AD@&TKIMS(JwcduVMnod
z#B<^|_P~N<Lm(JfjaH=_J^ZVCdxw4TiaU3Q^v)$jHVnml)XQUF*a6O(2Bcs!_AdZf
zIBhED*k*;yHKUbX#`T>~Ib&`QU5x063?EmxrqH6Gj!irUPk_K}n7{Pl3I5s4ADDRo
zBc>CO-V%PSVbkwelttQLq&;UJfxMrO>-o5mkDKtY-Cl(F(7{7iz{NGK;&Q+tcDhiS
z#OA`9Ts{jIYWy{zYxNU))lonAvmeD?yI88LC1{)|+XqLKV7!V$2cT7|@)hhvcq{V-
zNNDPH=5EjvGk6Xjt%y5;C8vcKW-!@m{Yk(w$L|3AGGa?%;B6gU|H3(~7d@dAlV*ZO
z>8HCOQOa{xmMWfK^vEOUvFOPpKbIFhXPk6&0*|U*-y~(Os+Tm$a)|#`=jmL%NDNrL
zKHh5e($4=puuHc}lLx!MCvNMW3%@wqSSt3NSey4+8F)g{NHjUyr%o#jK3K<*2k{5O
zZlQImUbKeG73;d|t^L;>xbfNpH(qBkI^<B_eOj4JXTboWL&9-g4A@*U3U<w=8Lgxo
zM+$i!VDmkqaWJ=D$WrrURKXfT9;$szF;XG$9JU|Tf-<2E?D?}%FX`vdxWWe4S)$y6
zSX^Lm^;QfI5fl@zp++Tx$X}E}+~H2$jO5f_NKRM{<ea}d){F143+Nn-ktK_0`QoZ|
z?a;MDH{56jj(VZ5Yl`Z(JMz_2kNkYI?+oF~jSqY=?nG-KQ!0qg#Vd9$FiqCw9)RR3
z{0iyWfwZ)vS;qV&Bxf(15{@v4zeF&C>=HUQMllB|pkVK$sH7ODQJE5~$^7LXCWSEM
z+@flBKFGE{#K*7l@ew{ghKKFE49}x0om=s8*TR(y4(GM%frfJ%5}+l>^A+;E9Z!hw
z!}8+}Jn8xeQO6UToKGN4FU^PWrxJ7mfUZ?ge-BGFrHmuUZ6(_{$5^vy)h(wlNvipY
za|&$-Yo$R-po7)HYw^DuZX7h&YHV-x#riv<JHKm+?(OUV2_zgrxcSrI=1~=8NA@)&
z-VA~as8eLh-kwyzpsU{@Bt<~;8A^BP>bK(+hlaTobR{auy2(0%^{SX%=3?j5nO+jt
zGOSk$TOc!LId{VWY&##Az%dA6XcImJBKu6vSJ)*D9no}f0vGVZ0patg!K~FN%%0|c
zWVjF-`NG+Hy$+am#J`Edp&fvCxvQi@IFgBT&2A5#gY2N)O5FFt4=S?wE4132zLK;C
z+1UpPG=v+ubVE>Qq8rXXpfVRhgQw^>jf0}>i@Od_IvM5RpbT|~**uSdgBSc%`zg2q
zQ1p6cf;`F{wyEBKZNa_Q9A`V(y6i#*97osr-#e@mkwtyHQ@#6ds3}4+0cL~cIDd`;
zp#{T3P%lhva|FF~O@N@^Fe`DwdEaW0r*P40%f!X2S^vU_eV6k+G`0{-bbf#j6r`?1
zdtJlA-KcE-Sm>-~@m?Pe8bNvpfe3<Jsychwf;-y+>2#f!bXw<D_EQ$P1!LQQVuva!
zVRKv?Web`aMsY2i7sa)3p5WRV)sl&6cd_<m#I&&m1G)vjyC0P;6w^E?w7|3NYC?}L
zxT`JjOxJm5r*+OB&!Xm`)^<O&syEz=_jrD7#zG$@LCvF0nIXX>wVB6-5Q23OZn1+}
z-iaEgyfR^#XmK(bgq4Mj-aF04MMzKH^LsNeR<+!lkrn&7Y^K`fe4Z=g=lFOF2-f*Y
zQmwxu!^}C!m<#q|q_F5XEbNd#>QAc;i&_Fi9L5Lf#tuyXXjrrL)+1S0%q&A``50j#
ztILP@SNC>eJ{+&uJ<_>(B~aQ!Ru%@Qh-fD6)F{2zU~<#JiS~*`g~1~jZI;mn;O+&F
zFovS=BC%L19KulF9i>`M{6OHlrVRzK0K(Wu16&nO$S@HiNJcSgbX%@Qjj8+1IE34&
zLoKwPkjwAqSaEnS#hgn|-&`$$n@nBL9UmG(7!aI)JaE8D40yw%O9v3w=zv9MIn01K
z2_nkGluVS)M%cLn7Gike+*zNmgwEd<gxiV=IC6eTViP#*B0(K-HeIy<J&Z2o&Tr8K
z*q6bAn3uEvJl6UMVZn^5T73{*hofsK0mKB1T8e$>QGc1g{bBtm2Md=nAR0~|`hyk%
zj%FHo@Qv=`L154Odc0!CAKlUZ1me3ufUEN~;yMYclW<g|Iyoq*$wveVx!Z#|%IPWt
zVMKhz)7DHLF-OY?Hwj-X9NK|{Dq^@+a5SRiQ6-!&_X-`8FyWY~&uG%Zi!W$z3!849
zIo&cQ?tjMN+ie0~ukh5INle_Aq1}h|>f2ug57{h^T9s>q2$b!EnL#De^=!Vh|CT|-
zNVKM=X3F+--;1nrzU&vG4bKGl;;U1DQoa8%;MA$@-*C2;^K8wWtpm*7)C6eJrN$nf
z0?B${pg%gXkpY?W2m?yHZ{S$Sn1*?<o!2RkV{uIvVxOEP9y1)Gd>zB(2r4gAn+Be4
z=;^AA5LlK1kZY}_EuOA>kywlYbC}8u8aHyn*mD(nzns{k^~l&zqS*7fbGbZDE~;%t
zN+T24?L!a`+zn7FPN*G2@vQfJQxP3p#219BK*UMG79E1l@*<85^$o*~4jeFD$%<FI
zss?O0U8t7)ElmhN;_o>mj_)`Ic~UMhLp7>e&+!Fdjv{3a90EbTqMq*?qk}PR7=tY^
zDCYe>U;rXA%OMz<P2AX`iG_GZcvc6xYKhf|eFw*sb$H3A#T?Uuz}Cr$qdS)aXg73(
zUj_$i1&D>%6Jq9{fCF8b%=DwRGZvDT({Q^T<g}>GB*<5CTswP7OA%6ptoh53+ZZX2
zy|Q*G;VNz2dGhYvCJ8kwWB}ahE@A{S<#fE_kW9HFL8kmi%9J=}S%M_!36*Ii;Mh7t
zbih{v>nHRFp7Qa<OA#g|lpunB%?K0o=S?8QbGDRD;bq}}CDHH*xIic+{5+MBi~BKN
zNP?%jLc}_b;FSfsYovL09FdaqSoJBd`cVy~$51JF0+M>CI=7bQ#y&(^r7FS2#E=1W
zlwV_c`xgrZ11-<Tv8US-^NSQ8F!3}&Vt(L7-W+mT2g^5Kd-Jsi_^<{Cal@!J_NviC
zqr<5~qo;=NI5v_RAGz!9(eaVn_9J_`T<3yZup&o91`CCm1H8Nhk(rIjU*fjH($Zsq
z@N!B^yPAMIDlL7FT)-q@=#8z!CSSb-<-z?5p=#yWl<<Plla>x2?VV2aIHx*)@5xo3
z{+h#$dXTLO;QS1whKq9$N7IwbIRC;MJmw2>MxbgD=_kY##VB18vu$=h=SqkM2?vEP
zYYG8VXn0o(8tIa(^}ZHOEK1g5-#uCD@sJ4ojF`&>fH``+>Sc?-1CteOh#-{NsVBNL
zG2Th5SZnIMl^-L$`EfTQas0TIp5N$ktKIV^3m+J!EfD_PSk2+t;n7)4EQ^gKB9{fx
z7(P!NY;y7{jGxg646W!cDn+*1@oOQY4kk0pXzlJ+0AHljK_Q&MG?$zhNVcI=L|R0#
z-6+@E5xup<3K1^WAJgeBDltcMTemLT6y}CSNPz6v4W5dChWzvUi|zIoMQeI)?=OCn
zob)L^vV5fZ_zE9?&d2Zb@kKm>Jx6{pCxz#v;G7f+p9SMLLOW8K*oUMt5j9zv^IKBm
z)9F`F>cRs2$?ok*hWu|0nHGDJp)5nnAHem`YEQC<e|2w9vM*loV)i71{<q$fymu3#
za>#K58saGR&)B?P4;vR1OU{quDgb!KrC~8f;0lR!udZHFswj3fa92{Y@`(ze7pnjk
z*h*2>L^OiPZoHU60=iGy*kQ?+uz_+)h5Eo%suW<k!--oRC<5z<Yn~NadWU4_trC1+
zMPY;C5e7kt^<Jvu()#M&J~b*jIcH_>#*5sB{TXby>UJr&bLYkj`@?V|fdx@4YtMry
z5kv-ATp7pS?kK-ku;TE3uSq8fHktnrV6&hK&;mC<AWlma2uwXihhz6P;k``}6(R(Y
zpkTQv(N2QEGvSyrNK_jjLw)z)x(`Nj;m$qp9+5LM2*fulS{#rUcAGqq&|)MQRe<D#
zZt(s#1a-hYjM^uewjtSlM8ks_+!Ewlua#BzSw9*BP4+B3n&^`UQ8Y=C`vM*rlRwSF
z8SSJ_Sqen%^A`mtK-`YyK34I(+&ACjk3_BKvfSs~#t|OC!$1DWl;HRyvmE06(|r69
zJpfz&RF}lGo@4sHJVQeBQw{cF69PhqDgM<x;cPNqv3synhcSHtU~9R|y;k-Bs->wK
z&RbxyVPr75I53Orio6Km$45_F8a|P|_=SINK(ZDeaCg@8Dk~1J=O$<q*7JP_OXXSI
z$Asl{S7x^yV}*fw5*N*thB9`oRLI{R*s6!}CC?0_<DP9v_}ny1y{W}mW5I~7oKMqg
z>26)r0QXO~=)yvbmcFIP-N}0hYbAKIwSbgfT!N581V!9NvLK64Fu^*;a=Qt>_X%hq
zCvm529*PE}Az*qAF@RyH#*JQ(-m`n5m0<H9vOO=tn6?p?56(cvSqrfd;ErIGCK*qe
z>H&AU%CkxfKs7$`Pz`|^gF7+g)U<H|P%ODsYZtBLJ5FhG+p$|3$=YdL9HuPjUY3Y>
zxD*C*ow_|nVsxp95$prw0y10T_^G4YtXdFQ)DQ@IIKYj5?nSJxEM!c)Z5dX%K8Zs}
zxxF|)&8l$|6-pvFpeFpiRHybqj>J8Tyuqx@_@$!p*p}BjDMR=GHi#prK_u;-gEl97
z0bW@`8u4in%sQuZIrvyrOVXl)TYy*#dmi@sf%hTB*N6|>y`Or<%-~axyw@AvQ;+<s
z=V!6aEE-Jc7rVrSVn*VCCG;vIaXXgazJYq0ikC@BQQRNO6jng7Dab~Hpt#~0I;)CH
zNekS~)&X1?qg`M3r-%i#!`o%RR^ac3i{Iq3(ijm%RIsPJGsYx+bm=FlZ+??>?;kLp
z>yZ)b)QQ8V?-?E+u|`i>C&y1<Z+Ya9wPW}ce(!*X`{?N-C+<EC2kP<h;jz>AStkx#
z!(;bZM@PpF?X^bkJvlyd>Xdb2+!{T8^4RDI(niM)9=rR{=-8ds9r$kS1Vo%s2s)_r
z^a+a%>Z(RZ@ZDkS_{jLdBdB@!j?rVIr|;Wq9UeVB#ySt9(qZf5@c8M`gLfYr9=A^3
zJ$~}UsSz}P2-S{_jvXFHD<j88#!e5RRis%Xufh-O)REz1$E2y@yV3h`>EFQ<C+`~{
zz4ORv>xjgwJ!Rc7f}U{)T{VS49XvKXdVH^SX!!W>o$TGXbpjn8mtwki_Z%6KB(yh-
z{|=rWJu${%96T|0dK^FZVwB^j{ZH>1JvFk|8Xg}#MSvV0KY{8APJBU_jq$s&5mgI8
zExq<<1Vsq2yD@0LFNa2kkD)G1&zMoz#QJ;xsMYL(&C2|O$38#9&!QPNSjlfJJuB%?
zW+gFWj337$y8jl+Xub6&3ZJR^Il;Qqu?dD%)YXRT^ILE2w%!EZ&uJ6Pmq;>yfQN5_
zVM<_vVU|Pb=IJ%TkQi_SpN_8AjRSnE$8j@qB<P4vGkD4m2mm3&@A0o>3rxosO{;r{
zjXS2lA8)YpNJ+9))y6K9qG&21vs7swFrkAbbx^g1pf<eZN(m^jRH3{hd~zKSv#EM%
zy)sa*RLEz~e4%UzOWv9>djo6dF?-I%D1{iFE7fbYdiAK+T6rms8NVR9AGwC{$DBPF
ze`05UPOF=^31Ovs%JpK1UQJWM{_v0M!auH;A45Z?P~+ad=;{=_)UtLZh7<NjY!4WB
zAvav{_UeV+a1}sU-?AKoaKw4>-n$^@jVaAa9F~c%Fh215^8o1L&RFC=DI#RzqF%9i
z;8+DPndQ}VV7pgBm$L{A3c!6DX;kP;?5E-MAU5EH1oZS(Y}}*`qQPO;N}V@r;m(Xg
z)wa&^0%UA9^Wtv!FUwCcRxnpx${<8kt(D5W0?Xzd$~6DL%){;!dF{7HW_m1idLG8M
z+f2zbnJ6;V?$1*Um+FyZ;HssLqAWI!`n{Jw4`VvIHi5BejlGUMqR9#pv&JrIX!rvy
zdJ-6A=Rx%Pil|U%^}tU1;)R8Wm#9nnhBU>52rn?ssN3RVqQt8qsmQ%vlz4;N>!7|m
zfV{!_{gF9G*)g?ZdpAcJk>Yj7<?K?_U$GSu1j<8u&}-5C3eF^D5hvh}8x;83@ke)V
zSg{iEA~~0{l{MI4F}(L%?%oC0+r<k3&n0kB8e2&KyOk3{oW*KRl!n`5aT<)3H+T$L
zyn#U<c{3%0XHdTk8N%)o)wGzptxcvbDm+{zTWFJ|8iM%omNu>-JK(TXhGD(3!vtrW
zvf*XFiV-es*?0C3C@<k-FCKHwAfDd+O8fA)f4|axmWg1h4l>miQ(tqM`zEpoGjsva
zr&RI9OeKOIuy$~Pq?5}ISuW)#Ahd&5DDiYZqrhr}S3%Qt$O#i#+4(dDBazn_>_pO>
zPC|o7Y1^cMS8pa{nyd>8;l?fS>WX>d)e($dV2DknGga#xg%qHc7^MSj6AARx@O{=1
zY}a60Wd^d4M#6&{2Th=Mui7xSz8!E|PHcTa6Cg(A&h4}>0*)f5DO10kaf6`Xi);X`
z=C{Pyme3Zis<HnTOKyIrpr<9%1ATk;U@G?P*^58MVevhF$H=(%>-6|2%)aUuCRA-C
zK3K>09>iRgjF^wOWV#08vM80SM8>EbJcp}bJrUF^t^3c4*ad7(fG}mC>cb39=0(4u
zSe-BMVE&#xzS5$%uxGjfCyBsI1Z)Q>Qylv@EyzxV_FRL#%2IJU5^JSL1KdRMm6!yx
z{$FiT|H8@I^*W=Fke!EYBqGL&y?tiOEl2k6@MSm#MSmD=%rW(P_+(c9n_V54^Xsfm
z&U_~iD#)u&I*Gma&^*?Am0|Y&kDfujzhuvz1hO=Tu_;!<9M4nFpz&<kvnR$+%+YL!
z<eOvpU(cYiT)JmZA{#Wvvn8R7Ii@vzU0vN5MJ+Gbv!@jYH-~n4^P=Vmw?BhMxOvZ>
z=o(~>YQ33lj%3d>Xe8_R><O=&<|z7tEOP|6F2@L>I&G`<rb{~Q&L*<g{G&9iqrj>o
zRhhsvatz7*p6)_(oxjqZj#nH~;P)r^3SKT6pYFdHEvX4Xc#L=~xvdHsgR|p(NN|L_
z7=50PN!&@YL|m_C%^WQTCxO#9*f5}q?3qn5LbWMog@UI?qftL>fI>v;8AK`*11Xdg
zL=2pTx7Umft))0^*cqfqR4k8uyCbgF_^S0#5Em~Z_PeitI=f|J^dn2$6)3ySVMP7c
zWJ<4JdQ7`fVcL1L6pq(DU+j&?NUz8H98l;Oa5##U*w2Ed>=CG7CGWVR;a+(gsyzX1
z^QZPCdXtHt*b8DH8AezMyC)*hRCBz0?b0@EV%AbOW^kx?#^<2h9O@>8H*fC{Z=A>3
zMNwYbA<RM+LfnM{-l#4sSd*@#C-a#GuA;-W1o`ug+#%?K^(p@8UcB3jP95W>Nvt<&
zf4dQQ95pSzYe$Z^Y^x1lF;3vNBzp&JKKzk-u#RwgHTvh?CP*5XFJS3_b1)Eh241{p
z?JB<DlKYVP*~5KuQmyT0Gz>@~_5{9<CK^6dI~g`leHy5-oaU)pl4d+XlKA{RanqB`
zd3wegg>yG1TkS-uh@!Gw#_U(T>D}TUXL3=kItYg7AW{e`s`dwfB`{NadzCsjXoW#z
z<U6%F%F~4=2KhE5W&QX<!f>!Y5sCc)i8G(D)O-bzr-H`9Cb_3|NCw~gPfO4D4$c!<
zZWtDlwz!UIhy36~ab`B7x5+7X365Zc8J9;I2bwyo!T`u0FFio+Yyyxdd%OfgRY8=S
zbEhU{!pz|>mzg<?CJ!&VD7ot(JP&$WQrh%{kxWm*!MRdncU13(_JE#gT-K4A&7Ga-
z@<Tmm{tDbi&l>4>!9cTkwt+(b++7q3RJnhOR~!h6M=2>r6@}Tjz-H(mjAA>3vrQo-
zrjKk;Z<Y#k6c#pVBLK6ayW|SU@`$E-moUOPA6oW)1eSVJL0Gr0t2VMERrI7H0CTny
z#Gesg@Bk%<5R|X@yIZd;<%+WT<)flkI<ybVLM8|7Qk`M`aTy@CoWjMaWbnoK$3_o%
zn=%o<gipqaoW%Jd=}IK))=Y#Hwjd^=HU<3Fqf8`{Z7`7=x{Id)6WJfHIK)KmOJE{j
zh!ZaqOk7TVmRotWr*OTt3o0Tu&Kcr}9N0>!GOMI8uP|K0u-T^^+#t7ud-KFxuEJ0w
z7THji_sennJYPsx^0nEvtjMc5sT=fT!x2CUD3Py4_|bD?NCv{(5uev?Yq0k#A~7*2
zfw8@I{(9Z`h$ez0O|XetXL7uyZY<0SPcAbnOf>;`beX@2YlBvH&dCMC)Haaj5hqXd
z@wZ1XniNe)c3g{rhZ9SWhf__!5*47Y76JNxa-IE*Cu7fCr(W0ZwcynZTXXmhiMFM~
zm{441Ovoh<IcZT;oVnGasCjoFdnbt3^IjCWV$6S0+%z2Z4KXJnA>Y8Rx$a_Duq-|n
zuQ;?U&Lk|0pE*5SHr-sTT|Bo=7i{nRy5|6c2-KA`yFI;?#tbZ3XR*jJd>2<qn4Y|!
z-t|O~rn3lN4KF+2r5cAG`a-^p?ZtC!=u4sIlKHPc%SO>muK&6C{B?WzD=8W@F(qO7
z%XpGHw}--Vy~y+8zII#4-_6jQUeQ+Oe~1;}-l8z;T9y{W?C<@{%>JrPKp$NQ-+G^2
z-8WXUJi23KF->ha9l@)=yb~}(1|i{?MV%hQ5sFe4N8jQUrY0-TgB3P{mEjyb_gy?~
zgsEDOiwK?1w9Xlf_0vmFKeJ6HF}iF&zG(V6B$rVoPEFWI(HXHl^ST$N%->#S%6xs3
zNsUrwN)96FjTYgHJBlT3{SS=fJdETyb%xF&`8E(^&$9>xw8B6YTqz?AG1eOF^u>~I
zobO7D2L1f;($mkIlR+Jm0ks<+f<k+25EfMP=t+X7-{MRo6p-dG1#Y<0bOkmiFP3Wn
z`tQ06=s*JecD&+{1o)N&32<as9GN|V&GR=@0aH9X29BUqb3A8>y9~q=TRT~La}zla
z+@(4Vko{A9WZjmH<`iz4Fien*er3_TJ&!Hge7cy@auiluXm*n1$0CI_N=ZrBTNZhW
zo5O6lRYB{aaLo|`>)F%o@LJH@zr2>)|ECEOMAw3^a4vWRKq*Av-~s9A!`=mkLzZ(j
zP3H_}Z!(!uMQn!J?}ed^5f02Q=<VNPVHP&PDK9LsXlD`fQ|<>idqPB#K7myEw+fep
zo7iwYB`;h8Qcc`8!QyG&zy@Oi93%UfjiU)j^XS<Z`t-Sj&(3qO`czNT;bQGt_5qt)
zC)<He%?=O6?j2bPV3}<F;@iyXtQOUEaA;veEnh3xDLAeeCp+0`@F6+9uya1MXK>C|
zLyoSy<`SE<Wtr%>__N7G6Rq9#-Py6O%c1t@n(h|>GU@`0vFmWboBxWwWfTMvImcs8
ze_{y(*oV4`5KgeN563GGt?chkSlM4Q?3+&2o&`goSreX#X2M(Y)v<ZlX;?}P-`mh2
z5Anp+iHGj@K7HU}pDZ+kxFoSHlUBy#Bk))780qx|{WPbb*Xx8?`Kw!0zHmZxhFG2K
zrm@!^?d@A2$jmM-X#DGw!L4{ee|Rd)MhZ&{hbTpN$S>ZbU~A$upd8hrC%U`|b3bi}
zfluB85eaGOn+r=ek6@~nb5HucO@JPiY;NFUpR^GZ*?0kWfqVm5hi{WeJFCKAq>pzO
zk&}EJ{%sS0M6qzUY{8H_?(g&eye|0jdi7^4#>@h~3**K6mKiVJpA3d5sk_11tw9}W
z1%6A>1w1I^nLwn_Vis|(ZS!BmFF&n9*3b|NaW{PC*2K|P1r1F6_3mO~u%!Q5yyDQ3
z{?UXbeUA=7!3Yu90F%%>;So|lS7D?g8u>y#GzS00cpv>myMuK#i431m_-8^RVKI0+
z`4Sm;$6FE<XGG;zc5hV~lp&>PD^F|52jZ}-G=_ZNkBK_CoaB(C7n%t54D4T+t^DaS
zvz1RYnbzoXGe*y7ISYb2PXz2?A7?;cBRU1t(6mIhrKlBgntaVwNlM+W+@OtbE<J60
zHW`R9-W)o7I#`+-)I4F3CgK>24wa2@$i*2@$+G6psn;Jgq92&V6wNdM|9`s+_<$q-
zC|+@hBmZUsM}Cw{$vh)VRLsJCpQ2H)Ay=M7H25L{03y7@c}5_csu#T*fTkcoiNTdj
zM<NPNc)8V~@~p3^@kT5Z^e>C%^!f;|HL+JMO@~Y^qkmulR+RPTV9a^$4-eFAWNV8?
zI#_xFm5#l~REjy}Do>?LhOL2itwtTC$PN{w&ntR2@h}1HULNwG@Q#$=Y{3LEqB_J#
zlt7wrD9RwXr0@j2^R97bTXJpYbnI<09WnL2Kim^@#`}Uknho60qJc%tH+$~Q_mwTd
zVoZ0d0e5M-ztCj5qZ-H<iF#3@4{klPYrB-7v)i1IZda~=s77`SpkGcM_jj5AG%9qw
z%!?42$ZeAe$KzBU^fd7d7*&}l{hAgi9iy2}`DC_5Ba5ON_THl#s~O$+P%&ty)xf(%
zJO8E0R7YuNH?B#?1u{f`%J#bt$ZlG>g6kf4siW)I!IvCwV%5s9fbYT>|N1Ur{2C=N
zG@Q0k;l9)a5D}cecO~L%nTP)(GIYdKNMIJ|L6By+MtTlL-n=W&inE|!);rw+Z4}q^
zAZkGo_tGCJofBUN1^L|&k#Hzhww)jbon=TZN<X2f6Yy@L7d}%>2|`39+;5`}ChBO3
zftFy1T}s}vCU#syZ&~Y_9Z}2muP+Zse3w6}=-mN|$!gpdT%c>LrqQC2MX?(8-eWb_
zcQC(;fW^85+)x}~0Na_@SWi9j0qYuUT$)XMU}+)IB_8=FO;|&eN8XvpBSABP!Q&bp
zX}7E?ohUbzDqD(YKLK%>9JFh-hWYE00DLzjiuv=`FE;^Vgul9PrjVu%fs184Ins(=
za)!j0Lt8pp6*mA)3&)PI8N}nX$<~jbnOBd1<zmwUj?cGO_$1aZ?(K&RGy%i&`({W8
zzu#Q~N-`{db)FOVRe~wLP~dJhm|3-Jo<t?_EUvQfV6`myJ|B9!TGHrY8@N(PlJ8gR
z$JyCS5BoHtqN|XQIu3gJEJ8oZZP@xw0MV6%ADX_tTokd8q7Hu@)}1|vLua_?I>8dG
z<<)he(V9H%%PpoPwuE%XHoxAYiNpououePUNdDoVOY;i`Li@EGgtwCX?sH}e4bo{f
zPhDC#zTSj%q6^2@=e=;WTsLHC$x;Tq%|gK-j;?J<YORz_&%Oc+j1<&WNg|DH53$U{
zUaq=~0A(T$)HH|Wi*=jTC>?<7nXYS;!7p+MKqMD<dqra_+H-%n;idKmAf@G9YQND0
z?V?NV)q4)&GIhD?!Q+3pyRSG1wm3LdnBC*cArd*Q*Pbco($##`44LNit%nsed<5mH
zmbIG9ay>upS`=zTF!K7SK+ucoJBiGd=$`f6d4knZOG6bq-Lm#&2xOj*_JFKR&uQGA
zQO#8HWx09<>Q->)Dc7ZNCcPE)Qg$o!ua{esm2~EeU5ji_E^Wh*;6n`?taL|LXE71@
zf8PZ7QC9jU0>67UKI>Kr2sqY*O@~vb5AmizPL7Har1v-TMMf6#v{CEjKG}$A{F%_9
zFgv;ybJY!Yv`QQc+uK#XmppON71osysV!V0q9Iflx5vg!sQK@)^^N$^#LdYKXBZT5
zw7V1$?5!P%R~*_~`zH)5%H{un6cI#jP2N{KFld!<|7#jo91Kza7(a4Ke^a%N9XTa7
zt)g}8)Da6MnF)b`mkdDw2R&3IYCEn+Mygyn6c@88f<p`NL&wPR9_?!#*55+9Pe?1H
zfh%EO`VXJ2Lo?L6U~mQs-4~zfZu^Y<A4QucP636YOm*?++&EF>%Aq;sd=i@yva}}&
zB}<x4?km;JXgCp<k!N1_!VGtMnHlbnlP5LCaKq7@qyA@R-eTO&z>#7t>w6TVjrz&0
z+mnkBO_4Fg0ganU+XrGrP)i_J29B4!$w-G2>-8?QZ#Xxvya=~+-XhNfcsjS?p)WG{
zHZDLKb8eTsVR_ym&x7(jgr~b2e7AzgbcgZd=*7;R>UBg4jLP$s@;u6n70xlfRy)Vl
zYfQ3E$nzwg7o5BBbl28vQ-e1TR`b&h=M)ooM?*eSYdClF*J{abIQQU(^A7Tmd&9}E
z=8uh&5Fe`roJM2hJX|E#a9+do6?U=VycU0rIVpKg;E9;XX}p|w^1i1@NzTYKD^FXV
zQ}UdaXHK4ZJk`7eH<-fuFoWa^P7zPQqlDM-jW2e}c#k;`;_3VXTdCkLx3_GU2d}yI
z2At=tNq(LA?_>U1{B^W9cXrM>$C9fGyf4F<#org4*Rj+GS?VGDHRrruo)6=R2Hzk*
z-iW93b1d?R{C*VA3(lMPckcEv@V__X&oSpG@kEaw!wVkH7u4&g)yq|{x5{gm^OJ=0
zqkO!I(Y8<V@xK{L>L2(R;-R~j@bP9o9^vD!`S=DOFQ>Q6%lP;tA5ZY{13tdb#|SIE
zgOAtqF^fmtc|6qYoHThsnwyiR=A@Z9X<|;QpOdQRq}n;D5^zCHb9Luubyd=NiFqZR
zKh6<I=Ov7`bY7yEN#`Z(k91xlAV}xsyq|Pl{L!WJ;*2Pr{}IQ+&O2Oe>P|z!?_KKk
zZoB~L_o&x<)$4ug^^5BDOX~H@cwrvj&(}rH2k>%!1&@cJRgO2D593eN^HKGB0<SUW
z<LbvJ<%iEUFv*`L0(=#Z(7hyn{O<(_hug;KEh5)3k*sP|&9J>^3X07N87uy02p{R<
z$N5+CWv|YU&}9trpVjNf>Xmev^BN3Utp%ToSL}}O<8^cU(uIt@?_8;JCiJsf$?T)^
z%RY|}$_17C6sO!L#?%zH>r>(3wz=i?{|*<S-%?MKD=4d|u{y<gzPzh4dO4<P@}DU&
zcq)Q~on?3hkt3%W+gb$+gY@a2&(W6?$u4TX=<k&x(9aa~H#xV*;$E>SScxSjhdSja
zSI{Li=0&09XWU@TV$YN(0detV(ZV%#`2tl!byZRy?({^oGe%bm^|$JKm#H1Gf9b$5
zkp6e#xS1g4&Kv2s6Y1r`xBtY7e*p40x+;kZ5;Ucqh69(<L_!z93F4b%J+Ci};r_|e
z54X3;aK8-Dgm|6%q$hcc+GgA0lyDB0tBHA-l#(E^OP=g!ikTPtS8_q#ROs`)qN;@=
zZc{7N`K2>WD^C~g`BjdB<}5s$2NKp4o&s)!O*8G0-uV{M{crgAHXd`%ckuKsLi{`Y
z?O%lWU6zT^MPCy{iC7TseI;C8JohZ$w1%q>j|VsKy%LimY*DrVyxAr);U+}lSwdKE
zpP{PEy#X_&mz27lI=EjkqB-u+;e4vrVcudajVL}I_Ir=<ZkQl4X^g?z;q|d}23x@h
zxn);ye}{@U$t_7gKQso0qpsN1dO=@LsLdCCP#`!0Sv!ujq6<LD+}*!-A{n;W8lD$)
zx!b%b_@W_?(hZ{owR7%8tDs4pLK(FOaF(s@IHW^m2y1^t^MN+LZ3l1EXKp!sZ|OO(
zzEIT^yAl?hFOf3BQWQ@T$TDLAiwcyFD!7chQq7;W3kabqXFO=kqYR=%A#Z+8%Z=ZR
za)5P<F&^_Z2v_17??=938C(*I`4)rS-r#JRHs=*Hly8KNi4^Km-moOYa0eAuESK^I
zG1;*nQOx8bV$O4JbjCt{(FQQo?g{Hja?54O{5i0vs0G5^CMbjBD%rs>GU3RIp(N;X
zGQE*<N$SHst{8H7TeJ~#s7@eV85WoJOIBcUVHNuJ*qhka&3JTfYjH+c$6-9WWN2~5
zSs^Vf&S^eqU2$H;hnQ9*?Oy)8j}O{aocsBpCB=Dwk8WC01m1xq#VN3Xc^gxlDvP%^
zqd4bT=4mscI9o_i8}X=W`-Y^<RkevivK+G1>eFgHATiV@-Tq3wScICNx@Y+Cu|_xS
z2>s)#MoZNg-cdKR3^sJD&xT&gzna(#XytjJ;r3);^TXwB4g9^DZin($Z?;|zevmUD
zatd=aanjDI7{M*^#@r(z!@&aW2mt`wSP!Za71gsw1U~fGQper!`i26yE=*aB9S!M?
z5*}Bu33Z0&;IUDWlC(01d*dq-97t~ShNnv=$B!_h@{zjQ+fy;Lzt_#3cEJ=rPQ)ST
zYr8S$ur;dtUQd+qU=@dCR(em1N&|N=g#*rE6o&ceh<d$Jy^hIC&-Xu)4+!IDZy~nG
zKK6}PM^H47wbkf@Rc+oK?PW(rrx`;>m9D=s2~#nK`ET}ad=a8WP8Em_gXwxUUoznz
z&o+iwVNYbOY)_B#n2Uh+O7V)FVAwqg(&ZnHde`F^h|Lhfh}B;zmG@$xxK#^B{HNdo
zNqQ0O4x~^m+iALA>ZmnJ#nAd11K5Gkane$ZXX+?89N4_mm(bm&^3y|3wFDE~X;g~5
zG<7D=&v^%Gg(c9g;KaxzEP}KlWZ)y3L4>VoMrI>1(s@k|Ixv@kRU^XXe|?4y4jPF!
zJZK&Z8=!$mkHqKO=M)_fbrP+tRkUJaR(QWoFB|Jg4>$$w(L>rqTsKY<X(xfP<Zei!
z%_spAljl#Yn?l5j?PX~3CbcHy8&LlF?m{^r*LTG$4w37I1akc-Fd8tXa#bkdjF5HC
zp0w1MK%1~NFoM60d=l%C)2B~DH<U<o^x3n@rAp1Z`R1E%Q8cH&6Z;3~R*uV%z-lm7
z_<A1*UlTYQ725^_Bzs4bw50<FZ9>FNCL!8JgdCr3oi~u+gYmiQHmPk=sBdCL0;z5A
zNljyOl-3dudJ)7%Je)tVtq&1frjR!&Et+XS`19R`a6o3Ci&q>Xvuz1v_5l&(G~RO|
zI|JlbM5U0sIH-w7mr*<%tCA3tB0`}-pLRfg{M4(H=TKm)sRd{AC|RaS&$?z38&*%O
zwo~<jT72!QEX3t{rCfr99wD!1OQ(%V|HJs)bepWUE3z`NAc3s<eX=6nMrkUFx{Dwv
zV%+=*D!g#kfB_MI-gveF-*0snz5!AFRlMR5QC*clREJHX;$@nG^ZKqC8C!H2ku&4W
z$sl4)b*OeeD&lpkQUhq;kB_a}NO`qFN)w6+NEwJ#YVM<G8K3?|ASPxls$uyyj6qUI
zj4C_}hiF5{Z6VRUG!E1d!Wag^_R3vgAf$Sub<(fU2C+B;;Zitb<+5#Eu&&yOp3_d~
zduFwA!OGp$RjZ*Wh=J7*djGslhR-VhtBnNm03YulDn8D~lYD%JkH6&Ot9<mb$Z9+S
zA1Z!2C!fv9Cv#GKPKt*7qoi`Ne@W${GfCwl(n;mA3bAsBq`$O2PP-gAle1pgs#37z
zRnyb9c{0a$X4)0=3BUX_BP3(P6}P_2vDsP)N`DSIL`3jtRnXw8w{hIvvwMiTDmJJC
zoUOP^^3@?(RID_8gT_BoIBi>6jYTo;qi8X_4L=W-wf6i>;Xt)aPfE}YG$*Q}p8fRy
z1@WtzIhH`*jdNsEuQoZZyBZ!vcA;@}1@`x6%V?<Qp5gJa(Xl%laDZg&(4#$xtn+3z
zDxfqK{h%Ytaz@4b7L*OSh&0C_KSvn{+oOr<L4LuY)%-uehbdH%fDbPW;e(R0BM32Q
zV#GYkhjHTUf;;ZqhfkbWv$xJ_VnBcfY6#KgctMlzWKgj;?;D!V`$DGFZ8eF;0l!uS
z4W{sRf?z3_!dnT}I8&I%q#6U6NBJ-k{A;wjFvidV2{?p+1Q*E*=7|o92u&kI&<Di^
zXcAazHt^(v0U2WhpGn4mD?)4ls-D3EOa{=hWO&xUxZuvVn03|d?vehsXDaDGMf6?@
z(*N4BP5j??bK=?UfYiE4?#)p^k-KRe3HqSOod%1gCiiul7Ronc<lc)a5*U71t`jBN
zAo#(^n%}l`nC!PNxYI4jUUk2FWPjB&mF%wv)Ru(ouU&Qo815zlu=@e&b(8#?qk<xT
z(+m~#L6N_hh1#5#p>+qe_iHr4bm6?rrg81(LaP%tqw_eq7It<?$Tx(_w2xx<dq7RF
z;I(%|(>x|PCG*;N#qLO_-Ypzlii2z8+H(0l+}e{Uel-c-U7DHU_CU7u3KJ}?3L5Y!
z$A_^P_-v={B2E@1RvbQ1VFE0HJ+IT!SbUO=oG{yc0~!g-*zM=Bi4XiFPB%83CO+`N
zP}V3ai47&<1MiMvKSu@f;0A5gMns4yi6})U2+SZI7{WoWupfl55q4z?HUa<EFnV@H
z3@lx&*T90eE<G0L;{!3!eHj=NG9tLgUt|@keId7yJ{U5JHOA!b^FpG?54EvO%IOn7
z<5ZzAGgQs>8Jh$qRdl)TFebitnK7}y2`2vOY6F~s<>k-K4EK6E+f0PuJRt~*eMv^I
zfa8GLq@;IF9g!a3$1~LDLo<r+*Dbs<uP*H|w~95Gj%uH5fs`@tw*g})UggT(v@SGC
zvx(2PXd-Z%Y0p*k>d><aJWq^g>^oST_`<!gEnv+~wHkLI6wbR-Ni2Dr>gC6zmmLgr
z>l$yMAC5!N@%iOgIGR%X4m)o|weH1(o+<QEwh~!PbkEzdk$e9bY~>-G5Zi&%4W)Bf
zTfto`b%~x--ElxiBVou0;~y^i3m25bYEnUPRRC}aenUKxS}L;sb7`L6P1VaOy1Ak1
zu)~^BIezREsuF)VSqJbjPHoi7lFUmextNpi#QRN04APD`W@9*BTV!i0tV*;U`MuK`
z#<^1zqxV2?QKsA_%Qn~^a?X{`Aar59%=)vocg!l)zJU(vSN;&V4ooiFB(M-irkKv}
zgIg`U2rGkdYnUCfi}3X$u*egnB%L2{2LoK0P|Ah_E)KesrXep0TS^>#i^QGQ2_AjX
zZK@WqPQ%}~S})Tz%FYrPerI!~8mBB(C{35q=fRuVyU0J)S)4Pru`yD}!YOMSv7kzm
z>B)Q{Uqi@Ab&ZOy%BcQqseo|JDgRqEaqZAc%{HRdt8di3z^b1>LZjAdzF-$Ks5U=i
z<6<$X^d_@X4Pjl<(j^lrl{rY|aI~6Jw*R`DhOWi`_RB0q;NVRg3wwhGqOohL7Qz>`
z+<fiL*Ty~#C8z<5pPB|8YkAmU?9UT9q5V9OhtMYY^LZlIuuzortRnKTVEuIn7+q2E
zR0O)VDxP){iwPL>7OY>+RVz?V5`;g=#4-;>aJtSbqPZIDRX$MoA~Lq~eM(wk)5l^P
zGBm({jLUJ|wgc=|LgzoArG?3bTDlH|&cBa$c5y<d^EGx#?Yt&Qox1BWq=?LsoAc*h
z#0f7hG|o_PimA|B1sq$b!}|iqDG;X<)`56L6MBf2$|4KGyBmJoTu8msxe^sGz!K3g
zmaka@XEtsIM#`>DS8QuZipriQYHrkOfCE?hJc`_}v11ZpIH!45q*ApDjORk12Szdu
zg6m^ODt06`T<6t<S=I{xm*r$xdz%0$ik%OM-zB*Z<$h1n&nkhB2r379S^-c6vtdz%
zj;zN!4K$O^AnYud8GM5zv;mIiGx83hyd#3J2-}Y@=hYJ&kx86PIWOa>OKp3@qyM4)
zFl>OSbPp{(F7IzLP0d!8T~5?y^Xk)pe8RmfrqRZ?lBp#oY-`kvXd+mil+~w&Y3IHr
zYtxhEn_GYmwwRQd1*p@joQ}3=qyy7PU;|?BJsZ%C31UF|c`{LSLD1;rGPnnp0}^Wl
z5)tZaHMB07y!3IhSIDGvFt361acdk*hV&65+rJYM^3B*uhE~b+j5Itm=_7{`99JUi
z!cIZ<?H5sG?uGUM!xc?l#0SPP6FD=Si^%<HIroKQ&weu^uc#}gVQE2k5a4D8q5Bz%
z92TS*aP-iIg|~Ku1EndR(%eS;xBr5m(4MuuF^)vOyd7h0>m~x^@v2s~<+Xl>$t&K{
zqWTVyKVWL?x5w1}B7vzrXAs$hXRGPz5`%iF5)U2{0CzA)i(pXYiSQ2Egkmr1wgJUH
zbRZw{7Fvzv#HoZBsxb;y8OBsU)DPk=oWXVBdK(FUiJIemnV*5`(?Z%PEptyiYT6Z}
zx%FmGyn>4C`or)tG36smMR^|zQC@n<r^p->+is@mbqW0sDD;2-(}4ctvN9R_#z|{5
z3t;CS$Is$|HIyF7)_5MMI}shs`7eZ|vf?zCd%x5I+%ZJmFk$xG#MA*J)11}+)}omX
z7*McCu>am7@rr~+VnL8JOb)Fe(<MZ_O(EicmN9eyhWYd1g>+c<M%$UGw2T`yQ$^cx
zH{rM?PwvZ6zCrP~iAMkOim2!&x=8E5Ut$C@%|U@&eAGDC*M2WJa9QMTvNp}#giYN=
zp6h##2mX?+_uvTMb1?ANkIA(D4<3HtFQx>6znJBa0+u-NS2H*0*y*{K-BB+T-~lFv
zTm)mpjynv$*ph_`HwkO-8RQi0m*IGweZFjG7*eqg;>^P7DOg6t%)6+X3^uxB3xH&j
zs;_-?!1Ba$D}FCmqvC}b_vdj^ZBG(2aHFRgldNk|?~&c?TN?*fva$MP-R+&RYia7r
z4d+QZvwjv2cU6{mC%gme=y=0jQ{%bFYUAO?F6W~x@*O-vzHEW>l}umn!Cbz^Z63V}
zs}7F<Vhb}CYi3ASR4lR|Yv1seLwWd1;IbZy>6Lm0aa(Mo595pM!xQcM&^vNI4MhRa
z3R}uki){Gg?Hk^Gk6l2l4Y5me14iQ3(tY8E8{syak&Cj$ndgN@&kBp|*(ciftbeo!
zHKI_E){Vwz7uonH=hb+vQpy4uU~MuQe{7MBf2w`sJ;(AH#3nM4@Ewb6_tWj$ZGEqT
zqQ_rcWH-d|y)`3f>a(tT@R3FK;4|$3v3i`hP#DwxWTe&hx8Z0$#M{Qeht9TdH7PKq
z8uAw-jkiBUts7?;5;E&PUg{EM$7HRFKa#;Y!llS@9AO)za7W0L<mL#?5ceHHU}B@X
z^n(bYjx%s#9Dy!@rAEx2*Kx+WlnJc^&31I6mf>K5_zR4~-2^^`Q{lB#IbBIlSJLHN
zlOy`h)o?Uj=tA=i^mJhhjoT~Uki~SNalu`KFrW1b!Z>lIbNd*<xm2N>Vk37*PsVk=
z`|H;U6)d$sL|Lwm?d5${MG^=UhWz&qYjgs2?8}{2L5~1$rCs>cehtkg&Q<G4Y`bW0
z*xH@>qyW)wKKs#DC-dq25QA3}xVF<Of(cyHX%%_`g#j#h0(Utb&S0|0bD&Gp#=*3k
zwwpQySTJojNEJ>~sO>P16$Bh@{-p1&0l$N`(-02r_V5-o1ha2AL#W&BR~OwPVklQE
z=K#}sXVT}hcDa^ge2bn;THLxDWA3WyLTR!w=dQ`+v(TUL*MR=oPv|YyXC~p2kZl|V
z_|%F4?~qxP?W?5E`E4IWJDRN>!k<c!xPpI$&orIv6u{zSBpQ<faMVO&#$tDp3@-s)
z>|abTz}RFtY&OF&F9d&zJ0^?{Me;XcnB7>wINWxW^Ttj=8c@#brHW;u92rwUIUgXE
zL@4LuObb!Y%7Aj5PcW~G)bmN!M|$#TQ(B18(*+b$^rVB!zPnSf2lS-Cz9@Q{RWldy
zzVY$C)AeBUD6Xl=@D?*3@<>lcCGh`<W|suN-7Py|Ph!(@>w|7OCba#BPJtib{BLwx
zMZnAy@H?14y~vA1-;9|x6~H^@WzCiN?{;ZAIiPmz>Tf%RdoXo>BULnISIw7!PRU{Y
zsBz-eP(}wX=?*ExVCQZCDd>Z?xD++(husQvmp-(;NLjb1(<%ZoSS3|7#n(=OzKz@W
z9JjTrXxp$wr>#3r-o4uZ{<TX6{7ZJ?jIMxvP+A{M4^Efs-f_QR3I;ocUx3bgI;|o)
z1s!rCrSvGG>Y$3C7vJoZv^75zyT*d~VW;>7cG$$MnClW&aXjtVq21}^2lzADX%)fD
zr8=!b&z#tymTl&eZL(dOG!CWRq&?m#xPnRhnNF(+Chey?twK+lSfQ6~(&l5({>?7U
zAxGA34nNx|^nyA3_nlS|%;BdytwPVCnDCcv4%_Soe7j52$3eB5zQ67iaKZF_qthya
z>HB)8Rp{vx3;lwpuVW1$VJ~ItHdB0Uzn7A1YUfCj=j<47To?P%CbSh6SKGJM&eXnM
zYFtK5U>y%->H822N%V%Lf}`8N6K9kLy*9Nf8~}BHhd_1q;6pVpL!DOfc%N6rOQedf
z>i`?aM~;sizhh)P5$5-x(XbVwJwDA7cil}pEB1^{>uYnspY9ZD0pRcIw2I{b{OR%0
zkyni*0{(SN3V52-&)Uraf38!g1%R)0TE&tBe$#N3L0X{f$`wdakB5J?WRTyyGc7Gc
z(e+!7F`M^v3bz3CKi6p$OAh)CciKf8@uP5z2p-bsP2Z=_FB#xB?(_oQ0QAys4D6rl
z6lMX~pX{`XB?tSK(V9IocrK44Ug}U+6z9LOWT4-=Gw-!M7_=P&|JOT(T>$>CbXvud
zga7i=mHhOyEr-x~cE4D{!GMY!cs2x_HJ2{cVtd6-9an&E-lZuR{-q1Jm#^U4JOg=W
zCHm2c5E+tpF6y+3C7+D-2TQPb2B;WzK-|4#6R=@t2F<pjfS>3TVgUv0?6is{2YTNK
z!w42;xUU}u_^~Ae_`02F%WE>mZbmzWQ~>P5omLSAc3=-~FI=mExa%gxi9AIo@`h3{
zl$y5ix}2ap>pEqiB>{!<fLlIIySe}1Perh*z5igc(n2T3WQF?$zHi%`B52UQEscy{
z^?jk<sKD0@a^2r+3ttYVZYd7a<S#E3^sw8;_^hGJU^OTLX#ShUL-T!|R`F+aKM*6z
zFQ^IW_KttT^_yY1e{sp+zA=Eiy57dyV+#QPg-)Rspz&{YTE&tBK6*!E80z0yGN=y(
zQ0K*wF<k#vr|=3u{#Tt=vE(2RvlyQ5G`-6Qwwr=(d!{*01|4QGs@WLW`_Oh+xNYBd
zjA8e5T16D>!E!zCUi^vArPQ*~K@~wSUf(JHuorZ+-vCed6nrRCo~NXD`041y;%bi<
zJyY?bOWM&D;$eSurMTB4ksE<{aW4rk?n&T9GxyOxktU9=uDk2mMAgnHPffbjt0Y9C
z4kc|wsanOh5!yFXsAu6D%AT<82k_oUpzY`5dOmLC<0d?8=@v_TkVzln<5&6k2p=EA
z!>+p<#n&`dE2S#-WIbQVO4Y3LZMuoarS9Mt8wq}~wcr<<4Sum%{vvc9m-d5S>`3s7
zJqmuYYyPjgJ3voY^iV)hZM?1FZt@&kjnuwuX$H}}<ro{_<6fNMSlo4$QmK}z&dyAh
z3JvGY=!?7Nl=}6KhIUrx!Z_ykSM!rNpEx}{S;8H4!S6e4gjL4x)$k>Oh(G48%i5U&
z&MnA!qA|AzXRG9NfIe5~Zpc^1?QoencWnw0!wOmW{x%+HxC1HZs70KS^HS=QZck~_
z!O1nwt@9}Qa};MS*5U|VaT=HA)nq6=`e(REZzf+;9l>Drhxkq>3Pufhzc9yBOsTso
zGvzX?bY2Z=cOFA?&i(ky1c;MD(wH;Br@K}Lf1+}t3;?W$)uW8VT=q#oVWvu0c`3t{
zY5aC3<<pEj=|w!|WbyZ$W8;a-HmBtUf7~A<FErrQJPdkXdZu9D3<4S0Q69y>hxFjb
zOX0poaG^US(p>^C(j8u;JG@ADc#-b#qR{(5qh5DcIEsk!=m?0e2LXHKn9#!k@K?>G
z;dRZnb)kV=x|+hx@&a!4IeRrHotl$A%}JN$q(^hop*iW#oOEYSdNU`TnUlWY9!+nq
zSCnT%jX7_Zj`_JOD^P}lz69yjnvkr!4iT8AODgC$3VMBBQ%EC<qIA~ng`H5r*ZBZy
z&mD3Hs%6BnJ3k~rPH=JJrqt<5x>!}m^iEbv=Vx&$2mAx2-3_Ti`gOCZnl8XAHE~u|
zz6bo239`^|SC7gJ)*6pCoL|Lv&WHK<2p=EC<1LNH8k29qU625{>I-^4JLvy{=jn$~
zY**x4xBs|Ikk!2QUklZ~rfR1v8QgO58%S(c<+@W+$U4dUL6iFXxloNpC!<|<x15~C
zG3TOXbn-2rGn^fQ$GtxV0(TAk$AGD5!1=Uv5x>}1-C_LtZT|X#&hxOuT@8Oe&>Kj&
z?yivlGu4K>PS0Y!md6BaJj`g=IIMJcG5_Epb%Yme&iO5%D!D5C1Rr+?5axRjXAyYW
zL~$CEQf1zsqP@q#in0ZL1mTa6;0_!rohuef=`3rms&iWI<`T?)d7PI@NjFkFF9kwc
zOFod&JQ%#!o=P!14z1zH-HNr26N7~eWR7^<`b@EVshPpnIRuW>y~NC$NterD(#*NS
q%#rF+q5SP;KF*(pnv8s`dK9em?l$vdaA#gFDm{v4d7Z6K4*mbaWa|U~

diff --git a/documentation/build/doctrees/examples.doctree b/documentation/build/doctrees/examples.doctree
index e598031f2bc3071889e42f8e699353c8646f60b9..bd9579a5a7e2e1a57c2d5f168e2638638e2043d9 100644
GIT binary patch
delta 74
zcmaDRx>}T_fpzMFjV#<ulU<nfHdipoFmp8a@TC?N<rhs(WEI}Lp7j{BOms#>aSvx+
dVs2_lWkG83l-em7(VfK^ia<JI^F+>2MgX#X8jb(}

delta 119
zcmZ22`b?CifpzNbjV#<u1{}#5nI*{?i6v9orug-+7M13t7K52$U}k(`UP^pYVsds#
z5s=8tOP|ceWXzV~lHr!&vDubMhMBQ_a}?_XW|_o{xZ)npyu{qplF9<05w%k?5<81C
N6oGWy<}l7sMgU%!ED!(y

diff --git a/documentation/build/doctrees/index.doctree b/documentation/build/doctrees/index.doctree
index d562a985a6df7b96b5e3029e7e2bac784305c3b8..6a397c8e9a18e2b4f288528630c7676e3c3732b2 100644
GIT binary patch
delta 686
zcmX@4{zsjqfpzM~jVz@ss*;7JsYR9X1x5MEsl~;adFk;5nFXminR%&G+NSvRuoji(
zq!v#uVX<b(h{=eXyq=|=F=ewpt05y}{p3V8J>HrOwG8GA^$d*+O>eQubJ(&Nr%h&O
zSFo6t!5%v$gR_S%GY@Ro<SCksQ);JZWUyvHqy&37(o^#?^HNePrnF9h$cbev0U9bb
zxsqLzby0>`#{9_#xr~`I)=$pm)SAr3A<a7%YLf&|au!fhMzAzPHDd;n=oFBs1W0re
zP)$F=b$+Eu8IvdXbI5DYguCPd*pc(l_=^$z$u~Kq8E=5x#H^9AZgL~LBG_G5A?|tv
zbeFd5fgX<B{1k{sK=#7iC<(Ox638{Y$ZnLJypdBS6`R{&w)XH^6{V(GB^0M77A0pS
zOaZ$Q?&d5eMg|5{XCs8*E(Z%uj^mPK;Q}g0cYhZ9WP5J;$#=OVSVTb5Kwn57=wX9c
zI0e}cQW;`dEI`G|oUkyKnrzLj&I)$_<SE=1yuC<aUo-h8cLJl><oVokn<IFBGcu-b
z4&i&kY+jjBmSqpLD9Z*&l=g7uCFZ7<R2HNbgA+t$Cs?wxG(!@UKFTt5!0Iw;Hs=ck
GGXenTrR9MD

delta 664
zcmeyPen_3AfpzNkjVz@slNYm?O}@)g&zP_|mer7vv3hbpn;vgPhFS)5hI)oZhNid3
z<Wp=}jFTptvMb0;%3zP3lEK--mYJ86nU^|c@)XU+DYa8HGFUSvO)g}YW?TT&E;V^M
zyC&<r46%&alLfeBCW~;3Gi9uvY{0EG*@Q!ycP7+aF`$BJKm`iCQ;<X^fJ8+4fO6dk
zH~5t%W%N(p%OUSR6>i@duv2EC@#mxQ1$#Jh^HVbOQc^3Xv`&GzRV?EQ$d$|*8LK8c
za4LdbdJ*B$dq9_JOYT9^Sel`l0duwZWF9URxQoSs?mPu@aXmH{!`#xtYgLq*W|dH!
znpl*akuU}9a)eL*q4@;DNB9K77wln!=tuY?i;a<i0TN1+cW{X@g1y554EQW&paj%M
z5{v?qb-DHA_Q3Tcdq)DOm;s^~5f4DYj6Wb>v4VXy`5d<eZzob5RZJG<NnjBvO-h|C
z$RfFU0?%JY#>CBid{3CoOEZeHtbyibSpbRB9?rbP+|-iFg4AMgDk<#*OLmrKNP-eg
QQHBm!T}H*`l|sRc09+5+@&Et;

diff --git a/documentation/build/doctrees/rules.doctree b/documentation/build/doctrees/rules.doctree
index b4f25f6236fef2c84abbed2d9a998e96e28344aa..ad3a03500483af60c483d59f16ae0657ec96b04a 100644
GIT binary patch
delta 552
zcmZXR(MuFj6viEOoY9Q(Wg%RRC8`w_K@xg3tc;C)i5@l?wmUOdzoDHw<LzE{eGv0O
zVd1{WoL+qEPml$pcmELoj)>@vZW{D*`8el0zjOGmxp00~+%N9e?9Pe%+NqzsT|Dc}
zI1Vd5v|bdy=c-Tqmpzu|9sZf%1%!&ZEgaDy?Nc4IcwVf(Uw(r%R56A*EMdOk>JXF0
zkFqq+w1}yog=@Eqi7V2G@l+Nm$@zc1;_&{11I!v%>T<F1xKJ{&DxiAP%yea<60y@(
z;O%S2F*Qx)O17DZ+aZfSDQO?;qGRG_IuTJv$9y{}d6t3}wz%<A){A+rK#fu3MJ!iI
zCM;@vr;{Co)Hf4I;+PAo?hXkz1z+ei<dVnK7%@{SQI?#E&Yty7N!Go+SYr{5VJM!>
zYEy>{56j$YHqS=^nR~+=mb;SWIhVxnIM^UOwf%*FO28{S_)oe`9r7E7@%i5`VkOTG
z)38?bS~bTlzCEiB&Rf5nQJfCGZ(WWpVHGP-*wtoIu#~I4+{RL#wAzR2Yt%};f@$nx
KZSdpcJLeC<rO=N6

literal 25100
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

diff --git a/documentation/build/doctrees/running_WAFL.doctree b/documentation/build/doctrees/running_WAFL.doctree
index a87874aee057a15e6734d09c098bb884a1ca77bf..ad0956421ca4a98ef76842171299bc72306d4e85 100644
GIT binary patch
delta 18
ZcmeBnIIP9mz&h1JbR+9$k;w<-y#YPy2A==`

delta 2324
zcmc(g&x_MQ6vu1aw(g4dvJ~93HuVS8)$GNaCq0Nrpr8mIM3$sG?lhY=C6m;xqE*n7
zqnC^~#hV}qvPaK?S6%StLGWMjB7)$XWRp$XY0`u2_S6io^L_8br!SwDpIyv9%D>Dh
zTlrs$!v>zGN6CP=sI%HZgy`#t`RvSN_JB2T9v5)&Hhfu$4(QU2wre59>#iZkYIl+1
z+O|Tl?YJw9*Wz+&$x{~IESnDx<Z`&;ZxtFt70c#*c=QZt=7`mHk)vCyhGn-l61~vc
zDdnzy$5I@xtLolb+g?ydK2d&VUDyPKzJO3-_+O<ZmCkQ=tP7;4w-BR;dJZDU=_BUh
zvnJ)8h8^N6KIa+8-<FOIY2HG8WHC*mbMBxAKP%q6biH}Cd4<tAj)rMPS|GOPz?JYb
zxM>jFgs<TWKFF`a$F-tonD^i~0z5%HJeb5PkD!l7de2Alzeu%!>N|LXfai$-T2EjM
zhIGa_su9Q;D&yRbJlD{1jeAoE5B%>^sbao@WAiodVi#oC)D(#3TPTkBl?42<c%|w$
zZfIR#@vfrZpcVf^VL3p#&4<_%ls_S90;M8E$(u@bG7~43@n%BDQWoB6ItDhDqfHQN
z@t4oSbzJ9v@;?HGaze+J)gEy%5;3(V&RUSdELp5w7(R=3<^9#}G|a)Z3y__FhjHyv
zaqK9bS`#BXA0ZR##lvUUON0&ddXvzr{Gat|?(`pSJ59hU`7&@3amk2aYP{<*>tbfN
zcxH0bo#fl@hjdu1UD(tt+Ew>gyFSbnZ#%LlD4$G2Db|rUmC*6>#2a{I+lg?3j-L}c
LR{6X9_oDU>5p3xP

diff --git a/documentation/build/doctrees/wafl_init.doctree b/documentation/build/doctrees/wafl_init.doctree
index d90adfbbfdf42301f0f828bb37ac69defbd71dbc..2c38fb3af47609340dea5cb17df4253bc5e5b2d8 100644
GIT binary patch
delta 401
zcmZ1&(B;S4z&iE6+D2Aye#RA(1NrS3xhC@pW(aXj$zYG2lA)*BIHh)qMh0uoa=2tB
z2UtoBNvL@8NB#wq_Y3wh-7B7aP)2(4X%_Cyr9yU$jPE8l3L0&GCd|sn$UM10R%$Yv
zs6GofBLf3aT#L0eLpqCja)ziURPv0dHj6B(q?VWzP*O+Al+`3dI^+N312W1?8Gj~E
zl#<wdNQ{Yz(H?B-eF;q#cVvzBldUB`03~&#EE%mQ*NdqEHEo_K<;lpBi>xejGOtW2
zV<y;qE1+Xip-MsKPm)b$=>;iXBO$@q546UcWg4>H{>lGjgMkttx7h;qcEhaMF1Lk=
z@#*Fq#mCI5`++*L_5g|E9?rbP+|-iFg4AMQkY<4-I*T(Dfy_OdOH_FoCtp+d1^_pE
Bd;b6c

delta 774
zcmb7C&1(}u6z^<zQ)5$;)?~@%quB}#O&cREet^|VylB}H8l&h%WRr|e*3GtbccWE`
z_25C-L*<R25(M$4C*40l^j7pD2wwE$Q3UJNi?bV&nxmIt=Ka2A-kS%d=gY#T@JO6`
zEhu5M0Ojz4M9I))N(#BVbc0S2fxP$6qT{2Wj=mc1VGe<<FbQ@PV&@d1_h?6&B;No<
z=g>5uu_xRQ6CTEr@PQwOSUBc>8OtH`$3@X&2u0vsIsui~AryyYX?AY}4Gh>-B05K)
zDC~#L=z)JswGLYnXP7Z#XL{^_e6^wD!fw9iL2x@TCmbe8Ed(f?6|^9$xjSNlLrZ>a
zR?4CCe(X{=_NyQJO!~}wCEwsEGdR0z06Svb{h63W=$0o%EhwjKzSU(PXY93pHWbq}
z{;5ZhV{z1G(F%IuYuj*Yyu!D;+LKKC*wc>qS0yPjNYW$^pHdn4H5zgAnGFv8c3)0>
zADsNiMA|l6OebilO>C{NVv~(c^MLy%nPA&(_s!%8x<i7_K6Bl)aPvwNo2GgVQ=q*W
z2l{93%%8S(9b2;AFfADybyL34u*iyS$*Nq{RpUBC3_LH}2EMt9YZk7vZNsQz!zy%t
zL!ZZq|264-BJC0fWhuYsAnVHoj`eRVlU@{b+`>9lIEVM%Or4>N#dD>_(i!UT-p!~o
h?F7sfd##2k$=hT`t1u}^l2EswWL(MFRTbW5mA^?Z^-ll*

diff --git a/documentation/build/html/_images/wafl-commands.png b/documentation/build/html/_images/wafl-commands.png
deleted file mode 100644
index 35ef3ef648df0ff635b66fdd037e5497d146037f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 11342
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
E0S3#2FaQ7m

diff --git a/documentation/build/html/_sources/chitchat.rst.txt b/documentation/build/html/_sources/chitchat.rst.txt
deleted file mode 100644
index 88a75170..00000000
--- a/documentation/build/html/_sources/chitchat.rst.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-Chitchat
-======================
-
-WAFL will improvise all conversations unless a rule is triggered.
-This is possible thanks to the LLM it is connected to.
-
-Aspirationally, the system will one day be able to generate its own rules according to the context of the conversation.
-This is not possible yet, but it is not too far off in the future.
diff --git a/documentation/build/html/_sources/directory_structure.rst.txt b/documentation/build/html/_sources/directory_structure.rst.txt
index 40c9b870..37167e75 100644
--- a/documentation/build/html/_sources/directory_structure.rst.txt
+++ b/documentation/build/html/_sources/directory_structure.rst.txt
@@ -39,5 +39,5 @@ Only the rules and facts that are included will be part of the inference.
 For example, the keyword `#using facts` within greetings/ (2) will not include the folder above it.
 Inference in a subfolder is limited the the rules and facts that are part of that folder or below it.
 
-For more information, you can have a look at the (still early) project in
+For more complete example, you can have a look at the (still early) project in
 `wafl_home <https://github.com/fractalego/wafl_home>`_.
\ No newline at end of file
diff --git a/documentation/build/html/_sources/examples.rst.txt b/documentation/build/html/_sources/examples.rst.txt
index 09a47008..802b35dc 100644
--- a/documentation/build/html/_sources/examples.rst.txt
+++ b/documentation/build/html/_sources/examples.rst.txt
@@ -5,7 +5,4 @@ Examples
    :maxdepth: 2
 
    wafl_init
-   chitchat
-   rules
-   rules_and_backtracking
    directory_structure
\ No newline at end of file
diff --git a/documentation/build/html/_sources/index.rst.txt b/documentation/build/html/_sources/index.rst.txt
index b032dffc..d2f4b8bd 100644
--- a/documentation/build/html/_sources/index.rst.txt
+++ b/documentation/build/html/_sources/index.rst.txt
@@ -13,6 +13,8 @@ Welcome to WAFL's 0.0.45 documentation!
    introduction
    installation
    running_WAFL
+   query_processing_pipeline
+   rules
    examples
    license
 
diff --git a/documentation/build/html/_sources/rules.rst.txt b/documentation/build/html/_sources/rules.rst.txt
index eb2aef73..86b1dba4 100644
--- a/documentation/build/html/_sources/rules.rst.txt
+++ b/documentation/build/html/_sources/rules.rst.txt
@@ -1,261 +1,11 @@
 Rules
 =====
 
-The file rules.wafl contains the rules used by the system.
-Each rule is in the following format
+Examples
+========
 
-.. code-block:: text
-
-    Trigger condition
-        action 1
-        action 2
-        action 3
-        ...
-
-Notice that the trigger condition has no indentation, while the actions are indented by any number spaces.
-Each action returns a true or false value.
-If that value is false, the rule stops executing and the next rule is triggered.
-A demo of the rules can be found in the repository `wafl_home <https://github.com/fractalego/wafl_home>`_.
-
-A rule ends when the next rule is encountered (a new trigger condition is found).
-The trigger condition can be a single fact. For example
-
-.. code-block:: text
-
-    This bot's name is "computer"
-
-There are two actors in the system: "the user" and "the bot".
-One simple rule example can be
-
-.. code-block:: text
-
-    The user asks what is this bot's name
-        SAY Hello, my name is Computer
-
-The rule above will be triggered when the user asks what is this bot's name.
-There are 9 types of actions:
-**SAY**,
-**REMEMBER**,
-**RETRIEVE**,
-**asking a question**,
-**generate a text**,
-**item-wise execution**,
-**triggering of another rule**,
-**code execution**,
-**entailment**.
-
-
-SAY command
------------
-
-This command has two uses:
-
-1) This command will make the bot say something. For example the rule above will make the bot say "Hello, my name is computer".
-
-2) This command will append to the return value of a rule. For example consider the following set
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = the user asks about themselves
-      SAY {user_qualities}
-
-    The user asks about themselves
-      SAY The user is tall
-
-
-When the user asks "how am I like", the first rule will be triggered.
-In turn, the first rule will trigger the second one.
-The output of the second rule will fill the value for user_qualities.
-
-At the end of the inference cycle the bot will reply
-
-.. code-block:: text
-
-    bot: The user is tall
-
-REMEMBER command
-----------------
-
-This command will make the bot remember something.
-for example the rule below will make the bot remember the user's name.
-
-.. code-block:: text
-
-    The user says their name is John
-        REMEMBER The user's name is John
-
-RETRIEVE command
-----------------
-
-This command will retrieve a list of elements from memory.
-The retrieved items are selected through embedding similarity
-for example the rule below will retrieve a list of elements and display it.
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = RETRIEVE how is the user like
-      SAY {user_qualities}
-
-
-The output would be the list of all the retrieved items
-
-.. code-block:: text
-
-    bot: [item1, item2, item3, ...]
-
-Asking a question
------------------
-
-Typing a question (with or without question mark) will return a variable.
-This variable can be used later in the rule
-For example the rule below will make the bot ask the user's name.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        REMEMBER The user's name is {name}
-
-Yes/No questions return a truth condition.
-For example by using the rule below, the bot will ask the user if they want to remember their name.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        Do you want to remember the user's name?
-        REMEMBER The user's name is {name}
-
-If the user says "no", the rule will stop executing and the REMEMBER command will never be used
-
-
-Generate a text
-----------------
-
-A text can be generated in a similar fashion as when asking questions
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        italian_name = the italian version of {name} is
-        SAY The italian version of {name} is {italian_name}
-
-The text will be generated by the line "the italian version of {name}" according to the LLM model.
-The only difference with asking question is that the text on the right hand side of `=` is a statement
-and not a question.
-
-
-Item-wise execution
--------------------
-
-A list of items in a `variable` can be executed item-wise through the command `{[variable]}`
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = RETRIEVE how is the user like
-      SAY {[user_qualities]}
-
-
-The output would be the retrieved items line by line
-
-.. code-block:: text
-
-    bot: item1
-    bot: item2
-    bot: item3
-    bot: ...
-
-
-Triggering of another rule
---------------------------
-
-A rule can trigger another rule as follows
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        the name if the user is {name}
-
-    The name of the user is John
-        SAY Hello John!
-
-In this case the second rule is triggered if the user says their name is John.
-
-Code execution
---------------
-
-The code execution is done by using the python syntax.
-A function defined in the file `functions.py` can be called from the rule.
-
-
-For example, the file `rules.wafl` contains the following rule
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        greet({name})
-
-
-and the file `functions.py` contains the following function
-
-.. code-block:: python
-
-    def greet(name):
-        print("Hello", name)
-
-When the user says their name, the bot will greet the user by calling the function greet with the user's name as argument.
-However print() does not activate the SAY command.
-From the `functions.py` file, a rule can be triggered by using the syntax `"% ... %"`
-
-.. code-block:: python
-
-    def greet(name):
-        "% SAY Hello %"
-        f"% SAY your name is {name} %"
-
-The first line will make the bot say "Hello". The second line will make the bot say "your name is John" if the user's name is John.
-
-The syntax `"% ... %"`, can be used to trigger a rule, to generate a text, to ask a question, to remember something, or any other action available in the rules file.
-For example the prior function can be written as follows
-
-.. code-block:: python
-
-    def greet(name):
-        "% SAY Hello %"
-        "% SAY your name is {name} %"
-        date = "% what is the date today? %"
-        "% SAY today is {date} %"
-        while "% Do you want to continue? %":
-            "% SAY I am happy to continue %"
-
-
-*Creating functions on-the-fly*
-
-The system can create a function from a description by including the description within the <...> brackets
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        greet({name}) < print on STDOUT the value of the input argument >
-
-
-Entailment
-----------
-
-The entailment is done by using the :- operator. if RHS entails LHS, then LSH :- RHS is true, otherwise it is false.
-For example the rule below will stop at the second line if the user's name is not John.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        The user's name is John :- The user's name is {name}
-        SAY Your name is John!
+.. toctree::
+   :maxdepth: 2
 
+   writing_the_rules
+   rules_and_backtracking
\ No newline at end of file
diff --git a/documentation/build/html/_sources/running_WAFL.rst.txt b/documentation/build/html/_sources/running_WAFL.rst.txt
index 57424211..7cfc03c0 100644
--- a/documentation/build/html/_sources/running_WAFL.rst.txt
+++ b/documentation/build/html/_sources/running_WAFL.rst.txt
@@ -4,7 +4,7 @@ This document contains a few examples of how to use the `wafl` CLI.
 There are four modes in which to run the system
 
 $ wafl run-audio
---------------
+----------------
 
 It will run the system in a loop, waiting for the user to speak a command.
 The activation word is the name defined in config.json.
@@ -12,21 +12,21 @@ The default name is "computer", but you can change it to whatever you want.
 
 
 $ wafl run-server
----------------
+-----------------
 
 It runs a local web server that listens for HTTP requests on port 8889.
 The server will act as a chatbot, executing commands and returning the result as defined in the rules.
 
 
 $ wafl run-cli
-------------
+--------------
 
 This command works as for the run-server command, but it will listen for commands on the command line.
 It does not run a webserver and is useful for testing purposes.
 
 
 $ wafl run-tests
---------------
+----------------
 
 This command will run all the tests defined in the file testcases.txt.
 
diff --git a/documentation/build/html/_sources/wafl_init.rst.txt b/documentation/build/html/_sources/wafl_init.rst.txt
index c6ca95f6..72fe7386 100644
--- a/documentation/build/html/_sources/wafl_init.rst.txt
+++ b/documentation/build/html/_sources/wafl_init.rst.txt
@@ -39,7 +39,7 @@ It creates a set of files that can be used to the interface side of WAFL.
 
 
 - The rules.wafl file contains the rules that guide the chatbot.
-The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
+  The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
 
 .. code-block:: text
 
diff --git a/documentation/build/html/_static/wafl-commands.png b/documentation/build/html/_static/wafl-commands.png
deleted file mode 100644
index 35ef3ef648df0ff635b66fdd037e5497d146037f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 11342
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
E0S3#2FaQ7m

diff --git a/documentation/build/html/chitchat.html b/documentation/build/html/chitchat.html
deleted file mode 100644
index 61dd5d8e..00000000
--- a/documentation/build/html/chitchat.html
+++ /dev/null
@@ -1,123 +0,0 @@
-<!DOCTYPE html>
-<html class="writer-html5" lang="en" >
-<head>
-  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
-
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Chitchat &mdash; WAFL  documentation</title>
-      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-  <!--[if lt IE 9]>
-    <script src="_static/js/html5shiv.min.js"></script>
-  <![endif]-->
-  
-        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
-        <script src="_static/doctools.js"></script>
-        <script src="_static/sphinx_highlight.js"></script>
-    <script src="_static/js/theme.js"></script>
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Rules" href="rules.html" />
-    <link rel="prev" title="Running wafl init" href="wafl_init.html" /> 
-</head>
-
-<body class="wy-body-for-nav"> 
-  <div class="wy-grid-for-nav">
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
-      <div class="wy-side-scroll">
-        <div class="wy-side-nav-search" >
-
-          
-          
-          <a href="index.html" class="icon icon-home">
-            WAFL
-          </a>
-<div role="search">
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
-    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
-    <input type="hidden" name="check_keywords" value="yes" />
-    <input type="hidden" name="area" value="default" />
-  </form>
-</div>
-        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
-              <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
-<ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
-<li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
-<li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
-</ul>
-
-        </div>
-      </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href="index.html">WAFL</a>
-      </nav>
-
-      <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="Page navigation">
-  <ul class="wy-breadcrumbs">
-      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
-          <li class="breadcrumb-item"><a href="examples.html">Examples</a></li>
-      <li class="breadcrumb-item active">Chitchat</li>
-      <li class="wy-breadcrumbs-aside">
-            <a href="_sources/chitchat.rst.txt" rel="nofollow"> View page source</a>
-      </li>
-  </ul>
-  <hr/>
-</div>
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-           <div itemprop="articleBody">
-             
-  <section id="chitchat">
-<h1>Chitchat<a class="headerlink" href="#chitchat" title="Permalink to this heading"></a></h1>
-<p>WAFL will improvise all conversations unless a rule is triggered.
-This is possible thanks to the LLM it is connected to.</p>
-<p>Aspirationally, the system will one day be able to generate its own rules according to the context of the conversation.
-This is not possible yet, but it is not too far off in the future.</p>
-</section>
-
-
-           </div>
-          </div>
-          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="wafl_init.html" class="btn btn-neutral float-left" title="Running wafl init" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="rules.html" class="btn btn-neutral float-right" title="Rules" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
-    </div>
-
-  <hr/>
-
-  <div role="contentinfo">
-    <p>&#169; Copyright 2023, Alberto Cetoli.</p>
-  </div>
-
-  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
-    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
-    provided by <a href="https://readthedocs.org">Read the Docs</a>.
-   
-
-</footer>
-        </div>
-      </div>
-    </section>
-  </div>
-  <script>
-      jQuery(function () {
-          SphinxRtdTheme.Navigation.enable(true);
-      });
-  </script> 
-
-</body>
-</html>
\ No newline at end of file
diff --git a/documentation/build/html/directory_structure.html b/documentation/build/html/directory_structure.html
index 6674597f..4ea970c3 100644
--- a/documentation/build/html/directory_structure.html
+++ b/documentation/build/html/directory_structure.html
@@ -18,7 +18,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="License" href="license.html" />
-    <link rel="prev" title="Rules and backtracking" href="rules_and_backtracking.html" /> 
+    <link rel="prev" title="Running wafl init" href="wafl_init.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -45,11 +45,11 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Directory structure</a></li>
 </ul>
 </li>
@@ -115,7 +115,7 @@ <h1>Directory structure<a class="headerlink" href="#directory-structure" title="
 Only the rules and facts that are included will be part of the inference.
 For example, the keyword <cite>#using facts</cite> within greetings/ (2) will not include the folder above it.
 Inference in a subfolder is limited the the rules and facts that are part of that folder or below it.</p>
-<p>For more information, you can have a look at the (still early) project in
+<p>For more complete example, you can have a look at the (still early) project in
 <a class="reference external" href="https://github.com/fractalego/wafl_home">wafl_home</a>.</p>
 </section>
 
@@ -123,7 +123,7 @@ <h1>Directory structure<a class="headerlink" href="#directory-structure" title="
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="rules_and_backtracking.html" class="btn btn-neutral float-left" title="Rules and backtracking" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="wafl_init.html" class="btn btn-neutral float-left" title="Running wafl init" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="license.html" class="btn btn-neutral float-right" title="License" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/build/html/examples.html b/documentation/build/html/examples.html
index 61b270f0..2bae854d 100644
--- a/documentation/build/html/examples.html
+++ b/documentation/build/html/examples.html
@@ -18,7 +18,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="Running wafl init" href="wafl_init.html" />
-    <link rel="prev" title="Running WAFL" href="running_WAFL.html" /> 
+    <link rel="prev" title="Rules and backtracking" href="rules_and_backtracking.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -45,11 +45,11 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Examples</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
@@ -85,20 +85,6 @@ <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this head
 <div class="toctree-wrapper compound">
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l1"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#say-command">SAY command</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#remember-command">REMEMBER command</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#retrieve-command">RETRIEVE command</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#asking-a-question">Asking a question</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#generate-a-text">Generate a text</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#item-wise-execution">Item-wise execution</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#code-execution">Code execution</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html#entailment">Entailment</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
 <li class="toctree-l1"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </div>
@@ -108,7 +94,7 @@ <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this head
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="running_WAFL.html" class="btn btn-neutral float-left" title="Running WAFL" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="rules_and_backtracking.html" class="btn btn-neutral float-left" title="Rules and backtracking" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="wafl_init.html" class="btn btn-neutral float-right" title="Running wafl init" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/build/html/genindex.html b/documentation/build/html/genindex.html
index 28c165d6..ffda0e73 100644
--- a/documentation/build/html/genindex.html
+++ b/documentation/build/html/genindex.html
@@ -42,6 +42,9 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
diff --git a/documentation/build/html/index.html b/documentation/build/html/index.html
index 99f24d69..d40ae8ce 100644
--- a/documentation/build/html/index.html
+++ b/documentation/build/html/index.html
@@ -44,6 +44,9 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
@@ -90,22 +93,26 @@ <h1>Welcome to WAFL’s 0.0.45 documentation!<a class="headerlink" href="#welcom
 <li class="toctree-l2"><a class="reference internal" href="running_WAFL.html#wafl-run-tests">$ wafl run-tests</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#say-command">SAY command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#remember-command">REMEMBER command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#retrieve-command">RETRIEVE command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#asking-a-question">Asking a question</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#generate-a-text">Generate a text</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#item-wise-execution">Item-wise execution</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#code-execution">Code execution</a></li>
-<li class="toctree-l3"><a class="reference internal" href="rules.html#entailment">Entailment</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#say-command">SAY command</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#remember-command">REMEMBER command</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#retrieve-command">RETRIEVE command</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#asking-a-question">Asking a question</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#generate-a-text">Generate a text</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#item-wise-execution">Item-wise execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#code-execution">Code execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#entailment">Entailment</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
diff --git a/documentation/build/html/installation.html b/documentation/build/html/installation.html
index 3ec91a15..ad2e7a31 100644
--- a/documentation/build/html/installation.html
+++ b/documentation/build/html/installation.html
@@ -49,6 +49,9 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
diff --git a/documentation/build/html/introduction.html b/documentation/build/html/introduction.html
index 6b3ed08c..0f3342c9 100644
--- a/documentation/build/html/introduction.html
+++ b/documentation/build/html/introduction.html
@@ -45,6 +45,9 @@
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
diff --git a/documentation/build/html/license.html b/documentation/build/html/license.html
index 8ba59ebc..07e6d3b5 100644
--- a/documentation/build/html/license.html
+++ b/documentation/build/html/license.html
@@ -44,6 +44,9 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">License</a></li>
 </ul>
diff --git a/documentation/build/html/objects.inv b/documentation/build/html/objects.inv
index 6c7d4ba3004848f5016f70417fdd5e8a7ac4b8de..e586606e3556fd263eead51c40d4572752652306 100644
GIT binary patch
delta 371
zcmV-(0gV2r1KtCWbbm`u!!Qtr_ddmNfL29<4ZBK!gjA#gi!LMA85#@64)#QCcU*((
zaT4q}ZXD8zO=SO%FV4igB~x>fqOh$(R|t!KXEZn}?@A+Jb`AVOW?oUPV3}O#Tu3e}
zrA0x;9t%gd71UbHsb}m6yiW$442B0@H-Vl3k``MJ{f_NWOMhMBp^GZMMHRwHjp3)T
zWJ9bcW{C|dVQK_2uvtE?e!jjPEar>(%`NzFTcf7#E3Z7o5m#z5wOmhc9TZ<9YfArl
zliHxC+MqBc1!^}MWG}_=DsEV9$}>}Fj<aOM__GHq?B|iW|J2q;s{FA>?avndzig}#
z=$zEMqLB?Mscc7Qy%>tzmtezSL$X=CTN$YnV(T?5W1`@?EVf*HkoAv1_*<DIG6r}L
za?eAx4#y04V2m2{1n89RwlIg>ifTN>sKxMG^w)fcY|r0SA+@BOe-g*=AVZMZ-bxAw
RpbCr0Y$j$tr(f(6b4)}huB`w7

delta 317
zcmV-D0mA;?1E>R#bbn1w#2^&M_nZO`FwL0g#+~saF&UGIE@s&<@NCIYn80hC?!1QA
z^CZ#&Q?Qe`Y2f$&XyKK&5_!vzIuv)paJsstJhH0APSJ<BBSKo>XzWlsv^~e(LY}%H
zhl0l>(6d0`#JZybmlq@!QcrP58qiV;I89c?_Mk>{qQU$!E`P~vi;bCM2a1~xC>pxE
zf8P9jeLK3Y*451|_2#|<jSQvHSH8s|Q)=3kWiwB2or#a3HNqcn5u166&4eh)LA&B2
zBMRnC*pSYM3%76_R!Io<S6{3k-bbeX6Wb2h`p+)Xw*NDq2?YP!xD1Y(X;JSPKcMvw
zshdS);mA6u*EVRb`BLpC+tlNf%Bq>Cf{9G?Bo3J6ZF$VVg84n@Th;*iWFM-QS{6V3
P8J6WErXwc5Fn%Q|6_cWE

diff --git a/documentation/build/html/rules.html b/documentation/build/html/rules.html
index 6fa5418e..48432c97 100644
--- a/documentation/build/html/rules.html
+++ b/documentation/build/html/rules.html
@@ -17,8 +17,8 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Rules and backtracking" href="rules_and_backtracking.html" />
-    <link rel="prev" title="Chitchat" href="chitchat.html" /> 
+    <link rel="next" title="Rules" href="writing_the_rules.html" />
+    <link rel="prev" title="Query processing pipeline" href="query_processing_pipeline.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -45,25 +45,14 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Rules</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="#say-command">SAY command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#remember-command">REMEMBER command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#retrieve-command">RETRIEVE command</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#asking-a-question">Asking a question</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#generate-a-text">Generate a text</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#item-wise-execution">Item-wise execution</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#triggering-of-another-rule">Triggering of another rule</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#code-execution">Code execution</a></li>
-<li class="toctree-l3"><a class="reference internal" href="#entailment">Entailment</a></li>
-</ul>
-</li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="#examples">Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
-<li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
 
@@ -81,7 +70,6 @@
           <div role="navigation" aria-label="Page navigation">
   <ul class="wy-breadcrumbs">
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
-          <li class="breadcrumb-item"><a href="examples.html">Examples</a></li>
       <li class="breadcrumb-item active">Rules</li>
       <li class="wy-breadcrumbs-aside">
             <a href="_sources/rules.rst.txt" rel="nofollow"> View page source</a>
@@ -94,212 +82,34 @@
              
   <section id="rules">
 <h1>Rules<a class="headerlink" href="#rules" title="Permalink to this heading"></a></h1>
-<p>The file rules.wafl contains the rules used by the system.
-Each rule is in the following format</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>Trigger condition
-    action 1
-    action 2
-    action 3
-    ...
-</pre></div>
-</div>
-<p>Notice that the trigger condition has no indentation, while the actions are indented by any number spaces.
-Each action returns a true or false value.
-If that value is false, the rule stops executing and the next rule is triggered.
-A demo of the rules can be found in the repository <a class="reference external" href="https://github.com/fractalego/wafl_home">wafl_home</a>.</p>
-<p>A rule ends when the next rule is encountered (a new trigger condition is found).
-The trigger condition can be a single fact. For example</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>This bot&#39;s name is &quot;computer&quot;
-</pre></div>
-</div>
-<p>There are two actors in the system: “the user” and “the bot”.
-One simple rule example can be</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user asks what is this bot&#39;s name
-    SAY Hello, my name is Computer
-</pre></div>
-</div>
-<p>The rule above will be triggered when the user asks what is this bot’s name.
-There are 9 types of actions:
-<strong>SAY</strong>,
-<strong>REMEMBER</strong>,
-<strong>RETRIEVE</strong>,
-<strong>asking a question</strong>,
-<strong>generate a text</strong>,
-<strong>item-wise execution</strong>,
-<strong>triggering of another rule</strong>,
-<strong>code execution</strong>,
-<strong>entailment</strong>.</p>
-<section id="say-command">
-<h2>SAY command<a class="headerlink" href="#say-command" title="Permalink to this heading"></a></h2>
-<p>This command has two uses:</p>
-<ol class="arabic simple">
-<li><p>This command will make the bot say something. For example the rule above will make the bot say “Hello, my name is computer”.</p></li>
-<li><p>This command will append to the return value of a rule. For example consider the following set</p></li>
-</ol>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
-  user_qualities = the user asks about themselves
-  SAY {user_qualities}
-
-The user asks about themselves
-  SAY The user is tall
-</pre></div>
-</div>
-<p>When the user asks “how am I like”, the first rule will be triggered.
-In turn, the first rule will trigger the second one.
-The output of the second rule will fill the value for user_qualities.</p>
-<p>At the end of the inference cycle the bot will reply</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: The user is tall
-</pre></div>
-</div>
-</section>
-<section id="remember-command">
-<h2>REMEMBER command<a class="headerlink" href="#remember-command" title="Permalink to this heading"></a></h2>
-<p>This command will make the bot remember something.
-for example the rule below will make the bot remember the user’s name.</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name is John
-    REMEMBER The user&#39;s name is John
-</pre></div>
-</div>
-</section>
-<section id="retrieve-command">
-<h2>RETRIEVE command<a class="headerlink" href="#retrieve-command" title="Permalink to this heading"></a></h2>
-<p>This command will retrieve a list of elements from memory.
-The retrieved items are selected through embedding similarity
-for example the rule below will retrieve a list of elements and display it.</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
-  user_qualities = RETRIEVE how is the user like
-  SAY {user_qualities}
-</pre></div>
-</div>
-<p>The output would be the list of all the retrieved items</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: [item1, item2, item3, ...]
-</pre></div>
-</div>
-</section>
-<section id="asking-a-question">
-<h2>Asking a question<a class="headerlink" href="#asking-a-question" title="Permalink to this heading"></a></h2>
-<p>Typing a question (with or without question mark) will return a variable.
-This variable can be used later in the rule
-For example the rule below will make the bot ask the user’s name.</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    REMEMBER The user&#39;s name is {name}
-</pre></div>
-</div>
-<p>Yes/No questions return a truth condition.
-For example by using the rule below, the bot will ask the user if they want to remember their name.</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    Do you want to remember the user&#39;s name?
-    REMEMBER The user&#39;s name is {name}
-</pre></div>
-</div>
-<p>If the user says “no”, the rule will stop executing and the REMEMBER command will never be used</p>
-</section>
-<section id="generate-a-text">
-<h2>Generate a text<a class="headerlink" href="#generate-a-text" title="Permalink to this heading"></a></h2>
-<p>A text can be generated in a similar fashion as when asking questions</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    italian_name = the italian version of {name} is
-    SAY The italian version of {name} is {italian_name}
-</pre></div>
-</div>
-<p>The text will be generated by the line “the italian version of {name}” according to the LLM model.
-The only difference with asking question is that the text on the right hand side of <cite>=</cite> is a statement
-and not a question.</p>
 </section>
-<section id="item-wise-execution">
-<h2>Item-wise execution<a class="headerlink" href="#item-wise-execution" title="Permalink to this heading"></a></h2>
-<p>A list of items in a <cite>variable</cite> can be executed item-wise through the command <cite>{[variable]}</cite></p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>&quot;how is the user like&quot;
-  user_qualities = RETRIEVE how is the user like
-  SAY {[user_qualities]}
-</pre></div>
-</div>
-<p>The output would be the retrieved items line by line</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>bot: item1
-bot: item2
-bot: item3
-bot: ...
-</pre></div>
-</div>
-</section>
-<section id="triggering-of-another-rule">
-<h2>Triggering of another rule<a class="headerlink" href="#triggering-of-another-rule" title="Permalink to this heading"></a></h2>
-<p>A rule can trigger another rule as follows</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    the name if the user is {name}
-
-The name of the user is John
-    SAY Hello John!
-</pre></div>
-</div>
-<p>In this case the second rule is triggered if the user says their name is John.</p>
-</section>
-<section id="code-execution">
-<h2>Code execution<a class="headerlink" href="#code-execution" title="Permalink to this heading"></a></h2>
-<p>The code execution is done by using the python syntax.
-A function defined in the file <cite>functions.py</cite> can be called from the rule.</p>
-<p>For example, the file <cite>rules.wafl</cite> contains the following rule</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    greet({name})
-</pre></div>
-</div>
-<p>and the file <cite>functions.py</cite> contains the following function</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Hello&quot;</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>When the user says their name, the bot will greet the user by calling the function greet with the user’s name as argument.
-However print() does not activate the SAY command.
-From the <cite>functions.py</cite> file, a rule can be triggered by using the syntax <cite>“% … %”</cite></p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-    <span class="s2">&quot;% SAY Hello %&quot;</span>
-    <span class="sa">f</span><span class="s2">&quot;% SAY your name is </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2"> %&quot;</span>
-</pre></div>
-</div>
-<p>The first line will make the bot say “Hello”. The second line will make the bot say “your name is John” if the user’s name is John.</p>
-<p>The syntax <cite>“% … %”</cite>, can be used to trigger a rule, to generate a text, to ask a question, to remember something, or any other action available in the rules file.
-For example the prior function can be written as follows</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-    <span class="s2">&quot;% SAY Hello %&quot;</span>
-    <span class="s2">&quot;% SAY your name is </span><span class="si">{name}</span><span class="s2"> %&quot;</span>
-    <span class="n">date</span> <span class="o">=</span> <span class="s2">&quot;% what is the date today? %&quot;</span>
-    <span class="s2">&quot;% SAY today is </span><span class="si">{date}</span><span class="s2"> %&quot;</span>
-    <span class="k">while</span> <span class="s2">&quot;% Do you want to continue? %&quot;</span><span class="p">:</span>
-        <span class="s2">&quot;% SAY I am happy to continue %&quot;</span>
-</pre></div>
-</div>
-<p><em>Creating functions on-the-fly</em></p>
-<p>The system can create a function from a description by including the description within the &lt;…&gt; brackets</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    greet({name}) &lt; print on STDOUT the value of the input argument &gt;
-</pre></div>
-</div>
-</section>
-<section id="entailment">
-<h2>Entailment<a class="headerlink" href="#entailment" title="Permalink to this heading"></a></h2>
-<p>The entailment is done by using the :- operator. if RHS entails LHS, then LSH :- RHS is true, otherwise it is false.
-For example the rule below will stop at the second line if the user’s name is not John.</p>
-<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says their name
-    name = what is the user&#39;s name?
-    The user&#39;s name is John :- The user&#39;s name is {name}
-    SAY Your name is John!
-</pre></div>
+<section id="examples">
+<h1>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="writing_the_rules.html">Rules</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#say-command">SAY command</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#remember-command">REMEMBER command</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#retrieve-command">RETRIEVE command</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#asking-a-question">Asking a question</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#generate-a-text">Generate a text</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#item-wise-execution">Item-wise execution</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#triggering-of-another-rule">Triggering of another rule</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#code-execution">Code execution</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#entailment">Entailment</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
+</ul>
 </div>
-</section>
 </section>
 
 
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="chitchat.html" class="btn btn-neutral float-left" title="Chitchat" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="rules_and_backtracking.html" class="btn btn-neutral float-right" title="Rules and backtracking" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="query_processing_pipeline.html" class="btn btn-neutral float-left" title="Query processing pipeline" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="writing_the_rules.html" class="btn btn-neutral float-right" title="Rules" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/build/html/rules_and_backtracking.html b/documentation/build/html/rules_and_backtracking.html
index 0d467ddc..f688577f 100644
--- a/documentation/build/html/rules_and_backtracking.html
+++ b/documentation/build/html/rules_and_backtracking.html
@@ -17,8 +17,8 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Directory structure" href="directory_structure.html" />
-    <link rel="prev" title="Rules" href="rules.html" /> 
+    <link rel="next" title="Examples" href="examples.html" />
+    <link rel="prev" title="Rules" href="writing_the_rules.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -45,14 +45,14 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="rules.html#examples">Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Rules and backtracking</a></li>
-<li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
 
@@ -70,7 +70,7 @@
           <div role="navigation" aria-label="Page navigation">
   <ul class="wy-breadcrumbs">
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
-          <li class="breadcrumb-item"><a href="examples.html">Examples</a></li>
+          <li class="breadcrumb-item"><a href="rules.html">Rules</a></li>
       <li class="breadcrumb-item active">Rules and backtracking</li>
       <li class="wy-breadcrumbs-aside">
             <a href="_sources/rules_and_backtracking.rst.txt" rel="nofollow"> View page source</a>
@@ -109,8 +109,8 @@ <h1>Rules and backtracking<a class="headerlink" href="#rules-and-backtracking" t
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="rules.html" class="btn btn-neutral float-left" title="Rules" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="directory_structure.html" class="btn btn-neutral float-right" title="Directory structure" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="writing_the_rules.html" class="btn btn-neutral float-left" title="Rules" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="examples.html" class="btn btn-neutral float-right" title="Examples" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/build/html/running_WAFL.html b/documentation/build/html/running_WAFL.html
index 2efe072e..9184caa7 100644
--- a/documentation/build/html/running_WAFL.html
+++ b/documentation/build/html/running_WAFL.html
@@ -17,7 +17,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Examples" href="examples.html" />
+    <link rel="next" title="Query processing pipeline" href="query_processing_pipeline.html" />
     <link rel="prev" title="Installation" href="installation.html" /> 
 </head>
 
@@ -51,6 +51,9 @@
 <li class="toctree-l2"><a class="reference internal" href="#wafl-run-tests">$ wafl run-tests</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
@@ -110,7 +113,7 @@ <h2>$ wafl run-tests<a class="headerlink" href="#wafl-run-tests" title="Permalin
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="installation.html" class="btn btn-neutral float-left" title="Installation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="examples.html" class="btn btn-neutral float-right" title="Examples" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="query_processing_pipeline.html" class="btn btn-neutral float-right" title="Query processing pipeline" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/build/html/search.html b/documentation/build/html/search.html
index ff00ea0a..4ddfc698 100644
--- a/documentation/build/html/search.html
+++ b/documentation/build/html/search.html
@@ -45,6 +45,9 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
 <li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
 </ul>
diff --git a/documentation/build/html/searchindex.js b/documentation/build/html/searchindex.js
index 49fa82c7..8d33cda2 100644
--- a/documentation/build/html/searchindex.js
+++ b/documentation/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["chitchat", "directory_structure", "examples", "index", "installation", "introduction", "license", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init"], "filenames": ["chitchat.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst"], "titles": ["Chitchat", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init"], "terms": {"wafl": [0, 1, 2, 4, 5, 7], "improvis": 0, "all": [0, 4, 6, 7, 8, 9], "convers": [0, 10], "unless": 0, "rule": [0, 1, 2, 3, 4, 5, 9, 10], "i": [0, 1, 4, 5, 6, 7, 8, 9, 10], "trigger": [0, 2, 3, 8, 10], "thi": [0, 4, 6, 7, 9, 10], "possibl": 0, "thank": 0, "llm": [0, 3, 5, 7, 10], "connect": [0, 6], "aspiration": 0, "system": [0, 4, 7, 9], "one": [0, 1, 7, 8, 10], "dai": 0, "abl": 0, "gener": [0, 2, 3, 10], "its": [0, 5, 8], "own": 0, "accord": [0, 1, 7], "context": 0, "yet": 0, "too": 0, "far": 0, "off": 0, "futur": 0, "consid": [1, 7], "follow": [1, 4, 5, 6, 7], "your": [1, 4, 5, 7], "project": 1, "function": [1, 7, 10], "py": [1, 7, 10], "1": [1, 4, 7, 10], "fact": [1, 7], "greet": [1, 7], "2": [1, 7], "interrupt": [1, 10], "The": [1, 4, 5, 6, 7, 8, 9, 10], "can": [1, 4, 7, 9, 10], "organis": [1, 5], "nest": 1, "each": [1, 7], "must": 1, "contain": [1, 7, 9, 10], "first": [1, 4, 7, 8], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 7, 9, 10], "infer": [1, 5, 7, 8], "within": [1, 7, 8], "file": [1, 4, 6, 7, 9, 10], "syntax": [1, 7], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 7], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 7, 8, 10], "ar": [1, 7, 8, 9, 10], "part": [1, 4], "For": [1, 7, 8, 10], "exampl": [1, 3, 4, 7, 8, 9, 10], "abov": [1, 6, 7], "subfold": 1, "limit": [1, 6], "below": [1, 7, 10], "more": [1, 8], "inform": 1, "you": [1, 4, 7, 8, 9], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 7], "run": [2, 3, 4], "init": [2, 3, 4], "chitchat": [2, 3], "sai": [2, 3, 8, 10], "command": [2, 3, 4, 9, 10], "rememb": [2, 3], "retriev": [2, 3], "ask": [2, 3], "question": [2, 3], "text": [2, 3], "item": [2, 3], "wise": [2, 3], "execut": [2, 3, 8, 9, 10], "anoth": [2, 3], "code": [2, 3], "entail": [2, 3], "backtrack": [2, 3], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 10], "side": [3, 7, 10], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 10], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 7, 8], "version": [4, 5, 7], "built": 4, "two": [4, 7, 8], "both": 4, "same": 4, "machin": [4, 10], "local": [4, 9, 10], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 9], "creat": [4, 5, 7, 10], "config": [4, 9, 10], "json": [4, 9, 10], "edit": 4, "chang": [4, 9], "default": [4, 9], "set": [4, 7, 10], "A": [4, 6, 7, 10], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 7, 8], "from": [4, 6, 7], "last": 4, "larg": [4, 5], "languag": [4, 5, 10], "model": [4, 5, 7, 10], "conveni": 4, "speed": 4, "docker": [4, 10], "imag": [4, 10], "script": [4, 10], "p8080": 4, "8080": [4, 10], "env": 4, "nvidia_disable_requir": 4, "fractalego": [4, 6], "latest": 4, "ha": [4, 7], "fill": [4, 7], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 7], "framework": 5, "home": 5, "assist": 5, "It": [5, 9, 10], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 9], "an": [5, 6, 8], "chain": 5, "thought": 5, "intend": 5, "progress": 5, "current": 5, "user": [5, 7, 8, 9, 10], "while": [5, 7], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 7, 10], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 7], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 9], "deal": 6, "without": [6, 7], "restrict": 6, "right": [6, 7], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 7, 10], "so": [6, 8], "subject": 6, "condit": [6, 7, 8, 10], "notic": [6, 7], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 9], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 10], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 7], "liabil": 6, "whether": 6, "action": [6, 7, 8, 10], "contract": 6, "tort": 6, "otherwis": [6, 7, 8], "aris": 6, "out": 6, "WITH": 6, "format": 7, "3": 7, "indent": 7, "number": 7, "space": 7, "return": [7, 8, 9, 10], "true": [7, 8, 10], "fals": [7, 8], "valu": 7, "If": 7, "stop": 7, "next": [7, 8], "demo": 7, "found": 7, "end": [7, 8], "when": [7, 10], "encount": 7, "new": [7, 8], "singl": 7, "bot": [7, 8], "": [7, 8], "name": [7, 8, 9, 10], "comput": [7, 9, 10], "There": [7, 9], "actor": 7, "One": 7, "simpl": 7, "what": [7, 10], "hello": [7, 10], "my": [7, 8], "9": 7, "type": 7, "make": [7, 8], "someth": 7, "append": 7, "how": [7, 9], "like": 7, "user_qu": 7, "about": 7, "themselv": 7, "tall": 7, "am": [7, 8], "turn": 7, "output": 7, "At": 7, "cycl": 7, "repli": 7, "john": [7, 8], "list": [7, 8, 10], "element": 7, "memori": 7, "select": 7, "through": [7, 8], "embed": 7, "similar": [7, 8], "displai": 7, "would": 7, "item1": 7, "item2": 7, "item3": 7, "mark": 7, "variabl": 7, "later": 7, "ye": 7, "No": 7, "truth": 7, "thei": 7, "want": [7, 9], "never": 7, "fashion": 7, "italian_nam": 7, "italian": 7, "line": [7, 9], "differ": 7, "hand": 7, "statement": 7, "_variable_": [], "_": [], "done": 7, "python": 7, "defin": [7, 9], "call": 7, "def": 7, "print": 7, "argument": 7, "howev": [7, 8], "doe": [7, 9, 10], "activ": [7, 8, 9, 10], "f": 7, "avail": 7, "prior": 7, "written": [7, 10], "date": 7, "todai": 7, "continu": 7, "happi": [7, 8], "oper": 7, "rh": 7, "lh": 7, "lsh": 7, "input": [7, 8], "satisfi": 8, "most": 8, "relev": 8, "go": 8, "fail": 8, "until": 8, "feel": 8, "well": 8, "ok": 8, "jane": 8, "Then": 8, "becaus": 8, "veri": 8, "result": [8, 9], "appli": 8, "recurs": 8, "truncat": 8, "start": [8, 10], "branch": 8, "few": 9, "four": 9, "mode": 9, "main": [], "loop": 9, "wait": 9, "speak": 9, "word": [9, 10], "whatev": 9, "web": 9, "listen": [9, 10], "http": 9, "request": 9, "port": [9, 10], "8889": 9, "act": 9, "chatbot": [9, 10], "webserv": 9, "testcas": [9, 10], "txt": [9, 10], "l": 10, "start_llm": 10, "sh": 10, "configur": 10, "allow_interrupt": 10, "allow": 10, "waking_up_word": 10, "wake": 10, "up": 10, "waking_up_sound": 10, "sound": 10, "woken": 10, "deactivate_sound": 10, "listener_model": 10, "openai": 10, "whisper": 10, "tini": 10, "en": 10, "speech": 10, "recognit": 10, "support": 10, "listener_hotword_logp": 10, "8": 10, "threshold": 10, "log": 10, "probabl": 10, "hotword": 10, "listener_volume_threshold": 10, "0": 10, "6": 10, "volum": 10, "listener_silence_timeout": 10, "7": 10, "silenc": 10, "timeout": 10, "model_host": 10, "127": 10, "host": 10, "model_port": 10, "guid": 10, "top": 10, "bring": 10, "yourself": 10, "onlin": 10, "time": 10, "data": 10, "These": 10, "everi": 10, "minut": 10, "mai": 10, "simpli": 10, "fly": 7, "descript": 7, "bracket": 7, "stdout": 7}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"chitchat": 0, "directori": 1, "structur": 1, "exampl": 2, "welcom": 3, "wafl": [3, 9, 10], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "rule": [7, 8], "sai": 7, "command": 7, "rememb": 7, "retriev": 7, "ask": 7, "question": 7, "gener": 7, "text": 7, "item": 7, "wise": 7, "execut": 7, "trigger": 7, "anoth": 7, "code": 7, "entail": 7, "backtrack": 8, "run": [9, 10], "audio": 9, "server": 9, "cli": 9, "test": 9, "init": 10, "creat": [], "function": [], "fly": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Chitchat": [[0, "chitchat"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Rules and backtracking": [[8, "rules-and-backtracking"]], "Running wafl init": [[10, "running-wafl-init"]], "Rules": [[7, "rules"]], "SAY command": [[7, "say-command"]], "REMEMBER command": [[7, "remember-command"]], "RETRIEVE command": [[7, "retrieve-command"]], "Asking a question": [[7, "asking-a-question"]], "Generate a text": [[7, "generate-a-text"]], "Item-wise execution": [[7, "item-wise-execution"]], "Triggering of another rule": [[7, "triggering-of-another-rule"]], "Code execution": [[7, "code-execution"]], "Entailment": [[7, "entailment"]], "Running WAFL": [[9, "running-wafl"]], "$ wafl run-audio": [[9, "wafl-run-audio"]], "$ wafl run-server": [[9, "wafl-run-server"]], "$ wafl run-cli": [[9, "wafl-run-cli"]], "$ wafl run-tests": [[9, "wafl-run-tests"]]}, "indexentries": {}})
\ No newline at end of file
+Search.setIndex({"docnames": ["automatic_rules_creation", "directory_structure", "examples", "index", "installation", "introduction", "license", "query_processing_pipeline", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init", "writing_the_rules"], "filenames": ["automatic_rules_creation.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "query_processing_pipeline.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst", "writing_the_rules.rst"], "titles": ["Automatic rules creation", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Query processing pipeline", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init", "Rules"], "terms": {"consid": [1, 12], "follow": [1, 4, 5, 6, 7, 12], "your": [1, 4, 5, 12], "project": 1, "function": [1, 11, 12], "py": [1, 11, 12], "wafl": [1, 2, 4, 5, 7, 12], "rule": [1, 3, 4, 5, 7, 10, 11], "1": [1, 4, 11, 12], "fact": [1, 12], "greet": [1, 12], "2": [1, 12], "interrupt": [1, 11], "The": [1, 4, 5, 6, 7, 9, 10, 11, 12], "can": [1, 4, 10, 11, 12], "organis": [1, 5], "nest": 1, "each": [1, 12], "must": 1, "contain": [1, 10, 11, 12], "first": [1, 4, 9, 12], "one": [1, 9, 11, 12], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 10, 11, 12], "infer": [1, 5, 7, 9, 12], "within": [1, 9, 12], "file": [1, 4, 6, 10, 11, 12], "accord": [1, 7, 12], "syntax": [1, 12], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 12], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 9, 11, 12], "ar": [1, 7, 9, 10, 11, 12], "part": [1, 4], "For": [1, 9, 11, 12], "exampl": [1, 3, 4, 9, 10, 11, 12], "abov": [1, 6, 12], "subfold": 1, "i": [1, 4, 5, 6, 7, 9, 10, 11, 12], "limit": [1, 6], "below": [1, 11, 12], "more": [1, 9], "complet": 1, "you": [1, 4, 9, 10, 12], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 12], "run": [2, 3, 4], "init": [2, 3, 4], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 11], "side": [3, 11, 12], "llm": [3, 5, 7, 11, 12], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 11], "queri": 3, "process": 3, "pipelin": 3, "sai": [3, 8, 9, 11], "command": [3, 4, 8, 10, 11], "rememb": [3, 8], "retriev": [3, 8], "ask": [3, 8], "question": [3, 8], "gener": [3, 8, 11], "text": [3, 8], "item": [3, 8], "wise": [3, 8], "execut": [3, 8, 9, 10, 11], "trigger": [3, 8, 9, 11], "anoth": [3, 8], "code": [3, 8], "entail": [3, 8], "backtrack": [3, 8], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 9, 12], "thi": [4, 6, 10, 11, 12], "version": [4, 5, 12], "built": 4, "two": [4, 9, 12], "system": [4, 10, 12], "both": 4, "same": 4, "machin": [4, 11], "local": [4, 10, 11], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 10], "creat": [4, 5, 11, 12], "config": [4, 10, 11], "json": [4, 10, 11], "edit": 4, "chang": [4, 10], "default": [4, 10], "set": [4, 11, 12], "A": [4, 6, 11, 12], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 9, 12], "from": [4, 6, 7, 12], "last": 4, "larg": [4, 5], "languag": [4, 5, 11], "model": [4, 5, 11, 12], "conveni": 4, "speed": 4, "docker": [4, 11], "imag": [4, 11], "script": [4, 11], "p8080": 4, "8080": [4, 11], "env": 4, "nvidia_disable_requir": 4, "all": [4, 6, 9, 10, 12], "fractalego": [4, 6], "latest": 4, "ha": [4, 12], "fill": [4, 12], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 12], "framework": 5, "home": 5, "assist": 5, "It": [5, 10, 11], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 10], "an": [5, 6, 9], "chain": 5, "thought": 5, "intend": 5, "its": [5, 9], "progress": 5, "current": 5, "user": [5, 7, 9, 10, 11, 12], "while": [5, 12], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 11, 12], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 12], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 10], "deal": 6, "without": [6, 12], "restrict": 6, "right": [6, 12], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 11, 12], "so": [6, 9], "subject": 6, "condit": [6, 9, 11, 12], "notic": [6, 12], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 10], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 11], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 12], "liabil": 6, "whether": 6, "action": [6, 9, 11, 12], "contract": 6, "tort": 6, "otherwis": [6, 9, 12], "aris": 6, "out": 6, "connect": 6, "WITH": 6, "try": 7, "answer": 7, "": [7, 9, 12], "diagram": 7, "repli": [7, 12], "flow": 7, "bot": [7, 9, 12], "divid": 7, "three": 7, "main": 7, "branch": [7, 9], "direct": 7, "thei": [7, 12], "written": [7, 11, 12], "creation": 7, "accomplish": 7, "input": [9, 12], "satisfi": 9, "make": [9, 12], "most": 9, "relev": 9, "go": 9, "through": [9, 12], "list": [9, 11, 12], "howev": [9, 12], "fail": 9, "next": [9, 12], "activ": [9, 10, 11, 12], "until": 9, "feel": 9, "well": 9, "name": [9, 10, 11, 12], "john": [9, 12], "happi": [9, 12], "ok": 9, "jane": 9, "my": [9, 12], "am": [9, 12], "return": [9, 10, 11, 12], "fals": [9, 12], "Then": 9, "becaus": 9, "veri": 9, "similar": [9, 12], "end": [9, 12], "result": [9, 10], "appli": 9, "recurs": 9, "true": [9, 11, 12], "truncat": 9, "start": [9, 11], "new": [9, 12], "few": 10, "how": [10, 12], "There": [10, 12], "four": 10, "mode": 10, "loop": 10, "wait": 10, "speak": 10, "word": [10, 11], "defin": [10, 12], "comput": [10, 11, 12], "whatev": 10, "want": [10, 12], "web": 10, "listen": [10, 11], "http": 10, "request": 10, "port": [10, 11], "8889": 10, "act": 10, "chatbot": [10, 11], "line": [10, 12], "doe": [10, 11, 12], "webserv": 10, "testcas": [10, 11], "txt": [10, 11], "what": [11, 12], "l": 11, "start_llm": 11, "sh": 11, "configur": 11, "allow_interrupt": 11, "allow": 11, "convers": 11, "waking_up_word": 11, "wake": 11, "up": 11, "waking_up_sound": 11, "sound": 11, "when": [11, 12], "woken": 11, "deactivate_sound": 11, "listener_model": 11, "openai": 11, "whisper": 11, "tini": 11, "en": 11, "speech": 11, "recognit": 11, "support": 11, "listener_hotword_logp": 11, "8": 11, "threshold": 11, "log": 11, "probabl": 11, "hotword": 11, "listener_volume_threshold": 11, "0": 11, "6": 11, "volum": 11, "listener_silence_timeout": 11, "7": 11, "silenc": 11, "timeout": 11, "model_host": 11, "127": 11, "host": 11, "model_port": 11, "guid": 11, "top": 11, "bring": 11, "yourself": 11, "onlin": 11, "hello": [11, 12], "time": 11, "data": 11, "These": 11, "everi": 11, "minut": 11, "mai": 11, "simpli": 11, "format": 12, "3": 12, "indent": 12, "number": 12, "space": 12, "valu": 12, "If": 12, "stop": 12, "demo": 12, "found": 12, "encount": 12, "singl": 12, "actor": 12, "One": 12, "simpl": 12, "9": 12, "type": 12, "someth": 12, "append": 12, "like": 12, "user_qu": 12, "about": 12, "themselv": 12, "tall": 12, "turn": 12, "output": 12, "At": 12, "cycl": 12, "element": 12, "memori": 12, "select": 12, "embed": 12, "displai": 12, "would": 12, "item1": 12, "item2": 12, "item3": 12, "mark": 12, "variabl": 12, "later": 12, "ye": 12, "No": 12, "truth": 12, "never": 12, "fashion": 12, "italian_nam": 12, "italian": 12, "differ": 12, "hand": 12, "statement": 12, "done": 12, "python": 12, "call": 12, "def": 12, "print": 12, "argument": 12, "f": 12, "avail": 12, "prior": 12, "date": 12, "todai": 12, "continu": 12, "fly": 12, "descript": 12, "bracket": 12, "stdout": 12, "oper": 12, "rh": 12, "lh": 12, "lsh": 12}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"automat": 0, "rule": [0, 8, 9, 12], "creation": 0, "directori": 1, "structur": 1, "exampl": [2, 8], "welcom": 3, "wafl": [3, 10, 11], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "queri": 7, "process": 7, "pipelin": 7, "backtrack": 9, "run": [10, 11], "audio": 10, "server": 10, "cli": 10, "test": 10, "init": 11, "sai": 12, "command": 12, "rememb": 12, "retriev": 12, "ask": 12, "question": 12, "gener": 12, "text": 12, "item": 12, "wise": 12, "execut": 12, "trigger": 12, "anoth": 12, "code": 12, "entail": 12}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Automatic rules creation": [[0, "automatic-rules-creation"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"], [8, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Query processing pipeline": [[7, "query-processing-pipeline"]], "Rules": [[8, "rules"], [12, "rules"]], "Rules and backtracking": [[9, "rules-and-backtracking"]], "Running WAFL": [[10, "running-wafl"]], "$ wafl run-audio": [[10, "wafl-run-audio"]], "$ wafl run-server": [[10, "wafl-run-server"]], "$ wafl run-cli": [[10, "wafl-run-cli"]], "$ wafl run-tests": [[10, "wafl-run-tests"]], "Running wafl init": [[11, "running-wafl-init"]], "SAY command": [[12, "say-command"]], "REMEMBER command": [[12, "remember-command"]], "RETRIEVE command": [[12, "retrieve-command"]], "Asking a question": [[12, "asking-a-question"]], "Generate a text": [[12, "generate-a-text"]], "Item-wise execution": [[12, "item-wise-execution"]], "Triggering of another rule": [[12, "triggering-of-another-rule"]], "Code execution": [[12, "code-execution"]], "Entailment": [[12, "entailment"]]}, "indexentries": {}})
\ No newline at end of file
diff --git a/documentation/build/html/wafl_init.html b/documentation/build/html/wafl_init.html
index e7461419..eb1700fb 100644
--- a/documentation/build/html/wafl_init.html
+++ b/documentation/build/html/wafl_init.html
@@ -17,7 +17,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Chitchat" href="chitchat.html" />
+    <link rel="next" title="Directory structure" href="directory_structure.html" />
     <link rel="prev" title="Examples" href="examples.html" /> 
 </head>
 
@@ -45,11 +45,11 @@
 <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="running_WAFL.html">Running WAFL</a></li>
+<li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
+<li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Running wafl init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="chitchat.html">Chitchat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules.html">Rules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
@@ -116,9 +116,9 @@ <h1>Running wafl init<a class="headerlink" href="#running-wafl-init" title="Perm
 </pre></div>
 </div>
 <ul class="simple">
-<li><p>The rules.wafl file contains the rules that guide the chatbot.</p></li>
+<li><p>The rules.wafl file contains the rules that guide the chatbot.
+The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.</p></li>
 </ul>
-<p>The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.</p>
 <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>The user says &quot;bring yourself online&quot;
   SAY Hello there!
 </pre></div>
@@ -140,7 +140,7 @@ <h1>Running wafl init<a class="headerlink" href="#running-wafl-init" title="Perm
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="examples.html" class="btn btn-neutral float-left" title="Examples" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="chitchat.html" class="btn btn-neutral float-right" title="Chitchat" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="directory_structure.html" class="btn btn-neutral float-right" title="Directory structure" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/source/_static/arbiter.png b/documentation/source/_static/arbiter.png
new file mode 100644
index 0000000000000000000000000000000000000000..eef82e7af75c762e0bf733fd2a595e82b68c37b9
GIT binary patch
literal 44224
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
AZ2$lO

literal 0
HcmV?d00001

diff --git a/documentation/source/_static/wafl-commands.png b/documentation/source/_static/wafl-commands.png
deleted file mode 100644
index 35ef3ef648df0ff635b66fdd037e5497d146037f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 11342
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
E0S3#2FaQ7m

diff --git a/documentation/source/automatic_rules_creation.rst b/documentation/source/automatic_rules_creation.rst
new file mode 100644
index 00000000..4eb3d871
--- /dev/null
+++ b/documentation/source/automatic_rules_creation.rst
@@ -0,0 +1,3 @@
+Automatic rules creation
+========================
+
diff --git a/documentation/source/chitchat.rst b/documentation/source/chitchat.rst
deleted file mode 100644
index 88a75170..00000000
--- a/documentation/source/chitchat.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Chitchat
-======================
-
-WAFL will improvise all conversations unless a rule is triggered.
-This is possible thanks to the LLM it is connected to.
-
-Aspirationally, the system will one day be able to generate its own rules according to the context of the conversation.
-This is not possible yet, but it is not too far off in the future.
diff --git a/documentation/source/examples.rst b/documentation/source/examples.rst
index 09a47008..802b35dc 100644
--- a/documentation/source/examples.rst
+++ b/documentation/source/examples.rst
@@ -5,7 +5,4 @@ Examples
    :maxdepth: 2
 
    wafl_init
-   chitchat
-   rules
-   rules_and_backtracking
    directory_structure
\ No newline at end of file
diff --git a/documentation/source/index.rst b/documentation/source/index.rst
index b032dffc..d2f4b8bd 100644
--- a/documentation/source/index.rst
+++ b/documentation/source/index.rst
@@ -13,6 +13,8 @@ Welcome to WAFL's 0.0.45 documentation!
    introduction
    installation
    running_WAFL
+   query_processing_pipeline
+   rules
    examples
    license
 
diff --git a/documentation/source/query_processing_pipeline.rst b/documentation/source/query_processing_pipeline.rst
new file mode 100644
index 00000000..3497680e
--- /dev/null
+++ b/documentation/source/query_processing_pipeline.rst
@@ -0,0 +1,16 @@
+Query processing pipeline
+=========================
+
+WAFL will try to answer the user's query as in the following diagram
+
+.. image:: _static/arbiter.png
+   :alt: WAFL pipeline
+   :align: center
+
+
+The reply flow from the bot is divided into three main branches:
+
+* Direct reply from the LLM
+* Inference according to the rules as they are written
+* Rule creation if there are no rules to accomplish the user's query
+
diff --git a/documentation/source/rules.rst b/documentation/source/rules.rst
index eb2aef73..86b1dba4 100644
--- a/documentation/source/rules.rst
+++ b/documentation/source/rules.rst
@@ -1,261 +1,11 @@
 Rules
 =====
 
-The file rules.wafl contains the rules used by the system.
-Each rule is in the following format
+Examples
+========
 
-.. code-block:: text
-
-    Trigger condition
-        action 1
-        action 2
-        action 3
-        ...
-
-Notice that the trigger condition has no indentation, while the actions are indented by any number spaces.
-Each action returns a true or false value.
-If that value is false, the rule stops executing and the next rule is triggered.
-A demo of the rules can be found in the repository `wafl_home <https://github.com/fractalego/wafl_home>`_.
-
-A rule ends when the next rule is encountered (a new trigger condition is found).
-The trigger condition can be a single fact. For example
-
-.. code-block:: text
-
-    This bot's name is "computer"
-
-There are two actors in the system: "the user" and "the bot".
-One simple rule example can be
-
-.. code-block:: text
-
-    The user asks what is this bot's name
-        SAY Hello, my name is Computer
-
-The rule above will be triggered when the user asks what is this bot's name.
-There are 9 types of actions:
-**SAY**,
-**REMEMBER**,
-**RETRIEVE**,
-**asking a question**,
-**generate a text**,
-**item-wise execution**,
-**triggering of another rule**,
-**code execution**,
-**entailment**.
-
-
-SAY command
------------
-
-This command has two uses:
-
-1) This command will make the bot say something. For example the rule above will make the bot say "Hello, my name is computer".
-
-2) This command will append to the return value of a rule. For example consider the following set
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = the user asks about themselves
-      SAY {user_qualities}
-
-    The user asks about themselves
-      SAY The user is tall
-
-
-When the user asks "how am I like", the first rule will be triggered.
-In turn, the first rule will trigger the second one.
-The output of the second rule will fill the value for user_qualities.
-
-At the end of the inference cycle the bot will reply
-
-.. code-block:: text
-
-    bot: The user is tall
-
-REMEMBER command
-----------------
-
-This command will make the bot remember something.
-for example the rule below will make the bot remember the user's name.
-
-.. code-block:: text
-
-    The user says their name is John
-        REMEMBER The user's name is John
-
-RETRIEVE command
-----------------
-
-This command will retrieve a list of elements from memory.
-The retrieved items are selected through embedding similarity
-for example the rule below will retrieve a list of elements and display it.
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = RETRIEVE how is the user like
-      SAY {user_qualities}
-
-
-The output would be the list of all the retrieved items
-
-.. code-block:: text
-
-    bot: [item1, item2, item3, ...]
-
-Asking a question
------------------
-
-Typing a question (with or without question mark) will return a variable.
-This variable can be used later in the rule
-For example the rule below will make the bot ask the user's name.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        REMEMBER The user's name is {name}
-
-Yes/No questions return a truth condition.
-For example by using the rule below, the bot will ask the user if they want to remember their name.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        Do you want to remember the user's name?
-        REMEMBER The user's name is {name}
-
-If the user says "no", the rule will stop executing and the REMEMBER command will never be used
-
-
-Generate a text
-----------------
-
-A text can be generated in a similar fashion as when asking questions
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        italian_name = the italian version of {name} is
-        SAY The italian version of {name} is {italian_name}
-
-The text will be generated by the line "the italian version of {name}" according to the LLM model.
-The only difference with asking question is that the text on the right hand side of `=` is a statement
-and not a question.
-
-
-Item-wise execution
--------------------
-
-A list of items in a `variable` can be executed item-wise through the command `{[variable]}`
-
-.. code-block:: text
-
-    "how is the user like"
-      user_qualities = RETRIEVE how is the user like
-      SAY {[user_qualities]}
-
-
-The output would be the retrieved items line by line
-
-.. code-block:: text
-
-    bot: item1
-    bot: item2
-    bot: item3
-    bot: ...
-
-
-Triggering of another rule
---------------------------
-
-A rule can trigger another rule as follows
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        the name if the user is {name}
-
-    The name of the user is John
-        SAY Hello John!
-
-In this case the second rule is triggered if the user says their name is John.
-
-Code execution
---------------
-
-The code execution is done by using the python syntax.
-A function defined in the file `functions.py` can be called from the rule.
-
-
-For example, the file `rules.wafl` contains the following rule
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        greet({name})
-
-
-and the file `functions.py` contains the following function
-
-.. code-block:: python
-
-    def greet(name):
-        print("Hello", name)
-
-When the user says their name, the bot will greet the user by calling the function greet with the user's name as argument.
-However print() does not activate the SAY command.
-From the `functions.py` file, a rule can be triggered by using the syntax `"% ... %"`
-
-.. code-block:: python
-
-    def greet(name):
-        "% SAY Hello %"
-        f"% SAY your name is {name} %"
-
-The first line will make the bot say "Hello". The second line will make the bot say "your name is John" if the user's name is John.
-
-The syntax `"% ... %"`, can be used to trigger a rule, to generate a text, to ask a question, to remember something, or any other action available in the rules file.
-For example the prior function can be written as follows
-
-.. code-block:: python
-
-    def greet(name):
-        "% SAY Hello %"
-        "% SAY your name is {name} %"
-        date = "% what is the date today? %"
-        "% SAY today is {date} %"
-        while "% Do you want to continue? %":
-            "% SAY I am happy to continue %"
-
-
-*Creating functions on-the-fly*
-
-The system can create a function from a description by including the description within the <...> brackets
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        greet({name}) < print on STDOUT the value of the input argument >
-
-
-Entailment
-----------
-
-The entailment is done by using the :- operator. if RHS entails LHS, then LSH :- RHS is true, otherwise it is false.
-For example the rule below will stop at the second line if the user's name is not John.
-
-.. code-block:: text
-
-    The user says their name
-        name = what is the user's name?
-        The user's name is John :- The user's name is {name}
-        SAY Your name is John!
+.. toctree::
+   :maxdepth: 2
 
+   writing_the_rules
+   rules_and_backtracking
\ No newline at end of file
diff --git a/documentation/source/wafl_init.rst b/documentation/source/wafl_init.rst
index c6ca95f6..53dea035 100644
--- a/documentation/source/wafl_init.rst
+++ b/documentation/source/wafl_init.rst
@@ -1,7 +1,7 @@
-Running wafl init
------------------
+Initialization
+--------------
 
-What does this command do?
+This command initialises WAFL's work environment
 
 .. code-block:: bash
 
@@ -39,7 +39,7 @@ It creates a set of files that can be used to the interface side of WAFL.
 
 
 - The rules.wafl file contains the rules that guide the chatbot.
-The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
+  The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
 
 .. code-block:: text
 
diff --git a/documentation/source/writing_the_rules.rst b/documentation/source/writing_the_rules.rst
new file mode 100644
index 00000000..a7ee7ed4
--- /dev/null
+++ b/documentation/source/writing_the_rules.rst
@@ -0,0 +1,261 @@
+Writing the rules
+=================
+
+The file rules.wafl contains the rules used by the system.
+Each rule is in the following format
+
+.. code-block:: text
+
+    Trigger condition
+        action 1
+        action 2
+        action 3
+        ...
+
+Notice that the trigger condition has no indentation, while the actions are indented by any number spaces.
+Each action returns a true or false value.
+If that value is false, the rule stops executing and the next rule is triggered.
+A demo of the rules can be found in the repository `wafl_home <https://github.com/fractalego/wafl_home>`_.
+
+A rule ends when the next rule is encountered (a new trigger condition is found).
+The trigger condition can be a single fact. For example
+
+.. code-block:: text
+
+    This bot's name is "computer"
+
+There are two actors in the system: "the user" and "the bot".
+One simple rule example can be
+
+.. code-block:: text
+
+    The user asks what is this bot's name
+        SAY Hello, my name is Computer
+
+The rule above will be triggered when the user asks what is this bot's name.
+There are 9 types of actions:
+**SAY**,
+**REMEMBER**,
+**RETRIEVE**,
+**asking a question**,
+**generate a text**,
+**item-wise execution**,
+**triggering of another rule**,
+**code execution**,
+**entailment**.
+
+
+SAY command
+-----------
+
+This command has two uses:
+
+1) This command will make the bot say something. For example the rule above will make the bot say "Hello, my name is computer".
+
+2) This command will append to the return value of a rule. For example consider the following set
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = the user asks about themselves
+      SAY {user_qualities}
+
+    The user asks about themselves
+      SAY The user is tall
+
+
+When the user asks "how am I like", the first rule will be triggered.
+In turn, the first rule will trigger the second one.
+The output of the second rule will fill the value for user_qualities.
+
+At the end of the inference cycle the bot will reply
+
+.. code-block:: text
+
+    bot: The user is tall
+
+REMEMBER command
+----------------
+
+This command will make the bot remember something.
+for example the rule below will make the bot remember the user's name.
+
+.. code-block:: text
+
+    The user says their name is John
+        REMEMBER The user's name is John
+
+RETRIEVE command
+----------------
+
+This command will retrieve a list of elements from memory.
+The retrieved items are selected through embedding similarity
+for example the rule below will retrieve a list of elements and display it.
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {user_qualities}
+
+
+The output would be the list of all the retrieved items
+
+.. code-block:: text
+
+    bot: [item1, item2, item3, ...]
+
+Asking a question
+-----------------
+
+Typing a question (with or without question mark) will return a variable.
+This variable can be used later in the rule
+For example the rule below will make the bot ask the user's name.
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        REMEMBER The user's name is {name}
+
+Yes/No questions return a truth condition.
+For example by using the rule below, the bot will ask the user if they want to remember their name.
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        Do you want to remember the user's name?
+        REMEMBER The user's name is {name}
+
+If the user says "no", the rule will stop executing and the REMEMBER command will never be used
+
+
+Generate a text
+----------------
+
+A text can be generated in a similar fashion as when asking questions
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        italian_name = the italian version of {name} is
+        SAY The italian version of {name} is {italian_name}
+
+The text will be generated by the line "the italian version of {name}" according to the LLM model.
+The only difference with asking question is that the text on the right hand side of `=` is a statement
+and not a question.
+
+
+Item-wise execution
+-------------------
+
+A list of items in a `variable` can be executed item-wise through the command `{[variable]}`
+
+.. code-block:: text
+
+    "how is the user like"
+      user_qualities = RETRIEVE how is the user like
+      SAY {[user_qualities]}
+
+
+The output would be the retrieved items line by line
+
+.. code-block:: text
+
+    bot: item1
+    bot: item2
+    bot: item3
+    bot: ...
+
+
+Triggering of another rule
+--------------------------
+
+A rule can trigger another rule as follows
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        the name if the user is {name}
+
+    The name of the user is John
+        SAY Hello John!
+
+In this case the second rule is triggered if the user says their name is John.
+
+Code execution
+--------------
+
+The code execution is done by using the python syntax.
+A function defined in the file `functions.py` can be called from the rule.
+
+
+For example, the file `rules.wafl` contains the following rule
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        greet({name})
+
+
+and the file `functions.py` contains the following function
+
+.. code-block:: python
+
+    def greet(name):
+        print("Hello", name)
+
+When the user says their name, the bot will greet the user by calling the function greet with the user's name as argument.
+However print() does not activate the SAY command.
+From the `functions.py` file, a rule can be triggered by using the syntax `"% ... %"`
+
+.. code-block:: python
+
+    def greet(name):
+        "% SAY Hello %"
+        f"% SAY your name is {name} %"
+
+The first line will make the bot say "Hello". The second line will make the bot say "your name is John" if the user's name is John.
+
+The syntax `"% ... %"`, can be used to trigger a rule, to generate a text, to ask a question, to remember something, or any other action available in the rules file.
+For example the prior function can be written as follows
+
+.. code-block:: python
+
+    def greet(name):
+        "% SAY Hello %"
+        "% SAY your name is {name} %"
+        date = "% what is the date today? %"
+        "% SAY today is {date} %"
+        while "% Do you want to continue? %":
+            "% SAY I am happy to continue %"
+
+
+*Creating functions on-the-fly*
+
+The system can create a function from a description by including the description within the <...> brackets
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        greet({name}) < print on STDOUT the value of the input argument >
+
+
+Entailment
+----------
+
+The entailment is done by using the :- operator. if RHS entails LHS, then LSH :- RHS is true, otherwise it is false.
+For example the rule below will stop at the second line if the user's name is not John.
+
+.. code-block:: text
+
+    The user says their name
+        name = what is the user's name?
+        The user's name is John :- The user's name is {name}
+        SAY Your name is John!
+

From f6a5e482e5fc40d2ca77d3c01160abe4046ed23a Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 18 Aug 2023 18:51:08 +0100
Subject: [PATCH 13/29] created a local connector for the llm

---
 requirements.txt                              |   1 +
 setup.py                                      |   1 +
 tests/config.json                             |  56 +++++++-
 tests/test_connection.py                      |  18 ++-
 wafl/answerer/dialogue_answerer.py            |   4 +-
 wafl/connectors/llm_code_creator_connector.py |   4 +-
 .../llm_generated_answer_connector.py         |   4 +-
 .../llm_prompt_predictor_connector.py         |   4 +-
 wafl/connectors/llm_qa_connector.py           |   4 +-
 wafl/connectors/llm_task_creator_connector.py |   4 +-
 .../llm_task_extractor_connector.py           |   4 +-
 ...=> local_llm_chitchat_answer_connector.py} |   4 +-
 wafl/connectors/local_llm_connector.py        | 134 ++++++++++++++++++
 ... => remote_llm_answer_policy_connector.py} |   4 +-
 .../remote_llm_chitchat_answer_connector.py   |  55 +++++++
 ...m_connector.py => remote_llm_connector.py} |  38 ++---
 wafl/policy/answerer_policy.py                |   4 +-
 17 files changed, 294 insertions(+), 49 deletions(-)
 rename wafl/connectors/{llm_chitchat_answer_connector.py => local_llm_chitchat_answer_connector.py} (92%)
 create mode 100644 wafl/connectors/local_llm_connector.py
 rename wafl/connectors/{llm_answer_policy_connector.py => remote_llm_answer_policy_connector.py} (92%)
 create mode 100644 wafl/connectors/remote_llm_chitchat_answer_connector.py
 rename wafl/connectors/{base_llm_connector.py => remote_llm_connector.py} (99%)

diff --git a/requirements.txt b/requirements.txt
index 7dd80bbe..eaf1d0f0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,3 +20,4 @@ werkzeug==2.1.2
 sphinx==6.1.3
 sphinx-rtd-theme==1.2.0
 bluepy==1.3.0
+einops==0.6.1
\ No newline at end of file
diff --git a/setup.py b/setup.py
index d629aea4..22b4016c 100644
--- a/setup.py
+++ b/setup.py
@@ -56,6 +56,7 @@
         "num2words==0.5.12",
         "word2number==1.1",
         "aiohttp==3.8.4",
+        "einops==0.6.1",
     ],
     classifiers=[
         "License :: OSI Approved :: MIT License",
diff --git a/tests/config.json b/tests/config.json
index 80c0fdc3..e620e217 100644
--- a/tests/config.json
+++ b/tests/config.json
@@ -4,10 +4,54 @@
   "waking_up_sound": true,
   "deactivate_sound": true,
   "improvise_tasks": true,
-  "listener_model": "openai/whisper-tiny.en",
-  "listener_hotword_logp": -8,
-  "listener_volume_threshold": 0.6,
-  "listener_silence_timeout": 0.7,
-  "model_host": "localhost",
-  "model_port": 8080
+  "llm_model": {
+    "model_is_local": true,
+    "local_model": "mosaicml/mpt-7b-instruct",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "listener_model": {
+    "model_is_local": true,
+    "local_model": "fractalego/personal-whisper-medium.en-model",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    },
+    "listener_hotword_logp": -8,
+    "listener_volume_threshold": 0.6,
+    "listener_silence_timeout": 0.7
+  },
+  "speaker_model": {
+    "model_is_local": true,
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "entailment_model": {
+    "model_is_local": true,
+    "local_model": "MoritzLaurer/DeBERTa-v3-base-mnli-fever-anli",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "text_embedding_model": {
+    "model_is_local": true,
+    "local_model": "msmarco-distilbert-base-v3",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "qa_embedding_model": {
+    "model_is_local": true,
+    "local_model": "multi-qa-distilbert-dot-v1",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  }
 }
diff --git a/tests/test_connection.py b/tests/test_connection.py
index becc2401..2c8e6566 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -4,7 +4,8 @@
 from unittest import TestCase
 
 from wafl.config import Configuration
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.local_llm_connector import LocalLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.connectors.llm_qa_connector import LLMQAConnector
 
 _path = os.path.dirname(__file__)
@@ -30,7 +31,7 @@ def test__connection_to_generative_model_hostname_answer_a_question_correctly(se
 
     def test__connection_to_generative_model_can_generate_text(self):
         config = Configuration.load_local_config()
-        connector = BaseLLMConnector(config)
+        connector = RemoteLLMConnector(config)
         prediction = asyncio.run(
             connector.predict(
                 'Generate a full paragraph based on this chapter title "The first contact". '
@@ -41,7 +42,7 @@ def test__connection_to_generative_model_can_generate_text(self):
 
     def test__connection_to_generative_model_can_generate_text_within_tags(self):
         config = Configuration.load_local_config()
-        connector = BaseLLMConnector(config)
+        connector = RemoteLLMConnector(config)
         connector._num_prediction_tokens = 200
         text = 'Generate a full paragraph based on this chapter title " The First Contact". The theme of the paragraph is space opera. Include the characters "Alberto" and "Maria". Write at least three sentences.'
         prompt = f"""
@@ -57,9 +58,18 @@ def test__connection_to_generative_model_can_generate_text_within_tags(self):
 
     def test__connection_to_generative_model_can_generate_a_python_list(self):
         config = Configuration.load_local_config()
-        connector = BaseLLMConnector(config)
+        connector = RemoteLLMConnector(config)
         connector._num_prediction_tokens = 200
         prompt = "Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings: "
         prediction = asyncio.run(connector.predict(prompt))
         print(prediction)
         assert len(prediction) > 0
+
+    def test__local_llm_connector_can_generate_a_python_list(self):
+        config = Configuration.load_local_config()
+        connector = LocalLLMConnector(config)
+        connector._num_prediction_tokens = 200
+        prompt = "Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings: "
+        prediction = asyncio.run(connector.predict(prompt))
+        print(prediction)
+        assert len(prediction) > 0
\ No newline at end of file
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index d8eca599..a8ea1f67 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -1,7 +1,7 @@
 import time
 
 from wafl.answerer.base_answerer import BaseAnswerer
-from wafl.connectors.llm_chitchat_answer_connector import LLMChitChatAnswerConnector
+from wafl.connectors.local_llm_chitchat_answer_connector import RemoteLLMChitChatAnswerConnector
 from wafl.extractors.dataclasses import Query, Answer
 from wafl.inference.utils import cluster_facts
 
@@ -11,7 +11,7 @@ def __init__(self, knowledge, interface, logger):
         self._knowledge = knowledge
         self._logger = logger
         self._interface = interface
-        self._connector = LLMChitChatAnswerConnector()
+        self._connector = RemoteLLMChitChatAnswerConnector()
         self._max_num_past_utterances = 7
 
     async def answer(self, query_text, policy):
diff --git a/wafl/connectors/llm_code_creator_connector.py b/wafl/connectors/llm_code_creator_connector.py
index 56e0d06d..012d0e62 100644
--- a/wafl/connectors/llm_code_creator_connector.py
+++ b/wafl/connectors/llm_code_creator_connector.py
@@ -1,13 +1,13 @@
 import asyncio
 import os
 
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMCodeCreatorConnector(BaseLLMConnector):
+class LLMCodeCreatorConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
         try:
diff --git a/wafl/connectors/llm_generated_answer_connector.py b/wafl/connectors/llm_generated_answer_connector.py
index 1788809d..2b022771 100644
--- a/wafl/connectors/llm_generated_answer_connector.py
+++ b/wafl/connectors/llm_generated_answer_connector.py
@@ -1,7 +1,7 @@
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 
 
-class LLMGeneratedAnswerConnector(BaseLLMConnector):
+class LLMGeneratedAnswerConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
 
diff --git a/wafl/connectors/llm_prompt_predictor_connector.py b/wafl/connectors/llm_prompt_predictor_connector.py
index 8857b244..5ab72eff 100644
--- a/wafl/connectors/llm_prompt_predictor_connector.py
+++ b/wafl/connectors/llm_prompt_predictor_connector.py
@@ -1,7 +1,7 @@
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 
 
-class LLMPromptPredictorConnector(BaseLLMConnector):
+class LLMPromptPredictorConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
 
diff --git a/wafl/connectors/llm_qa_connector.py b/wafl/connectors/llm_qa_connector.py
index 76acb59c..0e7efe5f 100644
--- a/wafl/connectors/llm_qa_connector.py
+++ b/wafl/connectors/llm_qa_connector.py
@@ -1,13 +1,13 @@
 import asyncio
 import os
 
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMQAConnector(BaseLLMConnector):
+class LLMQAConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
         try:
diff --git a/wafl/connectors/llm_task_creator_connector.py b/wafl/connectors/llm_task_creator_connector.py
index 80f425ad..a338ba0a 100644
--- a/wafl/connectors/llm_task_creator_connector.py
+++ b/wafl/connectors/llm_task_creator_connector.py
@@ -1,13 +1,13 @@
 import asyncio
 import os
 
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMTaskCreatorConnector(BaseLLMConnector):
+class LLMTaskCreatorConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
         try:
diff --git a/wafl/connectors/llm_task_extractor_connector.py b/wafl/connectors/llm_task_extractor_connector.py
index 806af3eb..1e643d42 100644
--- a/wafl/connectors/llm_task_extractor_connector.py
+++ b/wafl/connectors/llm_task_extractor_connector.py
@@ -1,13 +1,13 @@
 import asyncio
 import os
 
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMTaskExtractorConnector(BaseLLMConnector):
+class LLMTaskExtractorConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
 
diff --git a/wafl/connectors/llm_chitchat_answer_connector.py b/wafl/connectors/local_llm_chitchat_answer_connector.py
similarity index 92%
rename from wafl/connectors/llm_chitchat_answer_connector.py
rename to wafl/connectors/local_llm_chitchat_answer_connector.py
index bd1e9735..1f39d072 100644
--- a/wafl/connectors/llm_chitchat_answer_connector.py
+++ b/wafl/connectors/local_llm_chitchat_answer_connector.py
@@ -2,13 +2,13 @@
 import os
 import re
 
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.local_llm_connector import LocalLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMChitChatAnswerConnector(BaseLLMConnector):
+class LocalLLMChitChatAnswerConnector(LocalLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
 
diff --git a/wafl/connectors/local_llm_connector.py b/wafl/connectors/local_llm_connector.py
new file mode 100644
index 00000000..ea2414df
--- /dev/null
+++ b/wafl/connectors/local_llm_connector.py
@@ -0,0 +1,134 @@
+import csv
+import joblib
+import os
+import time
+import re
+import torch
+
+from transformers import AutoTokenizer, AutoModelForCausalLM
+from transformers import StoppingCriteria
+
+from wafl.config import Configuration
+from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
+
+device = "cuda" if torch.cuda.is_available() else "cpu"
+
+class LocalLLMConnector:
+    _max_tries = 3
+    _max_reply_length = 500
+    _num_prediction_tokens = 200
+    _cache = {}
+
+    def __init__(self, config=None):
+        if not config:
+            config = Configuration.load_local_config()
+
+        global model, tokenizer
+        model = AutoModelForCausalLM.from_pretrained(
+            config.get_value("llm_model")["local_model"],
+            init_device=device,
+            trust_remote_code=True,
+            torch_dtype=torch.half,
+        )
+        tokenizer = AutoTokenizer.from_pretrained(config.get_value("llm_model")["local_model"])
+
+        self._stop_at_eos = StopAtEOS(tokenizer)
+
+    async def predict(self, prompt: str) -> str:
+        input_ids = tokenizer.encode(
+            prompt, return_tensors="pt", truncation=True, max_length=1008
+        ).to(device)
+        with torch.no_grad():
+            num_beams = 1
+            num_tokens = 200
+            output = model.generate(
+                input_ids,
+                max_new_tokens=num_tokens,
+                num_beams=num_beams,
+                num_return_sequences=1,
+                pad_token_id=tokenizer.eos_token_id,
+                eos_token_id=tokenizer.eos_token_id,
+                use_cache=True,
+                stopping_criteria=[self._stop_at_eos],
+            )
+            output_ids = list(output[0][input_ids.shape[1] :])
+            if tokenizer.eos_token_id in output_ids:
+                output_ids = output_ids[: output_ids.index(tokenizer.eos_token_id)]
+
+            answer = tokenizer.decode(output_ids)
+            answer = re.sub(r"(.*)<\|.*\|>(.*)", r"\1<|EOS|>", answer)
+            answer = re.sub(r"(.*)#", r"\1<|EOS|>", answer)
+
+        return answer
+
+
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        print(__name__)
+        start_time = time.time()
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        if prompt in self._cache:
+            print(time.time() - start_time)
+            return self._cache[prompt]
+
+        text = prompt
+        start = len(text)
+        while (
+            all(
+                item not in text[start:]
+                for item in ["<|EOS|>", "user:", "\nThe bot", "bot:"]
+            )
+            and len(text) < start + self._max_reply_length
+        ):
+            text += await self.predict(text)
+
+        end_set = set()
+        end_set.add(text.find("\nuser:", start))
+        end_set.add(text.find("\nbot:", start))
+        end_set.add(text.find("<|EOS|>", start))
+        end_set.add(text.find("\nThe bot", start))
+        if -1 in end_set:
+            end_set.remove(-1)
+
+        end = len(text)
+        if end_set:
+            end = min(end_set)
+
+        candidate_answer = text[start:end].split("bot: ")[-1].strip()
+        candidate_answer = re.sub(r"(.*)<\|.*\|>", r"\1", candidate_answer).strip()
+
+        if prompt not in self._cache:
+            self._cache[prompt] = candidate_answer
+
+        print(time.time() - start_time)
+        if not candidate_answer:
+            candidate_answer = "unknown"
+
+        return candidate_answer
+
+    async def _get_answer_prompt(self, text, query, dialogue=None):
+        raise NotImplementedError("_get_answer_prompt() needs to be implemented.")
+
+    async def _load_knowledge_from_file(self, filename, _path=None):
+        items_list = []
+        with open(os.path.join(_path, f"../data/{filename}.csv")) as file:
+            csvreader = csv.reader(file)
+            for row in csvreader:
+                items_list.append(row[0].strip())
+
+        knowledge = await SingleFileKnowledge.create_from_list(items_list)
+        joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
+        return knowledge
+
+
+class StopAtEOS(StoppingCriteria):
+    def __init__(self, tokenizer, last_string="<|EOS|>"):
+        self._tokenizer = tokenizer
+        self._last_string = last_string
+
+    def __call__(
+        self, input_ids: torch.LongTensor, scores: torch.FloatTensor, **kwargs
+    ) -> bool:
+        generated_text = self._tokenizer.decode(input_ids[0], skip_special_tokens=True)
+        return generated_text.rfind(self._last_string) == len(generated_text) - len(
+            self._last_string
+        )
\ No newline at end of file
diff --git a/wafl/connectors/llm_answer_policy_connector.py b/wafl/connectors/remote_llm_answer_policy_connector.py
similarity index 92%
rename from wafl/connectors/llm_answer_policy_connector.py
rename to wafl/connectors/remote_llm_answer_policy_connector.py
index 0a319632..135c9bf8 100644
--- a/wafl/connectors/llm_answer_policy_connector.py
+++ b/wafl/connectors/remote_llm_answer_policy_connector.py
@@ -1,7 +1,7 @@
-from wafl.connectors.base_llm_connector import BaseLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 
 
-class LLMAnswerPolicyConnector(BaseLLMConnector):
+class RemoteLLMAnswerPolicyConnector(RemoteLLMConnector):
     def __init__(self, config=None):
         super().__init__(config)
 
diff --git a/wafl/connectors/remote_llm_chitchat_answer_connector.py b/wafl/connectors/remote_llm_chitchat_answer_connector.py
new file mode 100644
index 00000000..b63a5cc1
--- /dev/null
+++ b/wafl/connectors/remote_llm_chitchat_answer_connector.py
@@ -0,0 +1,55 @@
+import asyncio
+import os
+import re
+
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.extractors.dataclasses import Query
+
+_path = os.path.dirname(__file__)
+
+
+class RemoteLLMChitChatAnswerConnector(RemoteLLMConnector):
+    def __init__(self, config=None):
+        super().__init__(config)
+
+        try:
+            loop = asyncio.get_running_loop()
+
+        except RuntimeError:
+            loop = None
+
+        if loop and loop.is_running():
+            self._knowledge = None
+
+        else:
+            self._knowledge = asyncio.run(
+                self._load_knowledge_from_file("dialogues", _path)
+            )
+
+    async def _get_answer_prompt(self, text, query, dialogue=None):
+        if not self._knowledge:
+            self._knowledge = await self._load_knowledge_from_file("dialogues", _path)
+
+        retrieved_dialogues = await self._knowledge.ask_for_facts(
+            Query.create_from_text(dialogue), threshold=0.1
+        )
+        retrieved_dialogues = "\n\n\n".join(
+            [item.text for item in retrieved_dialogues][:3]
+        )
+        dialogue = re.sub(r"bot:(.*)\n", r"bot: \1<|EOS|>\n", dialogue)
+        prompt = f"""
+The user and the bot talk.
+The bot ends every utterance line with <|EOS|>.
+This bot answers are short and to the point. Do not use more than one sentence to reply.
+The bot should not repeat itself. Every reply should be different from the previous ones.
+some examples are as follows:
+
+
+{retrieved_dialogues}
+
+
+In the dialogue below a user is speaking to a bot:
+{dialogue}
+bot:
+        """.strip()
+        return prompt
diff --git a/wafl/connectors/base_llm_connector.py b/wafl/connectors/remote_llm_connector.py
similarity index 99%
rename from wafl/connectors/base_llm_connector.py
rename to wafl/connectors/remote_llm_connector.py
index 93325cdd..79c4db5c 100644
--- a/wafl/connectors/base_llm_connector.py
+++ b/wafl/connectors/remote_llm_connector.py
@@ -10,7 +10,7 @@
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 
 
-class BaseLLMConnector:
+class RemoteLLMConnector:
     _max_tries = 3
     _max_reply_length = 500
     _num_prediction_tokens = 200
@@ -56,24 +56,6 @@ async def predict(self, prompt: str) -> str:
 
         return "UNKNOWN"
 
-    async def check_connection(self):
-        payload = {"data": "test", "num_beams": 1, "num_tokens": 5}
-        try:
-            async with aiohttp.ClientSession(
-                conn_timeout=3, connector=aiohttp.TCPConnector(ssl=False)
-            ) as session:
-                async with session.post(self._server_url, json=payload) as response:
-                    await response.text()
-                    return True
-
-        except aiohttp.client.InvalidURL:
-            print()
-            print("Is the wafl-llm running?")
-            print("Please run 'bash start-llm.sh' (see docs for explanation).")
-            print()
-
-        return False
-
     async def get_answer(self, text: str, dialogue: str, query: str) -> str:
         print(__name__)
         start_time = time.time()
@@ -117,6 +99,24 @@ async def get_answer(self, text: str, dialogue: str, query: str) -> str:
 
         return candidate_answer
 
+    async def check_connection(self):
+        payload = {"data": "test", "num_beams": 1, "num_tokens": 5}
+        try:
+            async with aiohttp.ClientSession(
+                conn_timeout=3, connector=aiohttp.TCPConnector(ssl=False)
+            ) as session:
+                async with session.post(self._server_url, json=payload) as response:
+                    await response.text()
+                    return True
+
+        except aiohttp.client.InvalidURL:
+            print()
+            print("Is the wafl-llm running?")
+            print("Please run 'bash start-llm.sh' (see docs for explanation).")
+            print()
+
+        return False
+
     async def _get_answer_prompt(self, text, query, dialogue=None):
         raise NotImplementedError("_get_answer_prompt() needs to be implemented.")
 
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index 4004dc1b..bc2ca79e 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -1,11 +1,11 @@
-from wafl.connectors.llm_answer_policy_connector import LLMAnswerPolicyConnector
+from wafl.connectors.remote_llm_answer_policy_connector import RemoteLLMAnswerPolicyConnector
 
 
 class AnswerPolicy:
     def __init__(self, interface, logger=None):
         self._interface = interface
         self._logger = logger
-        self._connector = LLMAnswerPolicyConnector()
+        self._connector = RemoteLLMAnswerPolicyConnector()
         self._max_num_past_utterances = 3
 
     async def accept(self, result: str):

From 8003c8b4498b313e80705b8df7fe8b2e039f6e55 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 19 Aug 2023 12:44:05 +0100
Subject: [PATCH 14/29] added a local connector for sentence embedder

---
 requirements.txt                              |  3 +-
 setup.py                                      |  1 +
 tests/test_connection.py                      | 11 ++++++-
 todo.txt                                      |  6 +++-
 wafl/answerer/dialogue_answerer.py            |  2 +-
 ...ector.py => llm_chitchat_answer_bridge.py} | 26 ++++++++++++++---
 wafl/connectors/local_llm_connector.py        | 29 ++++---------------
 .../local_sentence_embedder_connector.py      | 13 +++++++++
 ... => remote_sentence_embedder_connector.py} | 22 +++++---------
 .../sentence_embedder_connector_factory.py    | 12 ++++++++
 wafl/knowledge/single_file_knowledge.py       | 19 +++++++-----
 wafl/policy/answerer_policy.py                |  4 ++-
 wafl/retriever/dense_retriever.py             | 18 +++++++-----
 13 files changed, 104 insertions(+), 62 deletions(-)
 rename wafl/connectors/{local_llm_chitchat_answer_connector.py => llm_chitchat_answer_bridge.py} (61%)
 create mode 100644 wafl/connectors/local_sentence_embedder_connector.py
 rename wafl/connectors/{sentence_embedder_connector.py => remote_sentence_embedder_connector.py} (76%)
 create mode 100644 wafl/connectors/sentence_embedder_connector_factory.py

diff --git a/requirements.txt b/requirements.txt
index eaf1d0f0..92453a69 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,4 +20,5 @@ werkzeug==2.1.2
 sphinx==6.1.3
 sphinx-rtd-theme==1.2.0
 bluepy==1.3.0
-einops==0.6.1
\ No newline at end of file
+einops==0.6.1
+sentence_transformers==2.2.2
\ No newline at end of file
diff --git a/setup.py b/setup.py
index 22b4016c..268a7abc 100644
--- a/setup.py
+++ b/setup.py
@@ -57,6 +57,7 @@
         "word2number==1.1",
         "aiohttp==3.8.4",
         "einops==0.6.1",
+        "sentence_transformers==2.2.2",
     ],
     classifiers=[
         "License :: OSI Approved :: MIT License",
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 2c8e6566..c7c5bc49 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -4,6 +4,7 @@
 from unittest import TestCase
 
 from wafl.config import Configuration
+from wafl.connectors.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
 from wafl.connectors.local_llm_connector import LocalLLMConnector
 from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.connectors.llm_qa_connector import LLMQAConnector
@@ -72,4 +73,12 @@ def test__local_llm_connector_can_generate_a_python_list(self):
         prompt = "Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings: "
         prediction = asyncio.run(connector.predict(prompt))
         print(prediction)
-        assert len(prediction) > 0
\ No newline at end of file
+        assert len(prediction) > 0
+
+    def test__chit_chat_bridge_can_run_locally(self):
+        config = Configuration.load_local_config()
+        connector = LocalLLMConnector(config)
+        dialogue_bridge = LLMChitChatAnswerBridge(connector)
+        answer = asyncio.run(dialogue_bridge.get_answer("", "", "bot: hello"))
+        print(answer)
+        assert len(answer) > 0
diff --git a/todo.txt b/todo.txt
index dfc6b1e1..b2b4b2a4 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,5 +1,9 @@
 ### TODO
 
+* make stand-alone connectors (no need for server-side)
+  * modify config for all connectors
+  * check remote connectors work!
+
 * rewrite documentation
    * talk about how the system will improvises rules
    * explain arbiter pipeline
@@ -13,7 +17,7 @@
   * and docker
 
 * add import from files in rules space
-* make stand-alone connectors (no need for server-side)
+
 
 
 /* split bullet lists into lists for mapping onto a query
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index a8ea1f67..ea1e5fd0 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -1,7 +1,7 @@
 import time
 
 from wafl.answerer.base_answerer import BaseAnswerer
-from wafl.connectors.local_llm_chitchat_answer_connector import RemoteLLMChitChatAnswerConnector
+from wafl.connectors.llm_chitchat_answer_bridge import RemoteLLMChitChatAnswerConnector
 from wafl.extractors.dataclasses import Query, Answer
 from wafl.inference.utils import cluster_facts
 
diff --git a/wafl/connectors/local_llm_chitchat_answer_connector.py b/wafl/connectors/llm_chitchat_answer_bridge.py
similarity index 61%
rename from wafl/connectors/local_llm_chitchat_answer_connector.py
rename to wafl/connectors/llm_chitchat_answer_bridge.py
index 1f39d072..2f3becc2 100644
--- a/wafl/connectors/local_llm_chitchat_answer_connector.py
+++ b/wafl/connectors/llm_chitchat_answer_bridge.py
@@ -1,16 +1,19 @@
 import asyncio
+import csv
+
+import joblib
 import os
 import re
 
-from wafl.connectors.local_llm_connector import LocalLLMConnector
 from wafl.extractors.dataclasses import Query
+from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 
 _path = os.path.dirname(__file__)
 
 
-class LocalLLMChitChatAnswerConnector(LocalLLMConnector):
-    def __init__(self, config=None):
-        super().__init__(config)
+class LLMChitChatAnswerBridge:
+    def __init__(self, llm_connector):
+        self._llm_connector = llm_connector
 
         try:
             loop = asyncio.get_running_loop()
@@ -26,6 +29,10 @@ def __init__(self, config=None):
                 self._load_knowledge_from_file("dialogues", _path)
             )
 
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._llm_connector.generate(prompt)
+
     async def _get_answer_prompt(self, text, query, dialogue=None):
         if not self._knowledge:
             self._knowledge = await self._load_knowledge_from_file("dialogues", _path)
@@ -53,3 +60,14 @@ async def _get_answer_prompt(self, text, query, dialogue=None):
 bot:
         """.strip()
         return prompt
+
+    async def _load_knowledge_from_file(self, filename, _path=None):
+        items_list = []
+        with open(os.path.join(_path, f"../data/{filename}.csv")) as file:
+            csvreader = csv.reader(file)
+            for row in csvreader:
+                items_list.append(row[0].strip())
+
+        knowledge = await SingleFileKnowledge.create_from_list(items_list)
+        joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
+        return knowledge
diff --git a/wafl/connectors/local_llm_connector.py b/wafl/connectors/local_llm_connector.py
index ea2414df..9f6a77bb 100644
--- a/wafl/connectors/local_llm_connector.py
+++ b/wafl/connectors/local_llm_connector.py
@@ -1,6 +1,3 @@
-import csv
-import joblib
-import os
 import time
 import re
 import torch
@@ -9,10 +6,10 @@
 from transformers import StoppingCriteria
 
 from wafl.config import Configuration
-from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 
 device = "cuda" if torch.cuda.is_available() else "cpu"
 
+
 class LocalLLMConnector:
     _max_tries = 3
     _max_reply_length = 500
@@ -30,7 +27,9 @@ def __init__(self, config=None):
             trust_remote_code=True,
             torch_dtype=torch.half,
         )
-        tokenizer = AutoTokenizer.from_pretrained(config.get_value("llm_model")["local_model"])
+        tokenizer = AutoTokenizer.from_pretrained(
+            config.get_value("llm_model")["local_model"]
+        )
 
         self._stop_at_eos = StopAtEOS(tokenizer)
 
@@ -61,11 +60,9 @@ async def predict(self, prompt: str) -> str:
 
         return answer
 
-
-    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+    async def generate(self, prompt: str) -> str:
         print(__name__)
         start_time = time.time()
-        prompt = await self._get_answer_prompt(text, query, dialogue)
         if prompt in self._cache:
             print(time.time() - start_time)
             return self._cache[prompt]
@@ -105,20 +102,6 @@ async def get_answer(self, text: str, dialogue: str, query: str) -> str:
 
         return candidate_answer
 
-    async def _get_answer_prompt(self, text, query, dialogue=None):
-        raise NotImplementedError("_get_answer_prompt() needs to be implemented.")
-
-    async def _load_knowledge_from_file(self, filename, _path=None):
-        items_list = []
-        with open(os.path.join(_path, f"../data/{filename}.csv")) as file:
-            csvreader = csv.reader(file)
-            for row in csvreader:
-                items_list.append(row[0].strip())
-
-        knowledge = await SingleFileKnowledge.create_from_list(items_list)
-        joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
-        return knowledge
-
 
 class StopAtEOS(StoppingCriteria):
     def __init__(self, tokenizer, last_string="<|EOS|>"):
@@ -131,4 +114,4 @@ def __call__(
         generated_text = self._tokenizer.decode(input_ids[0], skip_special_tokens=True)
         return generated_text.rfind(self._last_string) == len(generated_text) - len(
             self._last_string
-        )
\ No newline at end of file
+        )
diff --git a/wafl/connectors/local_sentence_embedder_connector.py b/wafl/connectors/local_sentence_embedder_connector.py
new file mode 100644
index 00000000..ef85e2f3
--- /dev/null
+++ b/wafl/connectors/local_sentence_embedder_connector.py
@@ -0,0 +1,13 @@
+from typing import Dict, List
+from sentence_transformers import SentenceTransformer
+
+
+class LocalSentenceEmbedderConnector:
+    _max_tries = 3
+
+    def __init__(self, model_name):
+        self._model = SentenceTransformer(model_name, device="cuda")
+
+    async def predict(self, text: str) -> Dict[str, List[float]]:
+        vector = self._model.encode(text, show_progress_bar=False)
+        return {"embedding": vector}
diff --git a/wafl/connectors/sentence_embedder_connector.py b/wafl/connectors/remote_sentence_embedder_connector.py
similarity index 76%
rename from wafl/connectors/sentence_embedder_connector.py
rename to wafl/connectors/remote_sentence_embedder_connector.py
index 7db9c91a..b1096f29 100644
--- a/wafl/connectors/sentence_embedder_connector.py
+++ b/wafl/connectors/remote_sentence_embedder_connector.py
@@ -1,25 +1,17 @@
 import aiohttp
 import asyncio
 import json
-
-from typing import Dict, List
-
 import numpy as np
 
-from wafl.config import Configuration
+from typing import Dict, List
 
 
-class SentenceEmbedderConnector:
+class RemoteSentenceEmbedderConnector:
     _max_tries = 3
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
-        self._server_url = (
-            f"https://{config.get_value('model_host')}:"
-            f"{config.get_value('model_port')}/predictions/sentence_embedder"
-        )
+    def __init__(self, host, port, model_name):
+        self._model_name = model_name
+        self._server_url = f"https://{host}:" f"{port}/predictions/sentence_embedder"
         try:
             loop = asyncio.get_running_loop()
 
@@ -31,8 +23,8 @@ def __init__(self, config=None):
         ):
             raise RuntimeError("Cannot connect a running Entailment Model.")
 
-    async def predict(self, text: str, model_name: str) -> Dict[str, List[float]]:
-        payload = {"text": text, "model_name": model_name}
+    async def predict(self, text: str) -> Dict[str, List[float]]:
+        payload = {"text": text, "model_name": self._model_name}
         for _ in range(self._max_tries):
             async with aiohttp.ClientSession(
                 connector=aiohttp.TCPConnector(ssl=False)
diff --git a/wafl/connectors/sentence_embedder_connector_factory.py b/wafl/connectors/sentence_embedder_connector_factory.py
new file mode 100644
index 00000000..86c35e85
--- /dev/null
+++ b/wafl/connectors/sentence_embedder_connector_factory.py
@@ -0,0 +1,12 @@
+from wafl.connectors.local_sentence_embedder_connector import (
+    LocalSentenceEmbedderConnector,
+)
+
+
+class SentenceEmbedderConnectorFactory:
+    @staticmethod
+    def get_connector(model_name, config):
+        if config.get_value(model_name)["model_is_local"]:
+            return LocalSentenceEmbedderConnector(
+                config.get_value(model_name)["local_model"]
+            )
diff --git a/wafl/knowledge/single_file_knowledge.py b/wafl/knowledge/single_file_knowledge.py
index b57bbfe4..7bf09a9f 100644
--- a/wafl/knowledge/single_file_knowledge.py
+++ b/wafl/knowledge/single_file_knowledge.py
@@ -4,6 +4,7 @@
 
 import nltk
 
+from wafl.config import Configuration
 from wafl.facts import Fact
 from wafl.simple_text_processing.normalize import normalized
 from wafl.knowledge.base_knowledge import BaseKnowledge
@@ -38,18 +39,21 @@ class SingleFileKnowledge(BaseKnowledge):
     _threshold_for_partial_facts = 0.48
     _max_rules_per_type = 3
 
-    def __init__(self, rules_text=None, knowledge_name=None, logger=None):
+    def __init__(self, config, rules_text=None, knowledge_name=None, logger=None):
         self._logger = logger
         self._facts_dict = {}
         self._rules_dict = {}
-        self._facts_retriever = DenseRetriever("msmarco-distilbert-base-v3")
+        self._facts_retriever = DenseRetriever("text_embedding_model", config)
         self._facts_retriever_for_questions = DenseRetriever(
-            "multi-qa-distilbert-dot-v1"
+            "qa_embedding_model",
+            config,
         )
         self._entailer = Entailer(logger)
-        self._rules_incomplete_retriever = DenseRetriever("msmarco-distilbert-base-v3")
-        self._rules_fact_retriever = DenseRetriever("msmarco-distilbert-base-v3")
-        self._rules_question_retriever = DenseRetriever("msmarco-distilbert-base-v3")
+        self._rules_incomplete_retriever = DenseRetriever(
+            "text_embedding_model", config
+        )
+        self._rules_fact_retriever = DenseRetriever("text_embedding_model", config)
+        self._rules_question_retriever = DenseRetriever("text_embedding_model", config)
         self._rules_string_retriever = StringRetriever()
         knowledge_name = knowledge_name if knowledge_name else self.root_knowledge
         if rules_text:
@@ -227,7 +231,8 @@ async def _initialize_retrievers(self):
 
     @staticmethod
     async def create_from_list(facts: List[str]) -> "SingleFileKnowledge":
-        knowledge = SingleFileKnowledge()
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config)
         for index, fact in enumerate(facts):
             await knowledge.add(fact)
 
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index bc2ca79e..bd409120 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -1,4 +1,6 @@
-from wafl.connectors.remote_llm_answer_policy_connector import RemoteLLMAnswerPolicyConnector
+from wafl.connectors.remote_llm_answer_policy_connector import (
+    RemoteLLMAnswerPolicyConnector,
+)
 
 
 class AnswerPolicy:
diff --git a/wafl/retriever/dense_retriever.py b/wafl/retriever/dense_retriever.py
index 91054127..31881af1 100644
--- a/wafl/retriever/dense_retriever.py
+++ b/wafl/retriever/dense_retriever.py
@@ -3,8 +3,9 @@
 
 from typing import List, Tuple
 from gensim.models import KeyedVectors
-
-from wafl.connectors.sentence_embedder_connector import SentenceEmbedderConnector
+from wafl.connectors.sentence_embedder_connector_factory import (
+    SentenceEmbedderConnectorFactory,
+)
 from wafl.retriever.base_retriever import BaseRetriever
 
 _path = os.path.dirname(__file__)
@@ -13,9 +14,10 @@
 class DenseRetriever(BaseRetriever):
     _threshold_length = 5
 
-    def __init__(self, model_name):
-        self._connector = SentenceEmbedderConnector()
-        self._model_name = model_name
+    def __init__(self, model_name, config):
+        self._connector = SentenceEmbedderConnectorFactory.get_connector(
+            model_name, config
+        )
         self._embeddings_model = KeyedVectors(768)
 
     async def add_text_and_index(self, text: str, index: str):
@@ -33,11 +35,11 @@ async def get_indices_and_scores_from_text(
         return self._embeddings_model.similar_by_vector(embeddings, topn=5)
 
     async def _get_embeddings_from_text(self, text: str) -> "numpy.array":
-        return (await self._connector.predict(text, self._model_name))["embedding"]
+        return (await self._connector.predict(text))["embedding"]
 
     async def get_dot_product(self, lhs: str, rhs: str) -> float:
-        lhs_vector = (await self._connector.predict(lhs, self._model_name))["embedding"]
-        rhs_vector = (await self._connector.predict(rhs, self._model_name))["embedding"]
+        lhs_vector = (await self._connector.predict(lhs))["embedding"]
+        rhs_vector = (await self._connector.predict(rhs))["embedding"]
         return (
             np.dot(lhs_vector, rhs_vector)
             / np.linalg.norm(lhs_vector)

From 79a730ff598703e6d575eca232ff60a005d3923d Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 19 Aug 2023 17:28:47 +0100
Subject: [PATCH 15/29] added local Whisper connector

---
 tests/local_config.json                       | 57 ++++++++++++++
 tests/test_connection.py                      | 33 +++++++-
 wafl/answerer/dialogue_answerer.py            |  5 +-
 wafl/config.py                                | 11 +++
 wafl/connectors/local_entailment_connector.py | 27 +++++++
 wafl/connectors/local_whisper_connector.py    | 75 +++++++++++++++++++
 ...ctor.py => remote_entailment_connector.py} | 15 ++--
 ...nnector.py => remote_whisper_connector.py} | 17 ++---
 wafl/events/answerer_creator.py               |  4 +-
 wafl/extractors/entailer.py                   |  6 +-
 wafl/listener/whisper_listener.py             |  6 +-
 11 files changed, 218 insertions(+), 38 deletions(-)
 create mode 100644 tests/local_config.json
 create mode 100644 wafl/connectors/local_entailment_connector.py
 create mode 100644 wafl/connectors/local_whisper_connector.py
 rename wafl/connectors/{entailment_connector.py => remote_entailment_connector.py} (87%)
 rename wafl/connectors/{whisper_connector.py => remote_whisper_connector.py} (84%)

diff --git a/tests/local_config.json b/tests/local_config.json
new file mode 100644
index 00000000..e620e217
--- /dev/null
+++ b/tests/local_config.json
@@ -0,0 +1,57 @@
+{
+  "allow_interruptions": true,
+  "waking_up_word": "computer",
+  "waking_up_sound": true,
+  "deactivate_sound": true,
+  "improvise_tasks": true,
+  "llm_model": {
+    "model_is_local": true,
+    "local_model": "mosaicml/mpt-7b-instruct",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "listener_model": {
+    "model_is_local": true,
+    "local_model": "fractalego/personal-whisper-medium.en-model",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    },
+    "listener_hotword_logp": -8,
+    "listener_volume_threshold": 0.6,
+    "listener_silence_timeout": 0.7
+  },
+  "speaker_model": {
+    "model_is_local": true,
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "entailment_model": {
+    "model_is_local": true,
+    "local_model": "MoritzLaurer/DeBERTa-v3-base-mnli-fever-anli",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "text_embedding_model": {
+    "model_is_local": true,
+    "local_model": "msmarco-distilbert-base-v3",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "qa_embedding_model": {
+    "model_is_local": true,
+    "local_model": "multi-qa-distilbert-dot-v1",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  }
+}
diff --git a/tests/test_connection.py b/tests/test_connection.py
index c7c5bc49..4eddcc10 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,13 +1,20 @@
 import asyncio
 import os
+import wave
 
 from unittest import TestCase
 
+import numpy as np
+
 from wafl.config import Configuration
 from wafl.connectors.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
+from wafl.connectors.local_entailment_connector import LocalEntailmentConnector
 from wafl.connectors.local_llm_connector import LocalLLMConnector
+from wafl.connectors.local_whisper_connector import LocalWhisperConnector
 from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.connectors.llm_qa_connector import LLMQAConnector
+from wafl.extractors.entailer import Entailer
+from wafl.listener.whisper_listener import WhisperListener
 
 _path = os.path.dirname(__file__)
 
@@ -67,18 +74,36 @@ def test__connection_to_generative_model_can_generate_a_python_list(self):
         assert len(prediction) > 0
 
     def test__local_llm_connector_can_generate_a_python_list(self):
-        config = Configuration.load_local_config()
+        config = Configuration.load_from_filename("local_config.json")
         connector = LocalLLMConnector(config)
         connector._num_prediction_tokens = 200
         prompt = "Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings: "
         prediction = asyncio.run(connector.predict(prompt))
-        print(prediction)
         assert len(prediction) > 0
 
     def test__chit_chat_bridge_can_run_locally(self):
-        config = Configuration.load_local_config()
+        config = Configuration.load_from_filename("local_config.json")
         connector = LocalLLMConnector(config)
         dialogue_bridge = LLMChitChatAnswerBridge(connector)
         answer = asyncio.run(dialogue_bridge.get_answer("", "", "bot: hello"))
-        print(answer)
         assert len(answer) > 0
+
+    def test__entailment_local_connector(self):
+        premise = "The user says 'hello.'."
+        hypothesis = "The user is greeting"
+        config = Configuration.load_from_filename("local_config.json")
+        connector = LocalEntailmentConnector(config)
+        entailer = Entailer(connector)
+        prediction = asyncio.run(entailer.get_relation(premise, hypothesis))
+        self.assertTrue(prediction["entailment"] > 0.95)
+
+    def test__listener_local_connector(self):
+        config = Configuration.load_from_filename("local_config.json")
+        connector = LocalWhisperConnector(config)
+        listener = WhisperListener(connector)
+        f = wave.open(os.path.join(_path, "data/1002.wav"), "rb")
+        waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
+        result = asyncio.run(listener.input_waveform(waveform))
+        print(result)
+        expected = "DELETE BATTERIES FROM THE GROCERY LIST"
+        assert expected.lower() in result
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index ea1e5fd0..f9e647f1 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -1,17 +1,16 @@
 import time
 
 from wafl.answerer.base_answerer import BaseAnswerer
-from wafl.connectors.llm_chitchat_answer_bridge import RemoteLLMChitChatAnswerConnector
 from wafl.extractors.dataclasses import Query, Answer
 from wafl.inference.utils import cluster_facts
 
 
 class DialogueAnswerer(BaseAnswerer):
-    def __init__(self, knowledge, interface, logger):
+    def __init__(self, knowledge, interface, connector, logger):
         self._knowledge = knowledge
         self._logger = logger
         self._interface = interface
-        self._connector = RemoteLLMChitChatAnswerConnector()
+        self._connector = connector
         self._max_num_past_utterances = 7
 
     async def answer(self, query_text, policy):
diff --git a/wafl/config.py b/wafl/config.py
index b2c31253..2893abef 100644
--- a/wafl/config.py
+++ b/wafl/config.py
@@ -67,3 +67,14 @@ def load_local_config(cls):
                 "Cannot load 'config.json'. Does the file exist in the execution path?"
             )
             exit(0)
+
+    @classmethod
+    def load_from_filename(cls, filename):
+        try:
+            return cls(filename)
+
+        except FileNotFoundError:
+            print(
+                f"Cannot load '{filename}'. Does the file exist in the execution path?"
+            )
+            exit(0)
diff --git a/wafl/connectors/local_entailment_connector.py b/wafl/connectors/local_entailment_connector.py
new file mode 100644
index 00000000..410df63c
--- /dev/null
+++ b/wafl/connectors/local_entailment_connector.py
@@ -0,0 +1,27 @@
+import torch
+
+from transformers import AutoTokenizer
+from transformers import AutoModelForSequenceClassification
+from typing import Dict
+
+device = "cuda" if torch.cuda.is_available() else "cpu"
+
+
+class LocalEntailmentConnector:
+    def __init__(self, config):
+        global model, tokenizer
+        model_name = config.get_value("entailment_model")["local_model"]
+        model = AutoModelForSequenceClassification.from_pretrained(model_name)
+        model.to(device)
+        tokenizer = AutoTokenizer.from_pretrained(model_name)
+        self._cache = {}
+
+    async def predict(self, premise: str, hypothesis: str) -> Dict[str, float]:
+        input_ids = tokenizer(
+            premise, hypothesis, truncation=True, return_tensors="pt"
+        ).input_ids.to(device)
+        output = model(input_ids)
+        prediction = torch.softmax(output["logits"], -1)[0]
+        label_names = ["entailment", "neutral", "contradiction"]
+        answer = {name: float(pred) for pred, name in zip(prediction, label_names)}
+        return answer
diff --git a/wafl/connectors/local_whisper_connector.py b/wafl/connectors/local_whisper_connector.py
new file mode 100644
index 00000000..7bd64403
--- /dev/null
+++ b/wafl/connectors/local_whisper_connector.py
@@ -0,0 +1,75 @@
+from typing import Dict
+
+import torch
+from transformers import WhisperProcessor, WhisperForConditionalGeneration
+
+
+class LocalWhisperConnector:
+    _max_tries = 3
+
+    def __init__(self, config):
+        model_name = config.get_value("listener_model")["local_model"]
+        global model, processor
+        self.model = WhisperForConditionalGeneration.from_pretrained(model_name)
+        self.processor = WhisperProcessor.from_pretrained(model_name)
+        self._starting_tokens = self.processor.tokenizer.convert_tokens_to_ids(
+            ["<|startoftranscript|>", "<|notimestamps|>"]
+        )
+        self._ending_tokens = self.processor.tokenizer.convert_tokens_to_ids(
+            ["<|endoftext|>"]
+        )
+
+    async def predict(self, waveform, hotword=None) -> Dict[str, float]:
+        num_beams = 3
+        num_tokens = 15
+        input_features = self.processor(
+            audio=waveform, return_tensors="pt", sampling_rate=16_000
+        ).input_features
+        hotword_tokens = None
+        if hotword:
+            hotword_tokens = torch.tensor(
+                [
+                    item
+                    for item in self.processor.tokenizer.encode(f" {hotword}")
+                    if item not in set(self._ending_tokens + self._starting_tokens)
+                ],
+                dtype=torch.int,
+            ).unsqueeze(0)
+
+        output = self.model.generate(
+            input_features,
+            num_beams=num_beams,
+            return_dict_in_generate=True,
+            output_scores=True,            max_length=num_tokens,
+        )
+        transcription = self.processor.batch_decode(
+            output.sequences, skip_special_tokens=True
+        )[0]
+        score = output.sequences_scores
+        logp = None
+        if hotword_tokens is not None:
+            logp = self.compute_logp(hotword_tokens, input_features)
+
+        return {
+            "transcription": transcription,
+            "score": score,
+            "logp": logp,
+        }
+
+    def compute_logp(self, hotword_tokens, input_features):
+        input_ids = torch.tensor([self._starting_tokens]).cuda()
+        for _ in range(hotword_tokens.shape[1]):
+            logits = self.model(
+                input_features,
+                decoder_input_ids=input_ids,
+            ).logits
+            new_token = torch.argmax(logits, dim=-1)
+            new_token = torch.tensor([[new_token[:, -1]]]).cuda()
+            input_ids = torch.cat([input_ids, new_token], dim=-1)
+
+        logprobs = torch.log(torch.softmax(logits, dim=-1))
+        sum_logp = 0
+        for logp, index in zip(logprobs[0][1:], hotword_tokens):
+            sum_logp += logp[int(index)]
+
+        return sum_logp
\ No newline at end of file
diff --git a/wafl/connectors/entailment_connector.py b/wafl/connectors/remote_entailment_connector.py
similarity index 87%
rename from wafl/connectors/entailment_connector.py
rename to wafl/connectors/remote_entailment_connector.py
index 751ce07d..207600f0 100644
--- a/wafl/connectors/entailment_connector.py
+++ b/wafl/connectors/remote_entailment_connector.py
@@ -1,22 +1,17 @@
-from typing import Dict
-
 import aiohttp
 import asyncio
 import json
 
-from wafl.config import Configuration
+from typing import Dict
 
 
-class EntailmentConnector:
+class RemoteEntailmentConnector:
     _max_tries = 3
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
+    def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('model_host')}:"
-            f"{config.get_value('model_port')}/predictions/entailment"
+            f"https://{config.get_value('entailment_model')['model_host']}:"
+            f"{config.get_value('entailment_model')['model_port']}/predictions/entailment"
         )
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/connectors/whisper_connector.py b/wafl/connectors/remote_whisper_connector.py
similarity index 84%
rename from wafl/connectors/whisper_connector.py
rename to wafl/connectors/remote_whisper_connector.py
index 2bb823d5..7844c65f 100644
--- a/wafl/connectors/whisper_connector.py
+++ b/wafl/connectors/remote_whisper_connector.py
@@ -1,22 +1,17 @@
-from typing import Dict
-
 import aiohttp
 import asyncio
 import json
 
-from wafl.config import Configuration
+from typing import Dict
 
 
-class WhisperConnector:
+class RemoteWhisperConnector:
     _max_tries = 3
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
+    def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('model_host')}:"
-            f"{config.get_value('model_port')}/predictions/whisper"
+            f"https://{config.get_value('listener_model')['model_host']}:"
+            f"{config.get_value('listener_model')['model_port']}/predictions/whisper"
         )
         try:
             loop = asyncio.get_running_loop()
@@ -27,7 +22,7 @@ def __init__(self, config=None):
         if (not loop or (loop and not loop.is_running())) and not asyncio.run(
             self.check_connection()
         ):
-            raise RuntimeError("Cannot connect a running Entailment Model.")
+            raise RuntimeError("Cannot connect a running Whisper remote model.")
 
     async def predict(self, waveform, hotword=None) -> Dict[str, float]:
         payload = {
diff --git a/wafl/events/answerer_creator.py b/wafl/events/answerer_creator.py
index c167badf..55e0f950 100644
--- a/wafl/events/answerer_creator.py
+++ b/wafl/events/answerer_creator.py
@@ -2,10 +2,10 @@
 from wafl.answerer.list_answerer import ListAnswerer
 
 
-def create_answerer(knowledge, interface, code_path, logger):
+def create_answerer(knowledge, interface, code_path, connector, logger):
     return ListAnswerer(
         [
-            ArbiterAnswerer.create_answerer(knowledge, interface, code_path, logger),
+            ArbiterAnswerer.create_answerer(knowledge, interface, code_path, connector, logger),
         ],
         interface,
         logger,
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index f039c710..0bbaca84 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -1,12 +1,10 @@
-import functools
 from typing import Dict, Union
-from wafl.connectors.entailment_connector import EntailmentConnector
 
 
 class Entailer:
-    def __init__(self, logger=None):
+    def __init__(self, connector, logger=None):
         self._logger = logger
-        self._connector = EntailmentConnector()
+        self._connector = connector
         self._cache = {}
 
     async def get_relation(self, premise: str, hypothesis: str) -> Dict[str, float]:
diff --git a/wafl/listener/whisper_listener.py b/wafl/listener/whisper_listener.py
index d8c1b825..783dd331 100644
--- a/wafl/listener/whisper_listener.py
+++ b/wafl/listener/whisper_listener.py
@@ -6,8 +6,6 @@
 import numpy as np
 import torch.cuda
 
-from wafl.connectors.whisper_connector import WhisperConnector
-
 device = "cuda" if torch.cuda.is_available() else "cpu"
 
 
@@ -21,14 +19,14 @@ class WhisperListener:
     _starting_tokens = [50257, 50362]
     _ending_tokens = [50256]
 
-    def __init__(self):
+    def __init__(self, connector):
         self._p = pyaudio.PyAudio()
         self._volume_threshold = 1
         self._original_volume_threshold = self._volume_threshold
         self._timeout = 1
         self._max_timeout = 4
         self._hotword_threshold = -8
-        self._connector = WhisperConnector()
+        self._connector = connector
         self._hotwords = list()
         self.is_active = False
         self._last_waveform = None

From a91f81c234a0cfc7d68d9705c000da3cc3663383 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 19 Aug 2023 17:54:09 +0100
Subject: [PATCH 16/29] added speaker local connector. It does not work yet
 with python 3.11

---
 requirements.txt                              |  3 +-
 setup.py                                      |  1 +
 tests/test_connection.py                      |  9 +++++
 todo.txt                                      |  3 +-
 wafl/connectors/local_llm_connector.py        |  1 -
 .../local_sentence_embedder_connector.py      |  7 ++--
 wafl/connectors/local_speaker_connector.py    | 34 +++++++++++++++++++
 wafl/connectors/local_whisper_connector.py    | 15 ++++----
 ...nnector.py => remote_speaker_connector.py} | 14 +++-----
 wafl/events/answerer_creator.py               |  4 ++-
 wafl/speaker/fairseq_speaker.py               |  5 ++-
 11 files changed, 72 insertions(+), 24 deletions(-)
 create mode 100644 wafl/connectors/local_speaker_connector.py
 rename wafl/connectors/{speaker_connector.py => remote_speaker_connector.py} (81%)

diff --git a/requirements.txt b/requirements.txt
index 92453a69..55913fd0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -21,4 +21,5 @@ sphinx==6.1.3
 sphinx-rtd-theme==1.2.0
 bluepy==1.3.0
 einops==0.6.1
-sentence_transformers==2.2.2
\ No newline at end of file
+sentence_transformers==2.2.2
+fairseq==0.12.2
\ No newline at end of file
diff --git a/setup.py b/setup.py
index 268a7abc..0a321f0b 100644
--- a/setup.py
+++ b/setup.py
@@ -58,6 +58,7 @@
         "aiohttp==3.8.4",
         "einops==0.6.1",
         "sentence_transformers==2.2.2",
+        "fairseq==0.12.2",
     ],
     classifiers=[
         "License :: OSI Approved :: MIT License",
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 4eddcc10..d7ef7428 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -10,11 +10,13 @@
 from wafl.connectors.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
 from wafl.connectors.local_entailment_connector import LocalEntailmentConnector
 from wafl.connectors.local_llm_connector import LocalLLMConnector
+from wafl.connectors.local_speaker_connector import LocalSpeakerConnector
 from wafl.connectors.local_whisper_connector import LocalWhisperConnector
 from wafl.connectors.remote_llm_connector import RemoteLLMConnector
 from wafl.connectors.llm_qa_connector import LLMQAConnector
 from wafl.extractors.entailer import Entailer
 from wafl.listener.whisper_listener import WhisperListener
+from wafl.speaker.fairseq_speaker import FairSeqSpeaker
 
 _path = os.path.dirname(__file__)
 
@@ -107,3 +109,10 @@ def test__listener_local_connector(self):
         print(result)
         expected = "DELETE BATTERIES FROM THE GROCERY LIST"
         assert expected.lower() in result
+
+    def test__speaker_local_connector(self):
+        config = Configuration.load_from_filename("local_config.json")
+        connector = LocalSpeakerConnector(config)
+        speaker = FairSeqSpeaker(connector)
+        text = "Hello world"
+        asyncio.run(speaker.speak(text))
diff --git a/todo.txt b/todo.txt
index b2b4b2a4..166382d3 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,8 +1,9 @@
 ### TODO
 
 * make stand-alone connectors (no need for server-side)
-  * modify config for all connectors
+  /* modify config for all connectors
   * check remote connectors work!
+  * create note about local speaker for python 3.11
 
 * rewrite documentation
    * talk about how the system will improvises rules
diff --git a/wafl/connectors/local_llm_connector.py b/wafl/connectors/local_llm_connector.py
index 9f6a77bb..5d03ade8 100644
--- a/wafl/connectors/local_llm_connector.py
+++ b/wafl/connectors/local_llm_connector.py
@@ -4,7 +4,6 @@
 
 from transformers import AutoTokenizer, AutoModelForCausalLM
 from transformers import StoppingCriteria
-
 from wafl.config import Configuration
 
 device = "cuda" if torch.cuda.is_available() else "cpu"
diff --git a/wafl/connectors/local_sentence_embedder_connector.py b/wafl/connectors/local_sentence_embedder_connector.py
index ef85e2f3..6b6b6878 100644
--- a/wafl/connectors/local_sentence_embedder_connector.py
+++ b/wafl/connectors/local_sentence_embedder_connector.py
@@ -1,12 +1,15 @@
-from typing import Dict, List
+import torch.cuda
 from sentence_transformers import SentenceTransformer
+from typing import Dict, List
+
+_device = "cuda" if torch.cuda.is_available() else "cpu"
 
 
 class LocalSentenceEmbedderConnector:
     _max_tries = 3
 
     def __init__(self, model_name):
-        self._model = SentenceTransformer(model_name, device="cuda")
+        self._model = SentenceTransformer(model_name, device=_device)
 
     async def predict(self, text: str) -> Dict[str, List[float]]:
         vector = self._model.encode(text, show_progress_bar=False)
diff --git a/wafl/connectors/local_speaker_connector.py b/wafl/connectors/local_speaker_connector.py
new file mode 100644
index 00000000..9651f32a
--- /dev/null
+++ b/wafl/connectors/local_speaker_connector.py
@@ -0,0 +1,34 @@
+import torch
+
+from typing import Dict
+from fairseq.checkpoint_utils import load_model_ensemble_and_task_from_hf_hub
+from fairseq.models.text_to_speech.hub_interface import TTSHubInterface
+
+_device = "cuda" if torch.cuda.is_available() else "cpu"
+
+
+class LocalSpeakerConnector:
+    def __init__(self, config):
+        model_name = config.get_value("listener_model")["speaker_model"]
+        global model
+        models, cfg, self._task = load_model_ensemble_and_task_from_hf_hub(
+            model_name,
+            arg_overrides={"vocoder": "hifigan", "fp16": False},
+        )
+        self._model = models[0]
+        TTSHubInterface.update_cfg_with_data_cfg(cfg, self._task.data_cfg)
+        self._generator = self._task.build_generator(models, cfg)
+        self._generator.model.to(_device)
+        self._generator.vocoder.model.to(_device)
+
+    async def predict(self, text: str) -> Dict[str, float]:
+        sample = TTSHubInterface.get_model_input(self._task, text)
+        sample["net_input"]["src_tokens"] = sample["net_input"]["src_tokens"].to(
+            _device
+        )
+        with torch.no_grad():
+            wav, rate = TTSHubInterface.get_prediction(
+                self._task, self._model, self._generator, sample
+            )
+
+        return {"wav": wav, "rate": rate}
diff --git a/wafl/connectors/local_whisper_connector.py b/wafl/connectors/local_whisper_connector.py
index 7bd64403..ed6eef85 100644
--- a/wafl/connectors/local_whisper_connector.py
+++ b/wafl/connectors/local_whisper_connector.py
@@ -1,7 +1,8 @@
-from typing import Dict
-
 import torch
 from transformers import WhisperProcessor, WhisperForConditionalGeneration
+from typing import Dict
+
+_device = "cuda" if torch.cuda.is_available() else "cpu"
 
 
 class LocalWhisperConnector:
@@ -11,6 +12,7 @@ def __init__(self, config):
         model_name = config.get_value("listener_model")["local_model"]
         global model, processor
         self.model = WhisperForConditionalGeneration.from_pretrained(model_name)
+        self.model.to(_device)
         self.processor = WhisperProcessor.from_pretrained(model_name)
         self._starting_tokens = self.processor.tokenizer.convert_tokens_to_ids(
             ["<|startoftranscript|>", "<|notimestamps|>"]
@@ -37,10 +39,11 @@ async def predict(self, waveform, hotword=None) -> Dict[str, float]:
             ).unsqueeze(0)
 
         output = self.model.generate(
-            input_features,
+            input_features.to(_device),
             num_beams=num_beams,
             return_dict_in_generate=True,
-            output_scores=True,            max_length=num_tokens,
+            output_scores=True,
+            max_length=num_tokens,
         )
         transcription = self.processor.batch_decode(
             output.sequences, skip_special_tokens=True
@@ -60,7 +63,7 @@ def compute_logp(self, hotword_tokens, input_features):
         input_ids = torch.tensor([self._starting_tokens]).cuda()
         for _ in range(hotword_tokens.shape[1]):
             logits = self.model(
-                input_features,
+                input_features.to(_device),
                 decoder_input_ids=input_ids,
             ).logits
             new_token = torch.argmax(logits, dim=-1)
@@ -72,4 +75,4 @@ def compute_logp(self, hotword_tokens, input_features):
         for logp, index in zip(logprobs[0][1:], hotword_tokens):
             sum_logp += logp[int(index)]
 
-        return sum_logp
\ No newline at end of file
+        return sum_logp
diff --git a/wafl/connectors/speaker_connector.py b/wafl/connectors/remote_speaker_connector.py
similarity index 81%
rename from wafl/connectors/speaker_connector.py
rename to wafl/connectors/remote_speaker_connector.py
index b56d12ab..82cda28a 100644
--- a/wafl/connectors/speaker_connector.py
+++ b/wafl/connectors/remote_speaker_connector.py
@@ -4,19 +4,15 @@
 import json
 
 from typing import Dict
-from wafl.config import Configuration
 
 
-class SpeakerConnector:
+class RemoteSpeakerConnector:
     _max_tries = 3
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
+    def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('model_host')}:"
-            f"{config.get_value('model_port')}/predictions/speaker"
+            f"https://{config.get_value('listener_model')['model_host']}:"
+            f"{config.get_value('listener_model')['model_port']}/predictions/speaker"
         )
         try:
             loop = asyncio.get_running_loop()
@@ -27,7 +23,7 @@ def __init__(self, config=None):
         if (not loop or (loop and not loop.is_running())) and not asyncio.run(
             self.check_connection()
         ):
-            raise RuntimeError("Cannot connect a running Entailment Model.")
+            raise RuntimeError("Cannot connect a running Speaker Model.")
 
     async def predict(self, text: str) -> Dict[str, float]:
         payload = {"text": text}
diff --git a/wafl/events/answerer_creator.py b/wafl/events/answerer_creator.py
index 55e0f950..aa212cad 100644
--- a/wafl/events/answerer_creator.py
+++ b/wafl/events/answerer_creator.py
@@ -5,7 +5,9 @@
 def create_answerer(knowledge, interface, code_path, connector, logger):
     return ListAnswerer(
         [
-            ArbiterAnswerer.create_answerer(knowledge, interface, code_path, connector, logger),
+            ArbiterAnswerer.create_answerer(
+                knowledge, interface, code_path, connector, logger
+            ),
         ],
         interface,
         logger,
diff --git a/wafl/speaker/fairseq_speaker.py b/wafl/speaker/fairseq_speaker.py
index 62efbad7..4bddb34e 100644
--- a/wafl/speaker/fairseq_speaker.py
+++ b/wafl/speaker/fairseq_speaker.py
@@ -1,14 +1,13 @@
 import asyncio
 import pyaudio
 
-from wafl.connectors.speaker_connector import SpeakerConnector
 from wafl.speaker.base_speaker import BaseSpeaker
 from wafl.speaker.utils import convert_numbers_to_words
 
 
 class FairSeqSpeaker(BaseSpeaker):
-    def __init__(self):
-        self._connector = SpeakerConnector()
+    def __init__(self, connector):
+        self._connector = connector
         self._p = pyaudio.PyAudio()
 
     async def speak(self, text):

From bebdd1b254723b4deef3502e8200ffe744fa343f Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sun, 20 Aug 2023 15:37:08 +0100
Subject: [PATCH 17/29] refactored to implement connector factories

---
 requirements.txt                                |  3 ++-
 setup.py                                        |  1 +
 tests/config.json                               | 13 +++++++------
 tests/local_config.json                         |  1 +
 tests/test_commonsense_entailment.py            |  5 ++++-
 tests/test_connection.py                        | 15 +++++----------
 wafl/answerer/arbiter_answerer.py               | 17 ++++++++++++-----
 wafl/answerer/dialogue_answerer.py              |  5 +++--
 wafl/answerer/inference_answerer.py             |  8 ++++----
 wafl/connectors/entailment_connector_factory.py | 11 +++++++++++
 wafl/connectors/llm_chitchat_answer_bridge.py   |  8 +++++---
 wafl/connectors/llm_connector_factory.py        | 11 +++++++++++
 .../llm_prompt_predictor_connector.py           |  2 +-
 wafl/connectors/llm_qa_connector.py             |  2 +-
 wafl/connectors/local_entailment_connector.py   |  2 +-
 wafl/connectors/local_llm_connector.py          | 11 +++--------
 wafl/connectors/local_speaker_connector.py      |  2 +-
 wafl/connectors/local_whisper_connector.py      |  2 +-
 wafl/connectors/remote_entailment_connector.py  |  4 ++--
 wafl/connectors/remote_llm_connector.py         | 12 ++++--------
 .../remote_sentence_embedder_connector.py       |  6 +++++-
 wafl/connectors/remote_whisper_connector.py     |  4 ++--
 .../sentence_embedder_connector_factory.py      |  5 +++++
 wafl/connectors/speaker_connector_factory.py    | 11 +++++++++++
 wafl/connectors/whisper_connector_factory.py    | 11 +++++++++++
 wafl/events/answerer_creator.py                 |  4 ++--
 wafl/events/conversation_events.py              | 16 ++++++++--------
 wafl/extractors/code_creator.py                 |  4 ++--
 wafl/extractors/entailer.py                     |  6 ++++--
 wafl/extractors/extractor.py                    |  6 +++---
 wafl/extractors/prompt_predictor.py             |  4 ++--
 wafl/extractors/task_creator.py                 |  4 ++--
 wafl/extractors/task_extractor.py               |  4 ++--
 wafl/inference/backward_inference.py            | 16 ++++++++++------
 wafl/knowledge/single_file_knowledge.py         | 10 +++++++---
 wafl/listener/whisper_listener.py               |  6 ++++--
 wafl/policy/answerer_policy.py                  |  4 ++--
 wafl/speaker/fairseq_speaker.py                 |  8 +++++---
 38 files changed, 167 insertions(+), 97 deletions(-)
 create mode 100644 wafl/connectors/entailment_connector_factory.py
 create mode 100644 wafl/connectors/llm_connector_factory.py
 create mode 100644 wafl/connectors/speaker_connector_factory.py
 create mode 100644 wafl/connectors/whisper_connector_factory.py

diff --git a/requirements.txt b/requirements.txt
index 55913fd0..060ef80b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -22,4 +22,5 @@ sphinx-rtd-theme==1.2.0
 bluepy==1.3.0
 einops==0.6.1
 sentence_transformers==2.2.2
-fairseq==0.12.2
\ No newline at end of file
+fairseq==0.12.2
+g2p-en==2.1.0
\ No newline at end of file
diff --git a/setup.py b/setup.py
index 0a321f0b..ae65ce72 100644
--- a/setup.py
+++ b/setup.py
@@ -59,6 +59,7 @@
         "einops==0.6.1",
         "sentence_transformers==2.2.2",
         "fairseq==0.12.2",
+        "g2p-en==2.1.0",
     ],
     classifiers=[
         "License :: OSI Approved :: MIT License",
diff --git a/tests/config.json b/tests/config.json
index e620e217..37358326 100644
--- a/tests/config.json
+++ b/tests/config.json
@@ -5,7 +5,7 @@
   "deactivate_sound": true,
   "improvise_tasks": true,
   "llm_model": {
-    "model_is_local": true,
+    "model_is_local": false,
     "local_model": "mosaicml/mpt-7b-instruct",
     "remote_model": {
       "model_host": "localhost",
@@ -13,7 +13,7 @@
     }
   },
   "listener_model": {
-    "model_is_local": true,
+    "model_is_local": false,
     "local_model": "fractalego/personal-whisper-medium.en-model",
     "remote_model": {
       "model_host": "localhost",
@@ -24,14 +24,15 @@
     "listener_silence_timeout": 0.7
   },
   "speaker_model": {
-    "model_is_local": true,
+    "model_is_local": false,
+    "local_model": "facebook/fastspeech2-en-ljspeech",
     "remote_model": {
       "model_host": "localhost",
       "model_port": 8080
     }
   },
   "entailment_model": {
-    "model_is_local": true,
+    "model_is_local": false,
     "local_model": "MoritzLaurer/DeBERTa-v3-base-mnli-fever-anli",
     "remote_model": {
       "model_host": "localhost",
@@ -39,7 +40,7 @@
     }
   },
   "text_embedding_model": {
-    "model_is_local": true,
+    "model_is_local": false,
     "local_model": "msmarco-distilbert-base-v3",
     "remote_model": {
       "model_host": "localhost",
@@ -47,7 +48,7 @@
     }
   },
   "qa_embedding_model": {
-    "model_is_local": true,
+    "model_is_local": false,
     "local_model": "multi-qa-distilbert-dot-v1",
     "remote_model": {
       "model_host": "localhost",
diff --git a/tests/local_config.json b/tests/local_config.json
index e620e217..d7548499 100644
--- a/tests/local_config.json
+++ b/tests/local_config.json
@@ -25,6 +25,7 @@
   },
   "speaker_model": {
     "model_is_local": true,
+    "local_model": "facebook/fastspeech2-en-ljspeech",
     "remote_model": {
       "model_host": "localhost",
       "model_port": 8080
diff --git a/tests/test_commonsense_entailment.py b/tests/test_commonsense_entailment.py
index c83f3c9d..68a5208a 100644
--- a/tests/test_commonsense_entailment.py
+++ b/tests/test_commonsense_entailment.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
@@ -25,8 +27,9 @@ def test__sentences_can_filter_items_positive(self):
                 "Please add apples to the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_connection.py b/tests/test_connection.py
index d7ef7428..ad8c84d4 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -77,7 +77,7 @@ def test__connection_to_generative_model_can_generate_a_python_list(self):
 
     def test__local_llm_connector_can_generate_a_python_list(self):
         config = Configuration.load_from_filename("local_config.json")
-        connector = LocalLLMConnector(config)
+        connector = LocalLLMConnector(config.get_value("llm_model"))
         connector._num_prediction_tokens = 200
         prompt = "Generate a Python list of 4 chapters names for a space opera book. The output needs to be a python list of strings: "
         prediction = asyncio.run(connector.predict(prompt))
@@ -85,8 +85,7 @@ def test__local_llm_connector_can_generate_a_python_list(self):
 
     def test__chit_chat_bridge_can_run_locally(self):
         config = Configuration.load_from_filename("local_config.json")
-        connector = LocalLLMConnector(config)
-        dialogue_bridge = LLMChitChatAnswerBridge(connector)
+        dialogue_bridge = LLMChitChatAnswerBridge(config)
         answer = asyncio.run(dialogue_bridge.get_answer("", "", "bot: hello"))
         assert len(answer) > 0
 
@@ -94,25 +93,21 @@ def test__entailment_local_connector(self):
         premise = "The user says 'hello.'."
         hypothesis = "The user is greeting"
         config = Configuration.load_from_filename("local_config.json")
-        connector = LocalEntailmentConnector(config)
-        entailer = Entailer(connector)
+        entailer = Entailer(config)
         prediction = asyncio.run(entailer.get_relation(premise, hypothesis))
         self.assertTrue(prediction["entailment"] > 0.95)
 
     def test__listener_local_connector(self):
         config = Configuration.load_from_filename("local_config.json")
-        connector = LocalWhisperConnector(config)
-        listener = WhisperListener(connector)
+        listener = WhisperListener(config)
         f = wave.open(os.path.join(_path, "data/1002.wav"), "rb")
         waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
         result = asyncio.run(listener.input_waveform(waveform))
-        print(result)
         expected = "DELETE BATTERIES FROM THE GROCERY LIST"
         assert expected.lower() in result
 
     def test__speaker_local_connector(self):
         config = Configuration.load_from_filename("local_config.json")
-        connector = LocalSpeakerConnector(config)
-        speaker = FairSeqSpeaker(connector)
+        speaker = FairSeqSpeaker(config)
         text = "Hello world"
         asyncio.run(speaker.speak(text))
diff --git a/wafl/answerer/arbiter_answerer.py b/wafl/answerer/arbiter_answerer.py
index ce83742c..808b3ae3 100644
--- a/wafl/answerer/arbiter_answerer.py
+++ b/wafl/answerer/arbiter_answerer.py
@@ -11,14 +11,14 @@
 
 
 class ArbiterAnswerer(BaseAnswerer):
-    def __init__(self, answerers_dict, knowledge, interface, logger):
+    def __init__(self, config, answerers_dict, knowledge, interface, logger):
         self._answerers_dict = answerers_dict
         self._narrator = Narrator(interface)
         self._interface = interface
         self._logger = logger
-        self._entailer = Entailer(logger)
+        self._entailer = Entailer(config, logger)
         self._knowledge = knowledge
-        self._task_extractor = TaskExtractor(interface)
+        self._task_extractor = TaskExtractor(config, interface)
         self._config = Configuration.load_local_config()
 
     async def answer(self, query_text, policy):
@@ -67,16 +67,19 @@ async def answer(self, query_text, policy):
         return Answer(text="Unknown")
 
     @staticmethod
-    def create_answerer(knowledge, interface, code_path, logger):
+    def create_answerer(config, knowledge, interface, code_path, logger):
         narrator = Narrator(interface)
         return ArbiterAnswerer(
+            config,
             {
                 "The user makes small talk and there is no rule for that query": DialogueAnswerer(
-                    knowledge, interface, logger
+                    config, knowledge, interface, logger
                 ),
                 "The user gives an order or request and there is a rule for that query": InferenceAnswerer(
+                    config,
                     interface,
                     BackwardInference(
+                        config,
                         knowledge,
                         interface,
                         narrator,
@@ -87,8 +90,10 @@ def create_answerer(knowledge, interface, code_path, logger):
                     logger,
                 ),
                 "The user gives an order or request and there is no rule for that query": InferenceAnswerer(
+                    config,
                     interface,
                     BackwardInference(
+                        config,
                         knowledge,
                         interface,
                         narrator,
@@ -99,8 +104,10 @@ def create_answerer(knowledge, interface, code_path, logger):
                     logger,
                 ),
                 "The user gives a command and and there is no rule for that query": InferenceAnswerer(
+                    config,
                     interface,
                     BackwardInference(
+                        config,
                         knowledge,
                         interface,
                         narrator,
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index f9e647f1..50d9ed89 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -1,16 +1,17 @@
 import time
 
 from wafl.answerer.base_answerer import BaseAnswerer
+from wafl.connectors.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query, Answer
 from wafl.inference.utils import cluster_facts
 
 
 class DialogueAnswerer(BaseAnswerer):
-    def __init__(self, knowledge, interface, connector, logger):
+    def __init__(self, config, knowledge, interface, logger):
+        self._connector = LLMConnectorFactory.get_connector(config)
         self._knowledge = knowledge
         self._logger = logger
         self._interface = interface
-        self._connector = connector
         self._max_num_past_utterances = 7
 
     async def answer(self, query_text, policy):
diff --git a/wafl/answerer/inference_answerer.py b/wafl/answerer/inference_answerer.py
index 23ec79bc..48172697 100644
--- a/wafl/answerer/inference_answerer.py
+++ b/wafl/answerer/inference_answerer.py
@@ -9,14 +9,14 @@
 
 
 class InferenceAnswerer(BaseAnswerer):
-    def __init__(self, interface, inference, logger):
-        self._qa = Extractor(logger)
+    def __init__(self, config, interface, inference, logger):
+        self._qa = Extractor(config, logger)
         self._logger = logger
         self._narrator = Narrator(interface)
         self._interface = interface
         self._inference = inference
-        self._task_extractor = TaskExtractor(interface)
-        self._entailer = Entailer(logger)
+        self._task_extractor = TaskExtractor(config, interface)
+        self._entailer = Entailer(config, logger)
 
     async def answer(self, query_text, policy):
         prior_conversation = self._narrator.summarize_dialogue()
diff --git a/wafl/connectors/entailment_connector_factory.py b/wafl/connectors/entailment_connector_factory.py
new file mode 100644
index 00000000..f1855e71
--- /dev/null
+++ b/wafl/connectors/entailment_connector_factory.py
@@ -0,0 +1,11 @@
+from wafl.connectors.local_entailment_connector import LocalEntailmentConnector
+from wafl.connectors.remote_entailment_connector import RemoteEntailmentConnector
+
+
+class EntailmentConnectorFactory:
+    @staticmethod
+    def get_connector(config):
+        if config.get_value("entailment_model")["model_is_local"]:
+            return LocalEntailmentConnector(config.get_value("entailment_model"))
+
+        return RemoteEntailmentConnector(config.get_value("entailment_model"))
diff --git a/wafl/connectors/llm_chitchat_answer_bridge.py b/wafl/connectors/llm_chitchat_answer_bridge.py
index 2f3becc2..c6ed2310 100644
--- a/wafl/connectors/llm_chitchat_answer_bridge.py
+++ b/wafl/connectors/llm_chitchat_answer_bridge.py
@@ -5,6 +5,7 @@
 import os
 import re
 
+from wafl.connectors.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 
@@ -12,8 +13,9 @@
 
 
 class LLMChitChatAnswerBridge:
-    def __init__(self, llm_connector):
-        self._llm_connector = llm_connector
+    def __init__(self, config):
+        self._llm_connector = LLMConnectorFactory.get_connector(config)
+        self._config = config
 
         try:
             loop = asyncio.get_running_loop()
@@ -68,6 +70,6 @@ async def _load_knowledge_from_file(self, filename, _path=None):
             for row in csvreader:
                 items_list.append(row[0].strip())
 
-        knowledge = await SingleFileKnowledge.create_from_list(items_list)
+        knowledge = await SingleFileKnowledge.create_from_list(items_list, self._config)
         joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
         return knowledge
diff --git a/wafl/connectors/llm_connector_factory.py b/wafl/connectors/llm_connector_factory.py
new file mode 100644
index 00000000..dd9736c5
--- /dev/null
+++ b/wafl/connectors/llm_connector_factory.py
@@ -0,0 +1,11 @@
+from wafl.connectors.local_llm_connector import LocalLLMConnector
+from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+
+
+class LLMConnectorFactory:
+    @staticmethod
+    def get_connector(config):
+        if config.get_value("llm_model")["model_is_local"]:
+            return LocalLLMConnector(config.get_value("llm_model"))
+
+        return RemoteLLMConnector(config.get_value("llm_model"))
diff --git a/wafl/connectors/llm_prompt_predictor_connector.py b/wafl/connectors/llm_prompt_predictor_connector.py
index 5ab72eff..618f0ac2 100644
--- a/wafl/connectors/llm_prompt_predictor_connector.py
+++ b/wafl/connectors/llm_prompt_predictor_connector.py
@@ -2,7 +2,7 @@
 
 
 class LLMPromptPredictorConnector(RemoteLLMConnector):
-    def __init__(self, config=None):
+    def __init__(self, config):
         super().__init__(config)
 
     async def _get_answer_prompt(self, text, query, dialogue=None):
diff --git a/wafl/connectors/llm_qa_connector.py b/wafl/connectors/llm_qa_connector.py
index 0e7efe5f..c1d48bfb 100644
--- a/wafl/connectors/llm_qa_connector.py
+++ b/wafl/connectors/llm_qa_connector.py
@@ -8,7 +8,7 @@
 
 
 class LLMQAConnector(RemoteLLMConnector):
-    def __init__(self, config=None):
+    def __init__(self, config):
         super().__init__(config)
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/connectors/local_entailment_connector.py b/wafl/connectors/local_entailment_connector.py
index 410df63c..1479fe08 100644
--- a/wafl/connectors/local_entailment_connector.py
+++ b/wafl/connectors/local_entailment_connector.py
@@ -10,7 +10,7 @@
 class LocalEntailmentConnector:
     def __init__(self, config):
         global model, tokenizer
-        model_name = config.get_value("entailment_model")["local_model"]
+        model_name = config["local_model"]
         model = AutoModelForSequenceClassification.from_pretrained(model_name)
         model.to(device)
         tokenizer = AutoTokenizer.from_pretrained(model_name)
diff --git a/wafl/connectors/local_llm_connector.py b/wafl/connectors/local_llm_connector.py
index 5d03ade8..819b6b25 100644
--- a/wafl/connectors/local_llm_connector.py
+++ b/wafl/connectors/local_llm_connector.py
@@ -15,20 +15,15 @@ class LocalLLMConnector:
     _num_prediction_tokens = 200
     _cache = {}
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
+    def __init__(self, config):
         global model, tokenizer
         model = AutoModelForCausalLM.from_pretrained(
-            config.get_value("llm_model")["local_model"],
+            config["local_model"],
             init_device=device,
             trust_remote_code=True,
             torch_dtype=torch.half,
         )
-        tokenizer = AutoTokenizer.from_pretrained(
-            config.get_value("llm_model")["local_model"]
-        )
+        tokenizer = AutoTokenizer.from_pretrained(config["local_model"])
 
         self._stop_at_eos = StopAtEOS(tokenizer)
 
diff --git a/wafl/connectors/local_speaker_connector.py b/wafl/connectors/local_speaker_connector.py
index 9651f32a..74d89642 100644
--- a/wafl/connectors/local_speaker_connector.py
+++ b/wafl/connectors/local_speaker_connector.py
@@ -9,7 +9,7 @@
 
 class LocalSpeakerConnector:
     def __init__(self, config):
-        model_name = config.get_value("listener_model")["speaker_model"]
+        model_name = config["local_model"]
         global model
         models, cfg, self._task = load_model_ensemble_and_task_from_hf_hub(
             model_name,
diff --git a/wafl/connectors/local_whisper_connector.py b/wafl/connectors/local_whisper_connector.py
index ed6eef85..e68cab9d 100644
--- a/wafl/connectors/local_whisper_connector.py
+++ b/wafl/connectors/local_whisper_connector.py
@@ -9,7 +9,7 @@ class LocalWhisperConnector:
     _max_tries = 3
 
     def __init__(self, config):
-        model_name = config.get_value("listener_model")["local_model"]
+        model_name = config["local_model"]
         global model, processor
         self.model = WhisperForConditionalGeneration.from_pretrained(model_name)
         self.model.to(_device)
diff --git a/wafl/connectors/remote_entailment_connector.py b/wafl/connectors/remote_entailment_connector.py
index 207600f0..40e8e300 100644
--- a/wafl/connectors/remote_entailment_connector.py
+++ b/wafl/connectors/remote_entailment_connector.py
@@ -10,8 +10,8 @@ class RemoteEntailmentConnector:
 
     def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('entailment_model')['model_host']}:"
-            f"{config.get_value('entailment_model')['model_port']}/predictions/entailment"
+            f"https://{config['remote_model']['model_host']}:"
+            f"{config['remote_model']['model_port']}/predictions/entailment"
         )
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/connectors/remote_llm_connector.py b/wafl/connectors/remote_llm_connector.py
index 79c4db5c..9416a942 100644
--- a/wafl/connectors/remote_llm_connector.py
+++ b/wafl/connectors/remote_llm_connector.py
@@ -16,14 +16,10 @@ class RemoteLLMConnector:
     _num_prediction_tokens = 200
     _cache = {}
 
-    def __init__(self, config=None):
-        if not config:
-            config = Configuration.load_local_config()
-
-        self._server_url = (
-            f"https://{config.get_value('model_host')}:"
-            f"{config.get_value('model_port')}/predictions/bot"
-        )
+    def __init__(self, config):
+        host = config["remote_model"]["model_host"]
+        port = config["remote_model"]["model_port"]
+        self._server_url = f"https://{host}:{port}/predictions/bot"
 
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/connectors/remote_sentence_embedder_connector.py b/wafl/connectors/remote_sentence_embedder_connector.py
index b1096f29..c76eb339 100644
--- a/wafl/connectors/remote_sentence_embedder_connector.py
+++ b/wafl/connectors/remote_sentence_embedder_connector.py
@@ -9,7 +9,11 @@
 class RemoteSentenceEmbedderConnector:
     _max_tries = 3
 
-    def __init__(self, host, port, model_name):
+    def __init__(self, config):
+        host = config["remote_model"]["model_host"]
+        port = config["remote_model"]["model_port"]
+        model_name = config["local_model"]
+
         self._model_name = model_name
         self._server_url = f"https://{host}:" f"{port}/predictions/sentence_embedder"
         try:
diff --git a/wafl/connectors/remote_whisper_connector.py b/wafl/connectors/remote_whisper_connector.py
index 7844c65f..3b7a8cba 100644
--- a/wafl/connectors/remote_whisper_connector.py
+++ b/wafl/connectors/remote_whisper_connector.py
@@ -10,8 +10,8 @@ class RemoteWhisperConnector:
 
     def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('listener_model')['model_host']}:"
-            f"{config.get_value('listener_model')['model_port']}/predictions/whisper"
+            f"https://{config['model_host']}:"
+            f"{config['model_port']}/predictions/whisper"
         )
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/connectors/sentence_embedder_connector_factory.py b/wafl/connectors/sentence_embedder_connector_factory.py
index 86c35e85..229c86ce 100644
--- a/wafl/connectors/sentence_embedder_connector_factory.py
+++ b/wafl/connectors/sentence_embedder_connector_factory.py
@@ -1,6 +1,9 @@
 from wafl.connectors.local_sentence_embedder_connector import (
     LocalSentenceEmbedderConnector,
 )
+from wafl.connectors.remote_sentence_embedder_connector import (
+    RemoteSentenceEmbedderConnector,
+)
 
 
 class SentenceEmbedderConnectorFactory:
@@ -10,3 +13,5 @@ def get_connector(model_name, config):
             return LocalSentenceEmbedderConnector(
                 config.get_value(model_name)["local_model"]
             )
+
+        return RemoteSentenceEmbedderConnector(config.get_value(model_name))
diff --git a/wafl/connectors/speaker_connector_factory.py b/wafl/connectors/speaker_connector_factory.py
new file mode 100644
index 00000000..e6b9d983
--- /dev/null
+++ b/wafl/connectors/speaker_connector_factory.py
@@ -0,0 +1,11 @@
+from wafl.connectors.local_speaker_connector import LocalSpeakerConnector
+from wafl.connectors.remote_speaker_connector import RemoteSpeakerConnector
+
+
+class SpeakerConnectorFactory:
+    @staticmethod
+    def get_connector(config):
+        if config.get_value("speaker_model")["model_is_local"]:
+            return LocalSpeakerConnector(config.get_value("speaker_model"))
+
+        return RemoteSpeakerConnector(config.get_value("speaker_model"))
diff --git a/wafl/connectors/whisper_connector_factory.py b/wafl/connectors/whisper_connector_factory.py
new file mode 100644
index 00000000..18d1348c
--- /dev/null
+++ b/wafl/connectors/whisper_connector_factory.py
@@ -0,0 +1,11 @@
+from wafl.connectors.local_whisper_connector import LocalWhisperConnector
+from wafl.connectors.remote_whisper_connector import RemoteWhisperConnector
+
+
+class WhisperConnectorFactory:
+    @staticmethod
+    def get_connector(config):
+        if config.get_value("listener_model")["model_is_local"]:
+            return LocalWhisperConnector(config.get_value("listener_model"))
+
+        return RemoteWhisperConnector(config.get_value("listener_model"))
diff --git a/wafl/events/answerer_creator.py b/wafl/events/answerer_creator.py
index aa212cad..0fa6505b 100644
--- a/wafl/events/answerer_creator.py
+++ b/wafl/events/answerer_creator.py
@@ -2,11 +2,11 @@
 from wafl.answerer.list_answerer import ListAnswerer
 
 
-def create_answerer(knowledge, interface, code_path, connector, logger):
+def create_answerer(config, knowledge, interface, code_path, logger):
     return ListAnswerer(
         [
             ArbiterAnswerer.create_answerer(
-                knowledge, interface, code_path, connector, logger
+                config, knowledge, interface, code_path, logger
             ),
         ],
         interface,
diff --git a/wafl/events/conversation_events.py b/wafl/events/conversation_events.py
index 1a156efc..814a9e99 100644
--- a/wafl/events/conversation_events.py
+++ b/wafl/events/conversation_events.py
@@ -1,6 +1,7 @@
 import os
 import re
 
+from wafl.connectors.local_llm_connector import LocalLLMConnector
 from wafl.events.answerer_creator import create_answerer
 from wafl.policy.answerer_policy import AnswerPolicy
 from wafl.simple_text_processing.normalize import normalized
@@ -21,20 +22,19 @@ def __init__(
         config=None,
         logger=None,
     ):
-        self._answerer = create_answerer(knowledge, interface, code_path, logger)
+        if not config:
+            config = Configuration.load_local_config()
+
+        self._answerer = create_answerer(
+            config, knowledge, interface, code_path, logger
+        )
         self._knowledge = knowledge
         self._interface = interface
-        self._policy = AnswerPolicy(interface, logger)
+        self._policy = AnswerPolicy(config, interface, logger)
         self._logger = logger
         if logger:
             self._logger.set_depth(0)
 
-        if not config:
-            self._config = Configuration.load_local_config()
-
-        else:
-            self._config = config
-
     async def output(self, text: str):
         await self._interface.output(text)
 
diff --git a/wafl/extractors/code_creator.py b/wafl/extractors/code_creator.py
index 9da1501a..a21f7926 100644
--- a/wafl/extractors/code_creator.py
+++ b/wafl/extractors/code_creator.py
@@ -10,8 +10,8 @@
 
 
 class CodeCreator:
-    def __init__(self, knowledge, logger=None):
-        self._connector = LLMCodeCreatorConnector()
+    def __init__(self, config, knowledge, logger=None):
+        self._connector = LLMCodeCreatorConnector(config.get_value("llm_model"))
         self._knowledge = knowledge
 
     async def extract(self, function_and_task: str) -> Answer:
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index 0bbaca84..7733d1ce 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -1,10 +1,12 @@
 from typing import Dict, Union
 
+from wafl.connectors.entailment_connector_factory import EntailmentConnectorFactory
+
 
 class Entailer:
-    def __init__(self, connector, logger=None):
+    def __init__(self, config, logger=None):
         self._logger = logger
-        self._connector = connector
+        self._connector = EntailmentConnectorFactory.get_connector(config)
         self._cache = {}
 
     async def get_relation(self, premise: str, hypothesis: str) -> Dict[str, float]:
diff --git a/wafl/extractors/extractor.py b/wafl/extractors/extractor.py
index 0b760562..263bf15b 100644
--- a/wafl/extractors/extractor.py
+++ b/wafl/extractors/extractor.py
@@ -17,9 +17,9 @@
 
 
 class Extractor:
-    def __init__(self, narrator, logger=None):
-        self._entailer = Entailer(logger)
-        self._qa = LLMQAConnector()
+    def __init__(self, config, narrator, logger=None):
+        self._entailer = Entailer(config, logger)
+        self._qa = LLMQAConnector(config.get_value("llm_model"))
         self._narrator = narrator
         self._logger = logger
         self._entailer_to_qa_mapping = {
diff --git a/wafl/extractors/prompt_predictor.py b/wafl/extractors/prompt_predictor.py
index 18cb3038..6d2028e6 100644
--- a/wafl/extractors/prompt_predictor.py
+++ b/wafl/extractors/prompt_predictor.py
@@ -9,8 +9,8 @@
 
 
 class PromptPredictor:
-    def __init__(self, logger=None):
-        self._model = LLMPromptPredictorConnector()
+    def __init__(self, config, logger=None):
+        self._model = LLMPromptPredictorConnector(config.get_value("llm_model"))
         self._closing_tag = "</result>"
 
     async def predict(self, prompt: str):
diff --git a/wafl/extractors/task_creator.py b/wafl/extractors/task_creator.py
index 9705609c..1e6d5b76 100644
--- a/wafl/extractors/task_creator.py
+++ b/wafl/extractors/task_creator.py
@@ -9,8 +9,8 @@
 
 
 class TaskCreator:
-    def __init__(self, knowledge, logger=None):
-        self._connector = LLMTaskCreatorConnector()
+    def __init__(self, config, knowledge, logger=None):
+        self._connector = LLMTaskCreatorConnector(config.get_value("llm_model"))
         self._knowledge = knowledge
         self._logger = logger
 
diff --git a/wafl/extractors/task_extractor.py b/wafl/extractors/task_extractor.py
index cd0da923..3325a1de 100644
--- a/wafl/extractors/task_extractor.py
+++ b/wafl/extractors/task_extractor.py
@@ -9,9 +9,9 @@
 
 
 class TaskExtractor:
-    def __init__(self, interface, logger=None):
+    def __init__(self, config, interface, logger=None):
         self._interface = interface
-        self._connector = LLMTaskExtractorConnector()
+        self._connector = LLMTaskExtractorConnector(config.get_value("llm_model"))
         self._max_num_past_utterances = 3
         self._to_ignore = ["yes", "no", "ok", "okay", "sure", "nope", "yep", "you"]
 
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index fac152f5..3a9dfe8c 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -48,6 +48,7 @@
 class BackwardInference:
     def __init__(
         self,
+        config: "Configuration",
         knowledge: "BaseKnowledge",
         interface: "BaseInterface",
         narrator: "Narrator",
@@ -59,14 +60,17 @@ def __init__(
         self._max_depth = max_depth
         self._knowledge = knowledge
         self._interface = interface
-        self._extractor = Extractor(narrator, logger)
-        self._prompt_predictor = PromptPredictor(logger)
-        self._task_extractor = TaskExtractor(interface)
-        self._task_creator = TaskCreator(knowledge, logger)
-        self._code_creator = CodeCreator(knowledge)
+        self._config = config
+        #### go through them with the config
+        self._extractor = Extractor(config, narrator, logger)
+        self._prompt_predictor = PromptPredictor(config, logger)
+        self._task_extractor = TaskExtractor(config, interface)
+        self._task_creator = TaskCreator(config, knowledge, logger)
+        self._code_creator = CodeCreator(config, knowledge)
+        ####
+
         self._narrator = narrator
         self._logger = logger
-        self._config = Configuration.load_local_config()
         self._generate_rules = generate_rules
         self._module = {}
         self._functions = {}
diff --git a/wafl/knowledge/single_file_knowledge.py b/wafl/knowledge/single_file_knowledge.py
index 7bf09a9f..a8c2dccb 100644
--- a/wafl/knowledge/single_file_knowledge.py
+++ b/wafl/knowledge/single_file_knowledge.py
@@ -48,7 +48,7 @@ def __init__(self, config, rules_text=None, knowledge_name=None, logger=None):
             "qa_embedding_model",
             config,
         )
-        self._entailer = Entailer(logger)
+        self._entailer = Entailer(config, logger)
         self._rules_incomplete_retriever = DenseRetriever(
             "text_embedding_model", config
         )
@@ -230,8 +230,12 @@ async def _initialize_retrievers(self):
             )
 
     @staticmethod
-    async def create_from_list(facts: List[str]) -> "SingleFileKnowledge":
-        config = Configuration.load_local_config()
+    async def create_from_list(
+        facts: List[str], config: "Configuration" = None
+    ) -> "SingleFileKnowledge":
+        if not config:
+            config = Configuration.load_local_config()
+
         knowledge = SingleFileKnowledge(config)
         for index, fact in enumerate(facts):
             await knowledge.add(fact)
diff --git a/wafl/listener/whisper_listener.py b/wafl/listener/whisper_listener.py
index 783dd331..7b6d19d5 100644
--- a/wafl/listener/whisper_listener.py
+++ b/wafl/listener/whisper_listener.py
@@ -6,6 +6,8 @@
 import numpy as np
 import torch.cuda
 
+from wafl.connectors.whisper_connector_factory import WhisperConnectorFactory
+
 device = "cuda" if torch.cuda.is_available() else "cpu"
 
 
@@ -19,14 +21,14 @@ class WhisperListener:
     _starting_tokens = [50257, 50362]
     _ending_tokens = [50256]
 
-    def __init__(self, connector):
+    def __init__(self, config):
         self._p = pyaudio.PyAudio()
         self._volume_threshold = 1
         self._original_volume_threshold = self._volume_threshold
         self._timeout = 1
         self._max_timeout = 4
         self._hotword_threshold = -8
-        self._connector = connector
+        self._connector = WhisperConnectorFactory.get_connector(config)
         self._hotwords = list()
         self.is_active = False
         self._last_waveform = None
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index bd409120..b50f3544 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -4,10 +4,10 @@
 
 
 class AnswerPolicy:
-    def __init__(self, interface, logger=None):
+    def __init__(self, config, interface, logger=None):
         self._interface = interface
         self._logger = logger
-        self._connector = RemoteLLMAnswerPolicyConnector()
+        self._connector = RemoteLLMAnswerPolicyConnector(config.get_value("llm_model"))
         self._max_num_past_utterances = 3
 
     async def accept(self, result: str):
diff --git a/wafl/speaker/fairseq_speaker.py b/wafl/speaker/fairseq_speaker.py
index 4bddb34e..85a80b78 100644
--- a/wafl/speaker/fairseq_speaker.py
+++ b/wafl/speaker/fairseq_speaker.py
@@ -1,13 +1,14 @@
 import asyncio
 import pyaudio
 
+from wafl.connectors.speaker_connector_factory import SpeakerConnectorFactory
 from wafl.speaker.base_speaker import BaseSpeaker
 from wafl.speaker.utils import convert_numbers_to_words
 
 
 class FairSeqSpeaker(BaseSpeaker):
-    def __init__(self, connector):
-        self._connector = connector
+    def __init__(self, config):
+        self._connector = SpeakerConnectorFactory.get_connector(config)
         self._p = pyaudio.PyAudio()
 
     async def speak(self, text):
@@ -21,7 +22,8 @@ async def speak(self, text):
             rate=rate,
             output=True,
         )
-        stream.write(wav)
+        await asyncio.sleep(0.2)
+        stream.write(wav.cpu().numpy().tobytes())
         stream.stop_stream()
         stream.close()
         await asyncio.sleep(0.1)

From 196bca0a9f41f374ea78ac663d9fbfcbb0ac1875 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sun, 20 Aug 2023 15:47:11 +0100
Subject: [PATCH 18/29] updated the tests

---
 tests/test_conversation.py | 5 ++++-
 todo.txt                   | 4 ++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/tests/test_conversation.py b/tests/test_conversation.py
index aa572891..82279283 100644
--- a/tests/test_conversation.py
+++ b/tests/test_conversation.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -77,8 +79,9 @@ def test__single_utterance(self):
 
     def test__say_command(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             interface=interface,
             logger=_logger,
         )
diff --git a/todo.txt b/todo.txt
index 166382d3..776a268a 100644
--- a/todo.txt
+++ b/todo.txt
@@ -5,10 +5,10 @@
   * check remote connectors work!
   * create note about local speaker for python 3.11
 
-* rewrite documentation
+* rewrite documentation !!!!
    * talk about how the system will improvises rules
    * explain arbiter pipeline
-   * update config description (possibly with stand-alone connection)
+   * update config description (possibly with stand-alone connection) !!!!
 
 * add init-default (with modified wafl_home) and init (as empty)
 

From b9a5e71f9bb069381772278b6ce30f1246d02456 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Mon, 21 Aug 2023 10:38:42 +0100
Subject: [PATCH 19/29] refactored bridge class as an middle point to the
 connectors

---
 tests/test_connection.py                      | 15 ++++----
 tests/test_conversation.py                    | 36 ++++++++++++-------
 tests/test_task_creation.py                   |  8 ++---
 wafl/answerer/dialogue_answerer.py            |  6 ++--
 wafl/answerer/generated_answerer.py           |  4 +--
 wafl/connectors/__init__.py                   |  0
 wafl/connectors/bridges/__init__.py           |  0
 .../bridges/bridge_implementation.py          | 19 ++++++++++
 .../llm_chitchat_answer_bridge.py             | 26 ++++----------
 .../llm_code_creator_bridge.py}               | 18 ++++++----
 .../bridges/llm_generated_answer_bridge.py    | 19 ++++++++++
 .../bridges/llm_prompt_predictor_bridge.py    | 23 ++++++++++++
 .../llm_qa_bridge.py}                         | 22 +++++++-----
 .../llm_task_creator_bridge.py}               | 18 ++++++----
 .../llm_task_extractor_bridge.py}             | 25 +++++++------
 wafl/connectors/dialogue.py                   | 15 --------
 wafl/connectors/factories/__init__.py         |  0
 .../entailment_connector_factory.py           |  4 +--
 .../{ => factories}/llm_connector_factory.py  |  4 +--
 .../sentence_embedder_connector_factory.py    |  4 +--
 .../speaker_connector_factory.py              |  4 +--
 .../whisper_connector_factory.py              |  4 +--
 .../llm_generated_answer_connector.py         | 15 --------
 .../llm_prompt_predictor_connector.py         | 19 ----------
 wafl/connectors/local/__init__.py             |  0
 .../{ => local}/local_entailment_connector.py |  0
 .../{ => local}/local_llm_connector.py        |  0
 .../local_sentence_embedder_connector.py      |  0
 .../{ => local}/local_speaker_connector.py    |  0
 .../{ => local}/local_whisper_connector.py    |  0
 wafl/connectors/remote/__init__.py            |  0
 .../remote_entailment_connector.py            |  0
 .../remote_llm_answer_policy_connector.py     |  2 +-
 .../remote_llm_chitchat_answer_connector.py   |  2 +-
 .../{ => remote}/remote_llm_connector.py      | 19 ++--------
 .../remote_sentence_embedder_connector.py     |  0
 .../{ => remote}/remote_speaker_connector.py  |  0
 .../{ => remote}/remote_whisper_connector.py  |  0
 wafl/events/conversation_events.py            |  1 -
 wafl/extractors/code_creator.py               |  6 ++--
 wafl/extractors/entailer.py                   |  2 +-
 wafl/extractors/extractor.py                  | 12 +++----
 wafl/extractors/prompt_predictor.py           |  4 +--
 wafl/extractors/task_creator.py               |  4 +--
 wafl/extractors/task_extractor.py             |  4 +--
 wafl/listener/whisper_listener.py             |  2 +-
 wafl/policy/answerer_policy.py                |  2 +-
 wafl/retriever/dense_retriever.py             |  2 +-
 wafl/speaker/fairseq_speaker.py               |  2 +-
 49 files changed, 191 insertions(+), 181 deletions(-)
 create mode 100644 wafl/connectors/__init__.py
 create mode 100644 wafl/connectors/bridges/__init__.py
 create mode 100644 wafl/connectors/bridges/bridge_implementation.py
 rename wafl/connectors/{ => bridges}/llm_chitchat_answer_bridge.py (61%)
 rename wafl/connectors/{llm_code_creator_connector.py => bridges/llm_code_creator_bridge.py} (64%)
 create mode 100644 wafl/connectors/bridges/llm_generated_answer_bridge.py
 create mode 100644 wafl/connectors/bridges/llm_prompt_predictor_bridge.py
 rename wafl/connectors/{llm_qa_connector.py => bridges/llm_qa_bridge.py} (69%)
 rename wafl/connectors/{llm_task_creator_connector.py => bridges/llm_task_creator_bridge.py} (67%)
 rename wafl/connectors/{llm_task_extractor_connector.py => bridges/llm_task_extractor_bridge.py} (68%)
 delete mode 100644 wafl/connectors/dialogue.py
 create mode 100644 wafl/connectors/factories/__init__.py
 rename wafl/connectors/{ => factories}/entailment_connector_factory.py (64%)
 rename wafl/connectors/{ => factories}/llm_connector_factory.py (64%)
 rename wafl/connectors/{ => factories}/sentence_embedder_connector_factory.py (75%)
 rename wafl/connectors/{ => factories}/speaker_connector_factory.py (64%)
 rename wafl/connectors/{ => factories}/whisper_connector_factory.py (64%)
 delete mode 100644 wafl/connectors/llm_generated_answer_connector.py
 delete mode 100644 wafl/connectors/llm_prompt_predictor_connector.py
 create mode 100644 wafl/connectors/local/__init__.py
 rename wafl/connectors/{ => local}/local_entailment_connector.py (100%)
 rename wafl/connectors/{ => local}/local_llm_connector.py (100%)
 rename wafl/connectors/{ => local}/local_sentence_embedder_connector.py (100%)
 rename wafl/connectors/{ => local}/local_speaker_connector.py (100%)
 rename wafl/connectors/{ => local}/local_whisper_connector.py (100%)
 create mode 100644 wafl/connectors/remote/__init__.py
 rename wafl/connectors/{ => remote}/remote_entailment_connector.py (100%)
 rename wafl/connectors/{ => remote}/remote_llm_answer_policy_connector.py (95%)
 rename wafl/connectors/{ => remote}/remote_llm_chitchat_answer_connector.py (95%)
 rename wafl/connectors/{ => remote}/remote_llm_connector.py (80%)
 rename wafl/connectors/{ => remote}/remote_sentence_embedder_connector.py (100%)
 rename wafl/connectors/{ => remote}/remote_speaker_connector.py (100%)
 rename wafl/connectors/{ => remote}/remote_whisper_connector.py (100%)

diff --git a/tests/test_connection.py b/tests/test_connection.py
index ad8c84d4..60cb9a7c 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -7,13 +7,10 @@
 import numpy as np
 
 from wafl.config import Configuration
-from wafl.connectors.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
-from wafl.connectors.local_entailment_connector import LocalEntailmentConnector
-from wafl.connectors.local_llm_connector import LocalLLMConnector
-from wafl.connectors.local_speaker_connector import LocalSpeakerConnector
-from wafl.connectors.local_whisper_connector import LocalWhisperConnector
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
-from wafl.connectors.llm_qa_connector import LLMQAConnector
+from wafl.connectors.bridges.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
+from wafl.connectors.local.local_llm_connector import LocalLLMConnector
+from wafl.connectors.remote.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.bridges.llm_qa_bridge import LLMQABridge
 from wafl.extractors.entailer import Entailer
 from wafl.listener.whisper_listener import WhisperListener
 from wafl.speaker.fairseq_speaker import FairSeqSpeaker
@@ -24,11 +21,11 @@
 class TestConnection(TestCase):
     def test__connection_to_generative_model_hostname_is_active(self):
         config = Configuration.load_local_config()
-        LLMQAConnector(config)
+        LLMQABridge(config)
 
     def test__connection_to_generative_model_hostname_answer_a_question_correctly(self):
         config = Configuration.load_local_config()
-        connector = LLMQAConnector(config)
+        connector = LLMQABridge(config)
         answer_text = asyncio.run(
             connector.get_answer(
                 text="The bot remembers: The sky is blue",
diff --git a/tests/test_conversation.py b/tests/test_conversation.py
index 82279283..98f3460b 100644
--- a/tests/test_conversation.py
+++ b/tests/test_conversation.py
@@ -95,8 +95,9 @@ def test_input_during_inference(self):
         interface = DummyInterface(
             to_utter=["Can I register to the newsletter?", "test@example.com"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -113,8 +114,9 @@ def test__remember_command(self):
                 "What is the email of the user",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -127,8 +129,9 @@ def test__knowledge_insertion(self):
         interface = DummyInterface(
             to_utter=["the user's mother is called Ada", "How is the user's mum called"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -140,8 +143,9 @@ def test__knowledge_insertion(self):
 
     def test__greeting(self):
         interface = DummyInterface(["My name is Albert", "What is my name"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge("", logger=_logger),
+            SingleFileKnowledge(config, "", logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -154,8 +158,9 @@ def test__greeting(self):
 
     def test__greeting_with_alberto_as_name(self):
         interface = DummyInterface(["My name is Albert0", "What is my name"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -169,8 +174,9 @@ def test__greeting_with_alberto_as_name(self):
 
     def test__yes(self):
         interface = DummyInterface(["My name is Ada", "am I called Ada"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -186,8 +192,9 @@ def test__yes(self):
 
     def test__no(self):
         interface = DummyInterface(["My name is Albert", "Is my name Bob?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -203,8 +210,9 @@ def test__no(self):
 
     def test__yes_no_questions_from_bot_with_answer_yes(self):
         interface = DummyInterface(["I want to join the club", "yes"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -215,8 +223,9 @@ def test__yes_no_questions_from_bot_with_answer_yes(self):
 
     def test__yes_no_questions_from_bot_with_answer_no(self):
         interface = DummyInterface(["I want to join the club", "no"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -229,8 +238,9 @@ def test__yes_no_questions_from_bot_with_answer_no(self):
 
     def test__hello_and_username(self):
         interface = DummyInterface(["Hello", "Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings, logger=_logger),
+            SingleFileKnowledge(config, _wafl_greetings, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -242,8 +252,9 @@ def test__hello_and_username(self):
 
     def test__how_are_you(self):
         interface = DummyInterface(["How are you?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_how_are_you, logger=_logger),
+            SingleFileKnowledge(config, _wafl_how_are_you, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -254,8 +265,9 @@ def test__dialogue_variable_works(self):
         interface = DummyInterface(
             ["my name is Albert0 and I am a carpenter", "say something about me"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_dialogue_variable, logger=_logger),
+            SingleFileKnowledge(config, _wafl_dialogue_variable, logger=_logger),
             interface=interface,
             logger=_logger,
         )
diff --git a/tests/test_task_creation.py b/tests/test_task_creation.py
index dea4db39..0105f06e 100644
--- a/tests/test_task_creation.py
+++ b/tests/test_task_creation.py
@@ -1,8 +1,8 @@
 import asyncio
 
 from unittest import TestCase
-from wafl.connectors.llm_code_creator_connector import LLMCodeCreatorConnector
-from wafl.connectors.llm_task_creator_connector import LLMTaskCreatorConnector
+from wafl.connectors.bridges.llm_code_creator_bridge import LLMCodeCreatorBridge
+from wafl.connectors.bridges.llm_task_creator_bridge import LLMTaskCreatorBridge
 from wafl.events.conversation_events import ConversationEvents
 from wafl.extractors.code_creator import CodeCreator
 from wafl.extractors.task_creator import TaskCreator
@@ -24,7 +24,7 @@
 
 class TestTaskCreation(TestCase):
     def test__task_creation_connector(self):
-        connector = LLMTaskCreatorConnector()
+        connector = LLMTaskCreatorBridge()
         task = "the user wants to go swimming in the sea"
         triggers = "\n".join(
             [
@@ -97,7 +97,7 @@ def test__task_is_created_from_conversation(self):
         assert interface.get_utterances_list()[-1] == expected
 
     def test__code_creation(self):
-        connector = LLMCodeCreatorConnector()
+        connector = LLMCodeCreatorBridge()
         task = "connect to 'localhost:port' and return the data as json"
         function_shape = "json_data = connect_to_localhost(port)"
         prediction = asyncio.run(connector.get_answer("", function_shape, task))
diff --git a/wafl/answerer/dialogue_answerer.py b/wafl/answerer/dialogue_answerer.py
index 50d9ed89..efe43d9c 100644
--- a/wafl/answerer/dialogue_answerer.py
+++ b/wafl/answerer/dialogue_answerer.py
@@ -1,14 +1,14 @@
 import time
 
 from wafl.answerer.base_answerer import BaseAnswerer
-from wafl.connectors.llm_connector_factory import LLMConnectorFactory
+from wafl.connectors.bridges.llm_chitchat_answer_bridge import LLMChitChatAnswerBridge
 from wafl.extractors.dataclasses import Query, Answer
 from wafl.inference.utils import cluster_facts
 
 
 class DialogueAnswerer(BaseAnswerer):
     def __init__(self, config, knowledge, interface, logger):
-        self._connector = LLMConnectorFactory.get_connector(config)
+        self._bridge = LLMChitChatAnswerBridge(config)
         self._knowledge = knowledge
         self._logger = logger
         self._interface = interface
@@ -42,7 +42,7 @@ async def answer(self, query_text, policy):
         dialogue_items = sorted(dialogue_items, key=lambda x: x[0])
         dialogue_items = [item[1] for item in dialogue_items if item[0] >= start_time]
         dialogue_items = "\n".join(dialogue_items)
-        answer_text = await self._connector.get_answer(
+        answer_text = await self._bridge.get_answer(
             text="",
             dialogue=dialogue_items,
             query=query_text,
diff --git a/wafl/answerer/generated_answerer.py b/wafl/answerer/generated_answerer.py
index 5aa8bed2..2b37d14b 100644
--- a/wafl/answerer/generated_answerer.py
+++ b/wafl/answerer/generated_answerer.py
@@ -1,5 +1,5 @@
 from wafl.answerer.base_answerer import BaseAnswerer
-from wafl.connectors.llm_generated_answer_connector import LLMGeneratedAnswerConnector
+from wafl.connectors.bridges.llm_generated_answer_bridge import LLMGeneratedAnswerBridge
 from wafl.extractors.dataclasses import Answer
 from wafl.extractors.entailer import Entailer
 
@@ -8,7 +8,7 @@ class GeneratedAnswerer(BaseAnswerer):
     def __init__(self, narrator, logger):
         self._logger = logger
         self._narrator = narrator
-        self._connector = LLMGeneratedAnswerConnector()
+        self._connector = LLMGeneratedAnswerBridge()
         self._entailer = Entailer(logger)
 
     async def answer(self, query_text, policy):
diff --git a/wafl/connectors/__init__.py b/wafl/connectors/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/connectors/bridges/__init__.py b/wafl/connectors/bridges/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/connectors/bridges/bridge_implementation.py b/wafl/connectors/bridges/bridge_implementation.py
new file mode 100644
index 00000000..ec463c56
--- /dev/null
+++ b/wafl/connectors/bridges/bridge_implementation.py
@@ -0,0 +1,19 @@
+import csv
+import os
+import joblib
+
+from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
+
+_path = os.path.dirname(__file__)
+
+
+async def load_knowledge_from_file(filename, config):
+    items_list = []
+    with open(os.path.join(_path, "../../data/", filename + ".csv")) as file:
+        csvreader = csv.reader(file)
+        for row in csvreader:
+            items_list.append(row[0].strip())
+
+    knowledge = await SingleFileKnowledge.create_from_list(items_list, config)
+    joblib.dump(knowledge, os.path.join(_path, f"../../data/{filename}.knowledge"))
+    return knowledge
diff --git a/wafl/connectors/llm_chitchat_answer_bridge.py b/wafl/connectors/bridges/llm_chitchat_answer_bridge.py
similarity index 61%
rename from wafl/connectors/llm_chitchat_answer_bridge.py
rename to wafl/connectors/bridges/llm_chitchat_answer_bridge.py
index c6ed2310..de9bf813 100644
--- a/wafl/connectors/llm_chitchat_answer_bridge.py
+++ b/wafl/connectors/bridges/llm_chitchat_answer_bridge.py
@@ -1,20 +1,17 @@
 import asyncio
-import csv
-
-import joblib
 import os
 import re
 
-from wafl.connectors.llm_connector_factory import LLMConnectorFactory
+from wafl.connectors.bridges.bridge_implementation import load_knowledge_from_file
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
-from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 
 _path = os.path.dirname(__file__)
 
 
 class LLMChitChatAnswerBridge:
     def __init__(self, config):
-        self._llm_connector = LLMConnectorFactory.get_connector(config)
+        self._connector = LLMConnectorFactory.get_connector(config)
         self._config = config
 
         try:
@@ -28,16 +25,16 @@ def __init__(self, config):
 
         else:
             self._knowledge = asyncio.run(
-                self._load_knowledge_from_file("dialogues", _path)
+                load_knowledge_from_file("dialogues", self._config)
             )
 
     async def get_answer(self, text: str, dialogue: str, query: str) -> str:
         prompt = await self._get_answer_prompt(text, query, dialogue)
-        return await self._llm_connector.generate(prompt)
+        return await self._connector.generate(prompt)
 
     async def _get_answer_prompt(self, text, query, dialogue=None):
         if not self._knowledge:
-            self._knowledge = await self._load_knowledge_from_file("dialogues", _path)
+            self._knowledge = await load_knowledge_from_file("dialogues", self._config)
 
         retrieved_dialogues = await self._knowledge.ask_for_facts(
             Query.create_from_text(dialogue), threshold=0.1
@@ -62,14 +59,3 @@ async def _get_answer_prompt(self, text, query, dialogue=None):
 bot:
         """.strip()
         return prompt
-
-    async def _load_knowledge_from_file(self, filename, _path=None):
-        items_list = []
-        with open(os.path.join(_path, f"../data/{filename}.csv")) as file:
-            csvreader = csv.reader(file)
-            for row in csvreader:
-                items_list.append(row[0].strip())
-
-        knowledge = await SingleFileKnowledge.create_from_list(items_list, self._config)
-        joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
-        return knowledge
diff --git a/wafl/connectors/llm_code_creator_connector.py b/wafl/connectors/bridges/llm_code_creator_bridge.py
similarity index 64%
rename from wafl/connectors/llm_code_creator_connector.py
rename to wafl/connectors/bridges/llm_code_creator_bridge.py
index 012d0e62..b35a62b9 100644
--- a/wafl/connectors/llm_code_creator_connector.py
+++ b/wafl/connectors/bridges/llm_code_creator_bridge.py
@@ -1,15 +1,17 @@
 import asyncio
 import os
 
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.bridges.bridge_implementation import load_knowledge_from_file
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMCodeCreatorConnector(RemoteLLMConnector):
+class LLMCodeCreatorBridge:
     def __init__(self, config=None):
-        super().__init__(config)
+        self._connector = LLMConnectorFactory.get_connector(config)
+        self._config = config
         try:
             loop = asyncio.get_running_loop()
 
@@ -21,13 +23,17 @@ def __init__(self, config=None):
 
         else:
             self._knowledge = asyncio.run(
-                self._load_knowledge_from_file("code_creator", _path)
+                load_knowledge_from_file("code_creator", self._config)
             )
 
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
     async def _get_answer_prompt(self, text: str, task: str, function_name: str = None):
         if self._knowledge is None:
-            self._knowledge = await self._load_knowledge_from_file(
-                "code_creator", _path
+            self._knowledge = await load_knowledge_from_file(
+                "code_creator", self._config
             )
 
         function_name = function_name.split("=")[-1]
diff --git a/wafl/connectors/bridges/llm_generated_answer_bridge.py b/wafl/connectors/bridges/llm_generated_answer_bridge.py
new file mode 100644
index 00000000..7981233e
--- /dev/null
+++ b/wafl/connectors/bridges/llm_generated_answer_bridge.py
@@ -0,0 +1,19 @@
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
+
+
+class LLMGeneratedAnswerBridge:
+    def __init__(self, config=None):
+        self._connector = LLMConnectorFactory.get_connector(config)
+
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
+    async def _get_answer_prompt(self, text, query, dialogue=None):
+        prompt = (
+            f"The user looks for an answer to the question:\n"
+            f"Q: {query}\n"
+            f"A: I believe"
+        )
+
+        return prompt
diff --git a/wafl/connectors/bridges/llm_prompt_predictor_bridge.py b/wafl/connectors/bridges/llm_prompt_predictor_bridge.py
new file mode 100644
index 00000000..ea46a9f4
--- /dev/null
+++ b/wafl/connectors/bridges/llm_prompt_predictor_bridge.py
@@ -0,0 +1,23 @@
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
+
+
+class LLMPromptPredictorBridge:
+    def __init__(self, config):
+        self._connector = LLMConnectorFactory.get_connector(config)
+
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
+    async def _get_answer_prompt(self, text, query, dialogue=None):
+        for _ in range(5):
+            text = text.replace("  ", " ")
+
+        prompt = f"""
+<task>
+Complete the following task and add <|EOS|> at the end: {text}
+</task>
+<result>
+        """.strip()
+
+        return prompt
diff --git a/wafl/connectors/llm_qa_connector.py b/wafl/connectors/bridges/llm_qa_bridge.py
similarity index 69%
rename from wafl/connectors/llm_qa_connector.py
rename to wafl/connectors/bridges/llm_qa_bridge.py
index c1d48bfb..c88eed51 100644
--- a/wafl/connectors/llm_qa_connector.py
+++ b/wafl/connectors/bridges/llm_qa_bridge.py
@@ -1,15 +1,17 @@
 import asyncio
 import os
 
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.bridges.bridge_implementation import load_knowledge_from_file
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMQAConnector(RemoteLLMConnector):
+class LLMQABridge:
     def __init__(self, config):
-        super().__init__(config)
+        self._connector = LLMConnectorFactory.get_connector(config)
+        self._config = config
         try:
             loop = asyncio.get_running_loop()
 
@@ -21,18 +23,22 @@ def __init__(self, config):
             self._adversarial_knowledge = None
 
         else:
-            self._knowledge = asyncio.run(self._load_knowledge_from_file("qa", _path))
+            self._knowledge = asyncio.run(load_knowledge_from_file("qa", self._config))
             self._adversarial_knowledge = asyncio.run(
-                self._load_knowledge_from_file("qa_adversarial", _path)
+                load_knowledge_from_file("qa_adversarial", self._config)
             )
 
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
     async def _get_answer_prompt(self, text, query, dialogue=None):
         if not self._knowledge:
-            self._knowledge = await self._load_knowledge_from_file("qa", _path)
+            self._knowledge = await load_knowledge_from_file("qa", _path)
 
         if not self._adversarial_knowledge:
-            self._adversarial_knowledge = await self._load_knowledge_from_file(
-                "qa_adversarial", _path
+            self._adversarial_knowledge = await load_knowledge_from_file(
+                "qa_adversarial", self._config
             )
 
         text = text.strip()
diff --git a/wafl/connectors/llm_task_creator_connector.py b/wafl/connectors/bridges/llm_task_creator_bridge.py
similarity index 67%
rename from wafl/connectors/llm_task_creator_connector.py
rename to wafl/connectors/bridges/llm_task_creator_bridge.py
index a338ba0a..29a6dda8 100644
--- a/wafl/connectors/llm_task_creator_connector.py
+++ b/wafl/connectors/bridges/llm_task_creator_bridge.py
@@ -1,15 +1,17 @@
 import asyncio
 import os
 
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.bridges.bridge_implementation import load_knowledge_from_file
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMTaskCreatorConnector(RemoteLLMConnector):
+class LLMTaskCreatorBridge:
     def __init__(self, config=None):
-        super().__init__(config)
+        self._connector = LLMConnectorFactory.get_connector(config)
+        self._config = config
         try:
             loop = asyncio.get_running_loop()
 
@@ -21,13 +23,17 @@ def __init__(self, config=None):
 
         else:
             self._knowledge = asyncio.run(
-                self._load_knowledge_from_file("task_creator", _path)
+                load_knowledge_from_file("task_creator", self._config)
             )
 
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
     async def _get_answer_prompt(self, text: str, task: str, triggers: str = None):
         if self._knowledge is None:
-            self._knowledge = await self._load_knowledge_from_file(
-                "task_creator", _path
+            self._knowledge = await load_knowledge_from_file(
+                "task_creator", self._config
             )
 
         retrieved_items = await self._knowledge.ask_for_facts(
diff --git a/wafl/connectors/llm_task_extractor_connector.py b/wafl/connectors/bridges/llm_task_extractor_bridge.py
similarity index 68%
rename from wafl/connectors/llm_task_extractor_connector.py
rename to wafl/connectors/bridges/llm_task_extractor_bridge.py
index 1e643d42..69fb60cf 100644
--- a/wafl/connectors/llm_task_extractor_connector.py
+++ b/wafl/connectors/bridges/llm_task_extractor_bridge.py
@@ -1,16 +1,17 @@
 import asyncio
 import os
 
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.bridges.bridge_implementation import load_knowledge_from_file
+from wafl.connectors.factories.llm_connector_factory import LLMConnectorFactory
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
 
 
-class LLMTaskExtractorConnector(RemoteLLMConnector):
+class LLMTaskExtractorBridge:
     def __init__(self, config=None):
-        super().__init__(config)
-
+        self._connector = LLMConnectorFactory.get_connector(config)
+        self._config = config
         try:
             loop = asyncio.get_running_loop()
 
@@ -23,21 +24,25 @@ def __init__(self, config=None):
 
         else:
             self._knowledge = asyncio.run(
-                self._load_knowledge_from_file("task_extractor", _path)
+                load_knowledge_from_file("task_extractor", self._config)
             )
             self._adversarial_knowledge = asyncio.run(
-                self._load_knowledge_from_file("task_extractor_adversarial", _path)
+                load_knowledge_from_file("task_extractor_adversarial", self._config)
             )
 
+    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+        prompt = await self._get_answer_prompt(text, query, dialogue)
+        return await self._connector.generate(prompt)
+
     async def _get_answer_prompt(self, text: str, query: str, dialogue: str = None):
         if self._knowledge is None:
-            self._knowledge = await self._load_knowledge_from_file(
-                "task_extractor", _path
+            self._knowledge = await load_knowledge_from_file(
+                "task_extractor", self._config
             )
 
         if self._adversarial_knowledge is None:
-            self._adversarial_knowledge = await self._load_knowledge_from_file(
-                "task_extractor_adversarial", _path
+            self._adversarial_knowledge = await load_knowledge_from_file(
+                "task_extractor_adversarial", self._config
             )
 
         retrieved_items = await self._knowledge.ask_for_facts_with_threshold(
diff --git a/wafl/connectors/dialogue.py b/wafl/connectors/dialogue.py
deleted file mode 100644
index d5c1a472..00000000
--- a/wafl/connectors/dialogue.py
+++ /dev/null
@@ -1,15 +0,0 @@
-class Dialogue:
-    def __init__(self):
-        self._dialogue_pairs = []
-
-    def add_dialogue_pair(self, query: str, answer: str) -> "Dialogue":
-        self._dialogue_pairs.append((query, answer))
-        return self
-
-    def get_text(self) -> str:
-        text = ""
-        for query, answer in self._dialogue_pairs:
-            text += f"Q: {query}\n"
-            text += f"A: {answer}\n"
-
-        return text
diff --git a/wafl/connectors/factories/__init__.py b/wafl/connectors/factories/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/connectors/entailment_connector_factory.py b/wafl/connectors/factories/entailment_connector_factory.py
similarity index 64%
rename from wafl/connectors/entailment_connector_factory.py
rename to wafl/connectors/factories/entailment_connector_factory.py
index f1855e71..0e1fb063 100644
--- a/wafl/connectors/entailment_connector_factory.py
+++ b/wafl/connectors/factories/entailment_connector_factory.py
@@ -1,5 +1,5 @@
-from wafl.connectors.local_entailment_connector import LocalEntailmentConnector
-from wafl.connectors.remote_entailment_connector import RemoteEntailmentConnector
+from wafl.connectors.local.local_entailment_connector import LocalEntailmentConnector
+from wafl.connectors.remote.remote_entailment_connector import RemoteEntailmentConnector
 
 
 class EntailmentConnectorFactory:
diff --git a/wafl/connectors/llm_connector_factory.py b/wafl/connectors/factories/llm_connector_factory.py
similarity index 64%
rename from wafl/connectors/llm_connector_factory.py
rename to wafl/connectors/factories/llm_connector_factory.py
index dd9736c5..b04c5dee 100644
--- a/wafl/connectors/llm_connector_factory.py
+++ b/wafl/connectors/factories/llm_connector_factory.py
@@ -1,5 +1,5 @@
-from wafl.connectors.local_llm_connector import LocalLLMConnector
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.local.local_llm_connector import LocalLLMConnector
+from wafl.connectors.remote.remote_llm_connector import RemoteLLMConnector
 
 
 class LLMConnectorFactory:
diff --git a/wafl/connectors/sentence_embedder_connector_factory.py b/wafl/connectors/factories/sentence_embedder_connector_factory.py
similarity index 75%
rename from wafl/connectors/sentence_embedder_connector_factory.py
rename to wafl/connectors/factories/sentence_embedder_connector_factory.py
index 229c86ce..08925aa7 100644
--- a/wafl/connectors/sentence_embedder_connector_factory.py
+++ b/wafl/connectors/factories/sentence_embedder_connector_factory.py
@@ -1,7 +1,7 @@
-from wafl.connectors.local_sentence_embedder_connector import (
+from wafl.connectors.local.local_sentence_embedder_connector import (
     LocalSentenceEmbedderConnector,
 )
-from wafl.connectors.remote_sentence_embedder_connector import (
+from wafl.connectors.remote.remote_sentence_embedder_connector import (
     RemoteSentenceEmbedderConnector,
 )
 
diff --git a/wafl/connectors/speaker_connector_factory.py b/wafl/connectors/factories/speaker_connector_factory.py
similarity index 64%
rename from wafl/connectors/speaker_connector_factory.py
rename to wafl/connectors/factories/speaker_connector_factory.py
index e6b9d983..8414e6b4 100644
--- a/wafl/connectors/speaker_connector_factory.py
+++ b/wafl/connectors/factories/speaker_connector_factory.py
@@ -1,5 +1,5 @@
-from wafl.connectors.local_speaker_connector import LocalSpeakerConnector
-from wafl.connectors.remote_speaker_connector import RemoteSpeakerConnector
+from wafl.connectors.local.local_speaker_connector import LocalSpeakerConnector
+from wafl.connectors.remote.remote_speaker_connector import RemoteSpeakerConnector
 
 
 class SpeakerConnectorFactory:
diff --git a/wafl/connectors/whisper_connector_factory.py b/wafl/connectors/factories/whisper_connector_factory.py
similarity index 64%
rename from wafl/connectors/whisper_connector_factory.py
rename to wafl/connectors/factories/whisper_connector_factory.py
index 18d1348c..f3b7b255 100644
--- a/wafl/connectors/whisper_connector_factory.py
+++ b/wafl/connectors/factories/whisper_connector_factory.py
@@ -1,5 +1,5 @@
-from wafl.connectors.local_whisper_connector import LocalWhisperConnector
-from wafl.connectors.remote_whisper_connector import RemoteWhisperConnector
+from wafl.connectors.local.local_whisper_connector import LocalWhisperConnector
+from wafl.connectors.remote.remote_whisper_connector import RemoteWhisperConnector
 
 
 class WhisperConnectorFactory:
diff --git a/wafl/connectors/llm_generated_answer_connector.py b/wafl/connectors/llm_generated_answer_connector.py
deleted file mode 100644
index 2b022771..00000000
--- a/wafl/connectors/llm_generated_answer_connector.py
+++ /dev/null
@@ -1,15 +0,0 @@
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
-
-
-class LLMGeneratedAnswerConnector(RemoteLLMConnector):
-    def __init__(self, config=None):
-        super().__init__(config)
-
-    async def _get_answer_prompt(self, text, query, dialogue=None):
-        prompt = (
-            f"The user looks for an answer to the question:\n"
-            f"Q: {query}\n"
-            f"A: I believe"
-        )
-
-        return prompt
diff --git a/wafl/connectors/llm_prompt_predictor_connector.py b/wafl/connectors/llm_prompt_predictor_connector.py
deleted file mode 100644
index 618f0ac2..00000000
--- a/wafl/connectors/llm_prompt_predictor_connector.py
+++ /dev/null
@@ -1,19 +0,0 @@
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
-
-
-class LLMPromptPredictorConnector(RemoteLLMConnector):
-    def __init__(self, config):
-        super().__init__(config)
-
-    async def _get_answer_prompt(self, text, query, dialogue=None):
-        for _ in range(5):
-            text = text.replace("  ", " ")
-
-        prompt = f"""
-<task>
-Complete the following task and add <|EOS|> at the end: {text}
-</task>
-<result>
-        """.strip()
-
-        return prompt
diff --git a/wafl/connectors/local/__init__.py b/wafl/connectors/local/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/connectors/local_entailment_connector.py b/wafl/connectors/local/local_entailment_connector.py
similarity index 100%
rename from wafl/connectors/local_entailment_connector.py
rename to wafl/connectors/local/local_entailment_connector.py
diff --git a/wafl/connectors/local_llm_connector.py b/wafl/connectors/local/local_llm_connector.py
similarity index 100%
rename from wafl/connectors/local_llm_connector.py
rename to wafl/connectors/local/local_llm_connector.py
diff --git a/wafl/connectors/local_sentence_embedder_connector.py b/wafl/connectors/local/local_sentence_embedder_connector.py
similarity index 100%
rename from wafl/connectors/local_sentence_embedder_connector.py
rename to wafl/connectors/local/local_sentence_embedder_connector.py
diff --git a/wafl/connectors/local_speaker_connector.py b/wafl/connectors/local/local_speaker_connector.py
similarity index 100%
rename from wafl/connectors/local_speaker_connector.py
rename to wafl/connectors/local/local_speaker_connector.py
diff --git a/wafl/connectors/local_whisper_connector.py b/wafl/connectors/local/local_whisper_connector.py
similarity index 100%
rename from wafl/connectors/local_whisper_connector.py
rename to wafl/connectors/local/local_whisper_connector.py
diff --git a/wafl/connectors/remote/__init__.py b/wafl/connectors/remote/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/connectors/remote_entailment_connector.py b/wafl/connectors/remote/remote_entailment_connector.py
similarity index 100%
rename from wafl/connectors/remote_entailment_connector.py
rename to wafl/connectors/remote/remote_entailment_connector.py
diff --git a/wafl/connectors/remote_llm_answer_policy_connector.py b/wafl/connectors/remote/remote_llm_answer_policy_connector.py
similarity index 95%
rename from wafl/connectors/remote_llm_answer_policy_connector.py
rename to wafl/connectors/remote/remote_llm_answer_policy_connector.py
index 135c9bf8..7a7caa56 100644
--- a/wafl/connectors/remote_llm_answer_policy_connector.py
+++ b/wafl/connectors/remote/remote_llm_answer_policy_connector.py
@@ -1,4 +1,4 @@
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.remote.remote_llm_connector import RemoteLLMConnector
 
 
 class RemoteLLMAnswerPolicyConnector(RemoteLLMConnector):
diff --git a/wafl/connectors/remote_llm_chitchat_answer_connector.py b/wafl/connectors/remote/remote_llm_chitchat_answer_connector.py
similarity index 95%
rename from wafl/connectors/remote_llm_chitchat_answer_connector.py
rename to wafl/connectors/remote/remote_llm_chitchat_answer_connector.py
index b63a5cc1..89624de2 100644
--- a/wafl/connectors/remote_llm_chitchat_answer_connector.py
+++ b/wafl/connectors/remote/remote_llm_chitchat_answer_connector.py
@@ -2,7 +2,7 @@
 import os
 import re
 
-from wafl.connectors.remote_llm_connector import RemoteLLMConnector
+from wafl.connectors.remote.remote_llm_connector import RemoteLLMConnector
 from wafl.extractors.dataclasses import Query
 
 _path = os.path.dirname(__file__)
diff --git a/wafl/connectors/remote_llm_connector.py b/wafl/connectors/remote/remote_llm_connector.py
similarity index 80%
rename from wafl/connectors/remote_llm_connector.py
rename to wafl/connectors/remote/remote_llm_connector.py
index 9416a942..7c206258 100644
--- a/wafl/connectors/remote_llm_connector.py
+++ b/wafl/connectors/remote/remote_llm_connector.py
@@ -52,10 +52,9 @@ async def predict(self, prompt: str) -> str:
 
         return "UNKNOWN"
 
-    async def get_answer(self, text: str, dialogue: str, query: str) -> str:
+    async def generate(self, prompt: str) -> str:
         print(__name__)
         start_time = time.time()
-        prompt = await self._get_answer_prompt(text, query, dialogue)
         if prompt in self._cache:
             print(time.time() - start_time)
             return self._cache[prompt]
@@ -111,18 +110,4 @@ async def check_connection(self):
             print("Please run 'bash start-llm.sh' (see docs for explanation).")
             print()
 
-        return False
-
-    async def _get_answer_prompt(self, text, query, dialogue=None):
-        raise NotImplementedError("_get_answer_prompt() needs to be implemented.")
-
-    async def _load_knowledge_from_file(self, filename, _path=None):
-        items_list = []
-        with open(os.path.join(_path, f"../data/{filename}.csv")) as file:
-            csvreader = csv.reader(file)
-            for row in csvreader:
-                items_list.append(row[0].strip())
-
-        knowledge = await SingleFileKnowledge.create_from_list(items_list)
-        joblib.dump(knowledge, os.path.join(_path, f"../data/{filename}.knowledge"))
-        return knowledge
+        return False
\ No newline at end of file
diff --git a/wafl/connectors/remote_sentence_embedder_connector.py b/wafl/connectors/remote/remote_sentence_embedder_connector.py
similarity index 100%
rename from wafl/connectors/remote_sentence_embedder_connector.py
rename to wafl/connectors/remote/remote_sentence_embedder_connector.py
diff --git a/wafl/connectors/remote_speaker_connector.py b/wafl/connectors/remote/remote_speaker_connector.py
similarity index 100%
rename from wafl/connectors/remote_speaker_connector.py
rename to wafl/connectors/remote/remote_speaker_connector.py
diff --git a/wafl/connectors/remote_whisper_connector.py b/wafl/connectors/remote/remote_whisper_connector.py
similarity index 100%
rename from wafl/connectors/remote_whisper_connector.py
rename to wafl/connectors/remote/remote_whisper_connector.py
diff --git a/wafl/events/conversation_events.py b/wafl/events/conversation_events.py
index 814a9e99..4ec0d226 100644
--- a/wafl/events/conversation_events.py
+++ b/wafl/events/conversation_events.py
@@ -1,7 +1,6 @@
 import os
 import re
 
-from wafl.connectors.local_llm_connector import LocalLLMConnector
 from wafl.events.answerer_creator import create_answerer
 from wafl.policy.answerer_policy import AnswerPolicy
 from wafl.simple_text_processing.normalize import normalized
diff --git a/wafl/extractors/code_creator.py b/wafl/extractors/code_creator.py
index a21f7926..94a38a51 100644
--- a/wafl/extractors/code_creator.py
+++ b/wafl/extractors/code_creator.py
@@ -1,8 +1,8 @@
 import logging
 import os
 
-from wafl.connectors.llm_code_creator_connector import LLMCodeCreatorConnector
-from wafl.extractors.dataclasses import Answer, Query
+from wafl.connectors.bridges.llm_code_creator_bridge import LLMCodeCreatorBridge
+from wafl.extractors.dataclasses import Answer
 from wafl.extractors.utils import get_function_description, get_code
 
 _path = os.path.dirname(__file__)
@@ -11,7 +11,7 @@
 
 class CodeCreator:
     def __init__(self, config, knowledge, logger=None):
-        self._connector = LLMCodeCreatorConnector(config.get_value("llm_model"))
+        self._connector = LLMCodeCreatorBridge(config)
         self._knowledge = knowledge
 
     async def extract(self, function_and_task: str) -> Answer:
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index 7733d1ce..5afc0e59 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -1,6 +1,6 @@
 from typing import Dict, Union
 
-from wafl.connectors.entailment_connector_factory import EntailmentConnectorFactory
+from wafl.connectors.factories.entailment_connector_factory import EntailmentConnectorFactory
 
 
 class Entailer:
diff --git a/wafl/extractors/extractor.py b/wafl/extractors/extractor.py
index 263bf15b..a56e5320 100644
--- a/wafl/extractors/extractor.py
+++ b/wafl/extractors/extractor.py
@@ -1,8 +1,7 @@
 import logging
 import os
 
-from wafl.connectors.llm_qa_connector import LLMQAConnector
-from wafl.connectors.dialogue import Dialogue
+from wafl.connectors.bridges.llm_qa_bridge import LLMQABridge
 from wafl.simple_text_processing.questions import (
     is_question,
     is_yes_no_question,
@@ -19,7 +18,7 @@
 class Extractor:
     def __init__(self, config, narrator, logger=None):
         self._entailer = Entailer(config, logger)
-        self._qa = LLMQAConnector(config.get_value("llm_model"))
+        self._qa = LLMQABridge(config)
         self._narrator = narrator
         self._logger = logger
         self._entailer_to_qa_mapping = {
@@ -52,9 +51,7 @@ async def extract(self, query: "Query", text: str, task_memory=None):
         return await self._check_fact(query_text, text, query.variable, threshold=0.5)
 
     async def _answer_question(self, query_text, variable_name, text: str, task_memory):
-        dialogue = Dialogue()
-
-        answer = await self._get_answer(text, dialogue.get_text(), query_text)
+        answer = await self._get_answer(text, "", query_text)
         if answer and answer[-1] in [".", ",", "!"]:
             answer = answer[:-1]
 
@@ -70,9 +67,8 @@ async def _check_fact(self, query_text, text, variable_name, threshold):
                 text=self._entailer_to_qa_mapping[answer], variable=variable_name
             )
 
-        dialogue = Dialogue()
         answer_text = normalized(
-            await self._qa.get_answer(query_text, dialogue.get_text(), text)
+            await self._qa.get_answer(query_text, "", text)
         )
         if answer_text != "unknown" and answer_text != "no":
             return Answer(text="Yes", variable=variable_name)
diff --git a/wafl/extractors/prompt_predictor.py b/wafl/extractors/prompt_predictor.py
index 6d2028e6..18c8c4e6 100644
--- a/wafl/extractors/prompt_predictor.py
+++ b/wafl/extractors/prompt_predictor.py
@@ -1,7 +1,7 @@
 import logging
 import os
 
-from wafl.connectors.llm_prompt_predictor_connector import LLMPromptPredictorConnector
+from wafl.connectors.bridges.llm_prompt_predictor_bridge import LLMPromptPredictorBridge
 from wafl.extractors.dataclasses import Answer
 
 _path = os.path.dirname(__file__)
@@ -10,7 +10,7 @@
 
 class PromptPredictor:
     def __init__(self, config, logger=None):
-        self._model = LLMPromptPredictorConnector(config.get_value("llm_model"))
+        self._model = LLMPromptPredictorBridge(config)
         self._closing_tag = "</result>"
 
     async def predict(self, prompt: str):
diff --git a/wafl/extractors/task_creator.py b/wafl/extractors/task_creator.py
index 1e6d5b76..141fef71 100644
--- a/wafl/extractors/task_creator.py
+++ b/wafl/extractors/task_creator.py
@@ -1,7 +1,7 @@
 import logging
 import os
 
-from wafl.connectors.llm_task_creator_connector import LLMTaskCreatorConnector
+from wafl.connectors.bridges.llm_task_creator_bridge import LLMTaskCreatorBridge
 from wafl.extractors.dataclasses import Answer, Query
 
 _path = os.path.dirname(__file__)
@@ -10,7 +10,7 @@
 
 class TaskCreator:
     def __init__(self, config, knowledge, logger=None):
-        self._connector = LLMTaskCreatorConnector(config.get_value("llm_model"))
+        self._connector = LLMTaskCreatorBridge(config)
         self._knowledge = knowledge
         self._logger = logger
 
diff --git a/wafl/extractors/task_extractor.py b/wafl/extractors/task_extractor.py
index 3325a1de..d173f59b 100644
--- a/wafl/extractors/task_extractor.py
+++ b/wafl/extractors/task_extractor.py
@@ -1,7 +1,7 @@
 import logging
 import os
 
-from wafl.connectors.llm_task_extractor_connector import LLMTaskExtractorConnector
+from wafl.connectors.bridges.llm_task_extractor_bridge import LLMTaskExtractorBridge
 from wafl.extractors.dataclasses import Answer
 
 _path = os.path.dirname(__file__)
@@ -11,7 +11,7 @@
 class TaskExtractor:
     def __init__(self, config, interface, logger=None):
         self._interface = interface
-        self._connector = LLMTaskExtractorConnector(config.get_value("llm_model"))
+        self._connector = LLMTaskExtractorBridge(config)
         self._max_num_past_utterances = 3
         self._to_ignore = ["yes", "no", "ok", "okay", "sure", "nope", "yep", "you"]
 
diff --git a/wafl/listener/whisper_listener.py b/wafl/listener/whisper_listener.py
index 7b6d19d5..1572d919 100644
--- a/wafl/listener/whisper_listener.py
+++ b/wafl/listener/whisper_listener.py
@@ -6,7 +6,7 @@
 import numpy as np
 import torch.cuda
 
-from wafl.connectors.whisper_connector_factory import WhisperConnectorFactory
+from wafl.connectors.factories.whisper_connector_factory import WhisperConnectorFactory
 
 device = "cuda" if torch.cuda.is_available() else "cpu"
 
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index b50f3544..e96970c2 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -1,4 +1,4 @@
-from wafl.connectors.remote_llm_answer_policy_connector import (
+from wafl.connectors.remote.remote_llm_answer_policy_connector import (
     RemoteLLMAnswerPolicyConnector,
 )
 
diff --git a/wafl/retriever/dense_retriever.py b/wafl/retriever/dense_retriever.py
index 31881af1..b12ff63d 100644
--- a/wafl/retriever/dense_retriever.py
+++ b/wafl/retriever/dense_retriever.py
@@ -3,7 +3,7 @@
 
 from typing import List, Tuple
 from gensim.models import KeyedVectors
-from wafl.connectors.sentence_embedder_connector_factory import (
+from wafl.connectors.factories.sentence_embedder_connector_factory import (
     SentenceEmbedderConnectorFactory,
 )
 from wafl.retriever.base_retriever import BaseRetriever
diff --git a/wafl/speaker/fairseq_speaker.py b/wafl/speaker/fairseq_speaker.py
index 85a80b78..128f08d9 100644
--- a/wafl/speaker/fairseq_speaker.py
+++ b/wafl/speaker/fairseq_speaker.py
@@ -1,7 +1,7 @@
 import asyncio
 import pyaudio
 
-from wafl.connectors.speaker_connector_factory import SpeakerConnectorFactory
+from wafl.connectors.factories.speaker_connector_factory import SpeakerConnectorFactory
 from wafl.speaker.base_speaker import BaseSpeaker
 from wafl.speaker.utils import convert_numbers_to_words
 

From 4a2e06bcd6521afb966c9dc9f768952708243f78 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Mon, 21 Aug 2023 18:14:47 +0100
Subject: [PATCH 20/29] updated arbiter tests

---
 tests/test_arbiter_answerer.py | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/tests/test_arbiter_answerer.py b/tests/test_arbiter_answerer.py
index 3982a9d3..15ad7472 100644
--- a/tests/test_arbiter_answerer.py
+++ b/tests/test_arbiter_answerer.py
@@ -4,6 +4,7 @@
 from unittest import TestCase
 
 from wafl.answerer.arbiter_answerer import ArbiterAnswerer
+from wafl.config import Configuration
 from wafl.events.answerer_creator import create_answerer
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
@@ -23,8 +24,9 @@
 class TestArbiterAnswerer(TestCase):
     def test_generated_answer_from_conversation(self):
         interface = DummyInterface(["what the color of the sky?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_rules),
+            SingleFileKnowledge(config, _wafl_rules),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -34,8 +36,9 @@ def test_generated_answer_from_conversation(self):
 
     def test_generated_answer_from_conversation2(self):
         interface = DummyInterface(["what is the capital of Italy?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_rules),
+            SingleFileKnowledge(config, _wafl_rules),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -46,8 +49,9 @@ def test_generated_answer_from_conversation3(self):
         interface = DummyInterface(
             ["what is the capital of Italy .", "how tall is Micheal Jordan"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_rules),
+            SingleFileKnowledge(config, _wafl_rules),
             interface=interface,
         )
         asyncio.run(interface.output("Please say computer to activate me."))
@@ -59,8 +63,9 @@ def test_generated_answer_from_conversation3(self):
 
     def test_fact_answer(self):
         interface = DummyInterface(["What is the name of this bot"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_rules),
+            SingleFileKnowledge(config, _wafl_rules),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -70,8 +75,9 @@ def test_fact_answer(self):
 
     def test_chitchat(self):
         interface = DummyInterface(["good good"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_rules),
+            SingleFileKnowledge(config, _wafl_rules),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -80,8 +86,9 @@ def test_chitchat(self):
 
     def test__conversation_input_returns_chitchat_for_trivial_input(self):
         interface = DummyInterface(["uhm what"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(""), interface=interface
+            SingleFileKnowledge(config, ""), interface=interface
         )
         asyncio.run(interface.output("say hello"))
         asyncio.run(conversation_events.process_next())

From 36e823fe4f94ceaeb9613b2729d1c606af66d7e6 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Wed, 23 Aug 2023 10:51:28 +0100
Subject: [PATCH 21/29] resolved more tests configuration issues

---
 tests/test_closing_conversation.py   | 11 ++++++++---
 tests/test_commonsense_entailment.py |  6 ++++--
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/tests/test_closing_conversation.py b/tests/test_closing_conversation.py
index f9905188..e2f0e9f9 100644
--- a/tests/test_closing_conversation.py
+++ b/tests/test_closing_conversation.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.exceptions import CloseConversation
 from wafl.interface.dummy_interface import DummyInterface
@@ -33,8 +35,9 @@ def test__good_bye_closes_conversation(self):
                 "Goodbye.",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -53,8 +56,9 @@ def test__thank_you_closes_conversation(self):
                 "Thank you",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -73,8 +77,9 @@ def test__thanks_closes_conversation(self):
                 "Thanks.",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_commonsense_entailment.py b/tests/test_commonsense_entailment.py
index 68a5208a..fb886029 100644
--- a/tests/test_commonsense_entailment.py
+++ b/tests/test_commonsense_entailment.py
@@ -43,8 +43,9 @@ def test__sentences_can_filter_items_positive2(self):
                 "Please add bananas to the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -58,8 +59,9 @@ def test__sentences_can_filter_items_negative(self):
                 "Please add skyscrapers to the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )

From 5c5372b12e40daeef2dddae7d571ad2703f0e570 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 11:35:26 +0100
Subject: [PATCH 22/29] using config over all the tests

---
 ...plaination_happens_when_answer_is_false.py |  5 ++-
 tests/{test_pronouns.py => test_deixis.py}    |  2 +-
 tests/test_dependencies.py                    | 29 ++++++++++-----
 tests/test_edge_cases.py                      | 12 ++++--
 tests/test_empty_input.py                     |  8 +++-
 tests/test_entailment.py                      | 11 ++++--
 tests/test_entailment_in_rules.py             |  4 +-
 tests/test_events.py                          | 13 +++++--
 tests/test_exceptions.py                      |  5 ++-
 tests/test_executables.py                     | 29 ++++++++++-----
 tests/test_generation.py                      |  8 +++-
 tests/test_greetings.py                       |  8 +++-
 tests/test_inference.py                       | 30 +++++++++++----
 tests/test_interruptions.py                   | 14 +++++--
 tests/test_knowledge.py                       |  5 ++-
 tests/test_list_type.py                       |  5 ++-
 tests/test_lists.py                           | 17 ++++++---
 tests/test_natural_language_in_functions.py   | 11 ++++--
 tests/test_negations.py                       | 11 ++++--
 tests/test_parsing.py                         |  8 +++-
 tests/test_policy.py                          |  7 +++-
 tests/test_preprocessing.py                   |  5 ++-
 tests/test_question_in_rule_trigger.py        | 11 ++++--
 tests/test_questions.py                       |  9 +++--
 tests/test_questions_in_prior_conversation.py |  8 +++-
 tests/test_questions_to_statements.py         |  5 ++-
 tests/test_recursion_in_python_space.py       |  5 ++-
 tests/test_reminders.py                       |  9 ++++-
 tests/test_retrieval.py                       | 14 +++++--
 tests/test_rules_creation.py                  |  5 ++-
 tests/test_scheduler.py                       |  9 +++--
 tests/test_shopping_example.py                |  8 +++-
 tests/test_speaker.py                         | 11 ++++--
 tests/test_task_creation.py                   | 37 ++++++++++++-------
 tests/test_task_extraction.py                 | 14 +++++--
 tests/test_task_lists.py                      |  4 +-
 tests/test_task_memory.py                     | 26 +++++++++----
 tests/test_testcases.py                       | 14 +++++--
 tests/test_voice.py                           | 23 ++++++++----
 .../bridges/llm_code_creator_bridge.py        |  2 +-
 wafl/connectors/bridges/llm_qa_bridge.py      |  2 +-
 .../bridges/llm_task_creator_bridge.py        |  2 +-
 .../factories/speaker_connector_factory.py    |  2 +-
 .../factories/whisper_connector_factory.py    |  2 +-
 .../local/local_speaker_connector.py          |  2 +-
 .../remote/remote_speaker_connector.py        |  4 +-
 wafl/events/generated_events.py               |  3 +-
 wafl/inference/backward_inference.py          |  2 -
 wafl/interface/voice_interface.py             |  4 +-
 wafl/knowledge/project_knowledge.py           | 11 +++---
 wafl/speaker/fairseq_speaker.py               |  2 +-
 wafl/testcases.py                             |  4 +-
 52 files changed, 349 insertions(+), 152 deletions(-)
 rename tests/{test_pronouns.py => test_deixis.py} (93%)

diff --git a/tests/test__explaination_happens_when_answer_is_false.py b/tests/test__explaination_happens_when_answer_is_false.py
index dd6e218f..d3daef58 100644
--- a/tests/test__explaination_happens_when_answer_is_false.py
+++ b/tests/test__explaination_happens_when_answer_is_false.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.exceptions import CloseConversation
 from wafl.interface.dummy_interface import DummyInterface
@@ -28,8 +30,9 @@
 class TestInterruptions(TestCase):
     def test_time_shut_up_does_not_interrupt_if_it_contraddicts_facts(self):
         interface = DummyInterface(["Hello", "shut up"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
             logger=_logger,
diff --git a/tests/test_pronouns.py b/tests/test_deixis.py
similarity index 93%
rename from tests/test_pronouns.py
rename to tests/test_deixis.py
index 2bffad2f..f333c869 100644
--- a/tests/test_pronouns.py
+++ b/tests/test_deixis.py
@@ -3,7 +3,7 @@
 from wafl.simple_text_processing.deixis import from_user_to_bot, from_bot_to_user
 
 
-class TestInference(TestCase):
+class TestDeixis(TestCase):
     def test_from_user_to_bot(self):
         translation = from_user_to_bot("You are called computer")
         expected = "this bot is called computer"
diff --git a/tests/test_dependencies.py b/tests/test_dependencies.py
index 5003a23c..8d8ea6bc 100644
--- a/tests/test_dependencies.py
+++ b/tests/test_dependencies.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.project_knowledge import ProjectKnowledge
@@ -40,7 +42,8 @@ def test__knowledge_dictionary_is_populated(self):
         with open(tmp_filename, "w") as file:
             file.write(wafl_dependency)
 
-        knowledge = ProjectKnowledge(tmp_filename)
+        config = Configuration.load_local_config()
+        knowledge = ProjectKnowledge(config, tmp_filename)
         expected = [
             "/",
             "/greetings",
@@ -56,7 +59,8 @@ def test__rules_are_called_from_dependency_list(self):
             file.write(wafl_dependency)
 
         interface = DummyInterface(to_utter=["Hello", "albert"])
-        knowledge = ProjectKnowledge(tmp_filename)
+        config = Configuration.load_local_config()
+        knowledge = ProjectKnowledge(config, tmp_filename)
         conversation_events = ConversationEvents(
             knowledge, interface=interface, code_path=knowledge.get_dependencies_list()
         )
@@ -74,8 +78,9 @@ def test__facts_are_answered_from_dependency_list_one_level_deep(self):
                 "How are you doing",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge(tmp_filename), interface=interface
+            ProjectKnowledge(config, tmp_filename), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "well"
@@ -92,8 +97,9 @@ def test__facts_are_answered_from_dependency_list_two_levels_deep(self):
                 "how is the sun",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge(tmp_filename), interface=interface
+            ProjectKnowledge(config, tmp_filename), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "shin"
@@ -110,9 +116,10 @@ def test__functions_can_be_called_from_a_dependency(self):
                 "What time is it",
             ]
         )
-        knowledge = ProjectKnowledge(tmp_filename)
+        config = Configuration.load_local_config()
+        knowledge = ProjectKnowledge(config, tmp_filename)
         conversation_events = ConversationEvents(
-            ProjectKnowledge(tmp_filename),
+            knowledge,
             interface=interface,
             code_path=knowledge.get_dependencies_list(),
         )
@@ -130,9 +137,10 @@ def test__functions_can_be_called_from_a_2_level_deep_dependency(self):
                 "My name is Alberto",
             ]
         )
-        knowledge = ProjectKnowledge(tmp_filename)
+        config = Configuration.load_local_config()
+        knowledge = ProjectKnowledge(config, tmp_filename)
         conversation_events = ConversationEvents(
-            ProjectKnowledge(tmp_filename),
+            knowledge=knowledge,
             interface=interface,
             code_path=knowledge.get_dependencies_list(),
         )
@@ -151,9 +159,10 @@ def test__rules_can_be_imported_using_prior_folders(self):
                 "My name is Maria",
             ]
         )
-        knowledge = ProjectKnowledge(tmp_filename)
+        config = Configuration.load_local_config()
+        knowledge = ProjectKnowledge(config, tmp_filename)
         conversation_events = ConversationEvents(
-            ProjectKnowledge(tmp_filename),
+            knowledge,
             interface=interface,
             code_path=knowledge.get_dependencies_list(),
         )
diff --git a/tests/test_edge_cases.py b/tests/test_edge_cases.py
index a8b0308c..8fd6622f 100644
--- a/tests/test_edge_cases.py
+++ b/tests/test_edge_cases.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -125,8 +127,9 @@
 class TestEdgeCases(TestCase):
     def test__double_lower_case_questions_are_answered_correctly(self):
         interface = DummyInterface(["is the jubile line running"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_tube_line_rules),
+            SingleFileKnowledge(config, _tube_line_rules),
             interface=interface,
             code_path="/",
             logger=_logger,
@@ -136,8 +139,9 @@ def test__double_lower_case_questions_are_answered_correctly(self):
 
     def test__clause_does_not_return_unknown(self):
         interface = DummyInterface(["is the jubili line running"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_tube_line_rules),
+            SingleFileKnowledge(config, _tube_line_rules),
             interface=interface,
             code_path="/",
             logger=_logger,
@@ -147,10 +151,12 @@ def test__clause_does_not_return_unknown(self):
 
     def test__no_answer_if_retrieval_is_too_sparse(self):
         interface = DummyInterface(["I will i"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_tube_line_rules),
+            SingleFileKnowledge(config, _tube_line_rules),
             interface=interface,
             code_path="/",
         )
         asyncio.run(conversation_events.process_next())
+        print(interface.get_utterances_list())
         assert "unknown" not in interface.get_utterances_list()[-1]
diff --git a/tests/test_empty_input.py b/tests/test_empty_input.py
index 3db9a2bd..a22f38f5 100644
--- a/tests/test_empty_input.py
+++ b/tests/test_empty_input.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -25,8 +27,9 @@
 class TestEmptyInput(TestCase):
     def test_hello_and_username(self):
         interface = DummyInterface(["Hello", "My name is Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         asyncio.run(interface.output(utterance))
@@ -38,8 +41,9 @@ def test_hello_and_username(self):
 
     def test_empty_input_does_nothing(self):
         interface = DummyInterface(["computer"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings2), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings2), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         asyncio.run(interface.output(utterance))
diff --git a/tests/test_entailment.py b/tests/test_entailment.py
index 2c713dc7..2ffe68a1 100644
--- a/tests/test_entailment.py
+++ b/tests/test_entailment.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.extractors.entailer import Entailer
 
 _path = os.path.dirname(__file__)
@@ -12,7 +14,8 @@ def test_fact_entailment(self):
         premise = "The user says 'hello.'."
         hypothesis = "The user is greeting"
 
-        entailer = Entailer()
+        config = Configuration.load_local_config()
+        entailer = Entailer(config)
         prediction = asyncio.run(entailer.get_relation(premise, hypothesis))
         self.assertTrue(prediction["entailment"] > 0.95)
 
@@ -20,7 +23,8 @@ def test_question_entailment(self):
         premise = "The user says 'What time is the train leaving.'"
         hypothesis = "The user inquires about transport time tables"
 
-        entailer = Entailer()
+        config = Configuration.load_local_config()
+        entailer = Entailer(config)
         prediction = asyncio.run(entailer.get_relation(premise, hypothesis))
         print(prediction)
         self.assertTrue(prediction["entailment"] > 0.95)
@@ -29,5 +33,6 @@ def test_entailment_method(self):
         premise = "The user says 'my name is John.'."
         hypothesis = "The user says their name"
 
-        entailer = Entailer()
+        config = Configuration.load_local_config()
+        entailer = Entailer(config)
         self.assertEqual(asyncio.run(entailer.entails(premise, hypothesis)), "True")
diff --git a/tests/test_entailment_in_rules.py b/tests/test_entailment_in_rules.py
index 8ef85b66..45d4aaad 100644
--- a/tests/test_entailment_in_rules.py
+++ b/tests/test_entailment_in_rules.py
@@ -1,6 +1,7 @@
 import asyncio
 import os
 
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -20,8 +21,9 @@
 class TestEntailmentInRules(TestCase):
     def test__entailment_in_rule_returns_true(self):
         interface = DummyInterface(["I want to buy apples"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_events.py b/tests/test_events.py
index cdfeba69..05edce65 100644
--- a/tests/test_events.py
+++ b/tests/test_events.py
@@ -4,6 +4,7 @@
 from datetime import datetime
 from unittest import TestCase
 
+from wafl.config import Configuration
 from wafl.events.generated_events import GeneratedEvents
 from wafl.events.events_from_function_list import EventsCreatorFromFunctionList
 from wafl.events.events_from_module_name import EventsCreatorFromModuleName
@@ -44,8 +45,10 @@ def test__events_correctly_uses_argument_functions(self):
 
     def test__events_can_trigger_rule(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         generated_events = GeneratedEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            config,
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             events=EventsCreatorFromFunctionList([return_five_past_seven]),
             interface=interface,
             logger=_logger,
@@ -57,8 +60,10 @@ def test__events_can_trigger_rule(self):
 
     def test__events_does_not_trigger_rule(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         generated_events = GeneratedEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            config,
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             events=EventsCreatorFromFunctionList([return_four_past_seven]),
             interface=interface,
             logger=_logger,
@@ -69,8 +74,10 @@ def test__events_does_not_trigger_rule(self):
 
     def test__events_functions_can_be_loaded_from_file(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         generated_events = GeneratedEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            config,
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             events=EventsCreatorFromModuleName("events"),
             interface=interface,
             logger=_logger,
diff --git a/tests/test_exceptions.py b/tests/test_exceptions.py
index 3909b889..a1a1e8e4 100644
--- a/tests/test_exceptions.py
+++ b/tests/test_exceptions.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.exceptions import CloseConversation
 from wafl.interface.dummy_interface import DummyInterface
@@ -17,8 +19,9 @@
 class TestExceptions(TestCase):
     def test_runtime_warning_escapes_python_space(self):
         interface = DummyInterface(["Good bye!"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_executables.py b/tests/test_executables.py
index a5e9326b..c66b5613 100644
--- a/tests/test_executables.py
+++ b/tests/test_executables.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -58,8 +60,9 @@
 class TestExecutables(TestCase):
     def test_executables(self):
         interface = DummyInterface(to_utter=["test@example.com"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -72,8 +75,9 @@ def test_executables(self):
 
     def test_add_to_list(self):
         interface = DummyInterface(to_utter=["Please add apples to the shopping list"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -88,8 +92,9 @@ def test_remove_from_list(self):
                 "Please delete apples from the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -106,8 +111,9 @@ def test_list_the_items(self):
                 "What's in the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -129,8 +135,9 @@ def test_list_the_items2(self):
                 "What does the shopping list contain",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -146,8 +153,9 @@ def test_list_the_items2(self):
 
     def test_question_activates_inference(self):
         interface = DummyInterface(to_utter=["What time is it?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -157,8 +165,9 @@ def test_question_activates_inference(self):
 
     def test_negation(self):
         interface = DummyInterface(to_utter=["add batteries to the test list"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -169,8 +178,9 @@ def test_negation(self):
 
     def test_say_command_in_functions(self):
         interface = DummyInterface(to_utter=["I want to say 'this is a test'"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -180,8 +190,9 @@ def test_say_command_in_functions(self):
 
     def test__facts_work_in_python_space(self):
         interface = DummyInterface(to_utter=["Please define speed"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_generation.py b/tests/test_generation.py
index 588f68a8..0d96416e 100644
--- a/tests/test_generation.py
+++ b/tests/test_generation.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -27,8 +29,9 @@
 class TestGeneration(TestCase):
     def test__language_model_returns_first_letter_of_name(self):
         interface = DummyInterface(["My name is alberto"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, wafl_rules), interface=interface, code_path="/"
         )
         asyncio.run(conversation_events.process_next())
         expected = "bot: The first letter of your name is a"
@@ -37,8 +40,9 @@ def test__language_model_returns_first_letter_of_name(self):
 
     def test__does_not_generate_if_it_is_not_instructions(self):
         interface = DummyInterface(["Hello"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, wafl_rules), interface=interface, code_path="/"
         )
         asyncio.run(conversation_events.process_next())
         expected = "bot: Yes"
diff --git a/tests/test_greetings.py b/tests/test_greetings.py
index c7542576..e2e1db2f 100644
--- a/tests/test_greetings.py
+++ b/tests/test_greetings.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -68,8 +70,9 @@
 class TestGreetings(TestCase):
     def test_hello_and_username(self):
         interface = DummyInterface(["Hello", "Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         asyncio.run(interface.output(utterance))
@@ -78,8 +81,9 @@ def test_hello_and_username(self):
 
     def test_hello_and_username2(self):
         interface = DummyInterface(["Hello", "bob"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         asyncio.run(interface.output(utterance))
diff --git a/tests/test_inference.py b/tests/test_inference.py
index 925776aa..157cb75e 100644
--- a/tests/test_inference.py
+++ b/tests/test_inference.py
@@ -1,5 +1,7 @@
 import asyncio
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.narrator import Narrator
 from wafl.events.task_memory import TaskMemory
 from wafl.inference.backward_inference import BackwardInference
@@ -48,8 +50,10 @@
 class TestInference(TestCase):
     def test__simple_question(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(text="What is this bot's name", is_question=True, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -59,8 +63,10 @@ def test__simple_question(self):
 
     def test__fact_check_true(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(
             text="The user is in a good mood", is_question=False, variable="name"
@@ -70,8 +76,10 @@ def test__fact_check_true(self):
 
     def test__fact_check_false(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(text="The user is sad", is_question=False, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -79,8 +87,10 @@ def test__fact_check_false(self):
 
     def test__simple_rule(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(text="The user says hello!", is_question=False, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -88,8 +98,10 @@ def test__simple_rule(self):
 
     def test__forward_substitution(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(
             text="The user says: I can swim", is_question=False, variable="name"
@@ -99,8 +111,10 @@ def test__forward_substitution(self):
 
     def test__backward_substitution(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example), interface, Narrator(interface)
+            config,
+            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
         )
         query = Query(
             text="The user says: I have black hair", is_question=False, variable="name"
@@ -110,8 +124,10 @@ def test__backward_substitution(self):
 
     def test__forward_substution_2(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         inference = BackwardInference(
-            SingleFileKnowledge(wafl_example),
+            config,
+            SingleFileKnowledge(config, wafl_example),
             interface,
             Narrator(interface),
             logger=_logger,
diff --git a/tests/test_interruptions.py b/tests/test_interruptions.py
index adb5c135..56c006c0 100644
--- a/tests/test_interruptions.py
+++ b/tests/test_interruptions.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.exceptions import CloseConversation
 from wafl.interface.dummy_interface import DummyInterface
@@ -30,8 +32,9 @@
 class TestInterruptions(TestCase):
     def test_time_request_does_not_interrupt(self):
         interface = DummyInterface(["Hello", "Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         asyncio.run(interface.output(utterance))
@@ -41,8 +44,9 @@ def test_time_request_does_not_interrupt(self):
 
     def test_time_request_does_interrupt(self):
         interface = DummyInterface(["Hello", "what's the time?", "Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
         )
@@ -55,8 +59,9 @@ def test_time_request_does_interrupt(self):
 
     def test_time_shut_up_does_interrupt(self):
         interface = DummyInterface(["Hello", "shut up"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
         )
@@ -72,8 +77,9 @@ def test_time_shut_up_does_interrupt(self):
 
     def test_task_interrupt_task_does_interrupt(self):
         interface = DummyInterface(["Hello", "I want to stop the task"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings),
+            SingleFileKnowledge(config, _wafl_greetings),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_knowledge.py b/tests/test_knowledge.py
index 16ce5a28..01c83b8d 100644
--- a/tests/test_knowledge.py
+++ b/tests/test_knowledge.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 from wafl.extractors.dataclasses import Query
 
@@ -27,7 +29,8 @@
 
 class TestKnowledge(TestCase):
     def test_exact_string(self):
-        knowledge = SingleFileKnowledge(wafl_example)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, wafl_example)
         rules = asyncio.run(
             knowledge.ask_for_rule_backward(
                 Query(text="_ask_another_item", is_question=False)
diff --git a/tests/test_list_type.py b/tests/test_list_type.py
index 1a25869b..b2e2059d 100644
--- a/tests/test_list_type.py
+++ b/tests/test_list_type.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -28,8 +30,9 @@ def test__rule_line_can_return_list(self):
                 "space opera",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, _rules), interface=interface, code_path="/"
         )
         asyncio.run(conversation_events.process_next())
         [print(item) for item in interface.get_utterances_list()]
diff --git a/tests/test_lists.py b/tests/test_lists.py
index 3976fe08..af0af57a 100644
--- a/tests/test_lists.py
+++ b/tests/test_lists.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -82,8 +84,9 @@ def test__second_rule_is_not_run_if_prior_clause_fails(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, _rules), interface=interface, code_path="/"
         )
         asyncio.run(conversation_events.process_next())
         asyncio.run(conversation_events.process_next())
@@ -104,8 +107,9 @@ def test__add_item_to_list_as_function(self):
                 "what is in the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_lists_in_functions_rules),
+            SingleFileKnowledge(config, _lists_in_functions_rules),
             interface=interface,
             code_path="/",
         )
@@ -129,8 +133,9 @@ def test__yes_please_means_yes(self):
                 "what is in the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_lists_in_functions_rules),
+            SingleFileKnowledge(config, _lists_in_functions_rules),
             interface=interface,
             code_path="/",
         )
@@ -154,8 +159,9 @@ def test__yes_I_do_means_yes(self):
                 "what is in the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_lists_in_functions_rules),
+            SingleFileKnowledge(config, _lists_in_functions_rules),
             interface=interface,
             code_path="/",
         )
@@ -174,8 +180,9 @@ def test__hotword_is_ignored_in_instructions(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, _rules), interface=interface, code_path="/"
         )
         hotword = "Computer"
         asyncio.run(conversation_events.process_next(activation_word=hotword))
diff --git a/tests/test_natural_language_in_functions.py b/tests/test_natural_language_in_functions.py
index d6ab794b..8bfe9f19 100644
--- a/tests/test_natural_language_in_functions.py
+++ b/tests/test_natural_language_in_functions.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -50,8 +52,9 @@ def test_executables(self):
                 "What's in the shopping list",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -66,8 +69,9 @@ def test_say_twice_in_python_space(self):
                 "Please say hello twice",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -87,8 +91,9 @@ def test_say_twice_in_python_space(self):
 
     def test_double_functions(self):
         interface = DummyInterface(["Is the victoria line running"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_tube_line_rules),
+            SingleFileKnowledge(config, _tube_line_rules),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_negations.py b/tests/test_negations.py
index 05ecfc6e..ed4566ff 100644
--- a/tests/test_negations.py
+++ b/tests/test_negations.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -23,8 +25,9 @@ def test_simple_yes(self):
                 "yes",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "bot: So you do want to see it!"
@@ -37,8 +40,9 @@ def test_simple_no(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "bot: do you want to see the shopping list"
@@ -51,8 +55,9 @@ def test_no_thanks(self):
                 "no thanks",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "bot: do you want to see the shopping list"
diff --git a/tests/test_parsing.py b/tests/test_parsing.py
index e2f7de0f..fe7dd282 100644
--- a/tests/test_parsing.py
+++ b/tests/test_parsing.py
@@ -1,5 +1,7 @@
 import asyncio
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.facts import Fact
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
 from wafl.parsing.rules_parser import get_facts_and_rules_from_text, get_dependency_list
@@ -124,7 +126,8 @@ def test__fact_parsing(self):
         assert str(facts_and_rules["facts"]) == expected
 
     def test__knowledge_facts(self):
-        knowledge = SingleFileKnowledge(wafl_example)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, wafl_example)
         expected = str(Fact(text="the user is happy", is_question=False))
         facts = asyncio.run(
             knowledge.ask_for_facts(Query("how is the user", is_question=True))
@@ -132,7 +135,8 @@ def test__knowledge_facts(self):
         assert str(facts[0]) == expected
 
     def test__knowledge_rules(self):
-        knowledge = SingleFileKnowledge(wafl_example)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, wafl_example)
         expected = str(
             Rule(
                 effect=Fact(text="USER greets", is_question=False),
diff --git a/tests/test_policy.py b/tests/test_policy.py
index 0c497863..b2019e5a 100644
--- a/tests/test_policy.py
+++ b/tests/test_policy.py
@@ -3,6 +3,7 @@
 
 from unittest import TestCase
 
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -24,8 +25,9 @@ def test__information_is_repeated(self):
         interface = DummyInterface(
             to_utter=["What's in the shopping list", "say it again"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         asyncio.run(conversation_events.process_next())
@@ -37,8 +39,9 @@ def test__policy_can_steer_conversation(self):
         interface = DummyInterface(
             to_utter=["What's in the shopping list", "I meant the todo list"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         asyncio.run(conversation_events.process_next())
diff --git a/tests/test_preprocessing.py b/tests/test_preprocessing.py
index 213ed36f..a4f2569d 100644
--- a/tests/test_preprocessing.py
+++ b/tests/test_preprocessing.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -44,8 +46,9 @@ def test__functions_can_call_another_function(self):
                 "Hello",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_question_in_rule_trigger.py b/tests/test_question_in_rule_trigger.py
index de1d13bf..f73e4dab 100644
--- a/tests/test_question_in_rule_trigger.py
+++ b/tests/test_question_in_rule_trigger.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.exceptions import CloseConversation
 from wafl.interface.dummy_interface import DummyInterface
@@ -36,8 +38,9 @@ def test__good_bye_closes_conversation(self):
                 "Goodbye.",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -56,8 +59,9 @@ def test__thank_you_closes_conversation(self):
                 "Thank you.",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -76,8 +80,9 @@ def test__thanks_closes_conversation(self):
                 "Thanks.",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_questions.py b/tests/test_questions.py
index 6a7dea09..8b63f7fc 100644
--- a/tests/test_questions.py
+++ b/tests/test_questions.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.events.narrator import Narrator
 from wafl.simple_text_processing.questions import is_question
@@ -32,16 +34,17 @@ def test_yes_qa(self):
         user_answer = (
             "When asked 'is the user satisfied with this', the user says: 'yes I am.'"
         )
-
-        qa = Extractor(Narrator(DummyInterface))
+        config = Configuration.load_local_config()
+        qa = Extractor(config, Narrator(DummyInterface))
         answer = asyncio.run(qa.extract(query, user_answer))
 
         assert answer.is_true()
 
     def test_yes_or_no_questions_only_accept_positive_or_negative_replies(self):
         interface = DummyInterface(["Hello", "Blue sky", "yes"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example),
+            SingleFileKnowledge(config, _wafl_example),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
diff --git a/tests/test_questions_in_prior_conversation.py b/tests/test_questions_in_prior_conversation.py
index c3ac16b0..046e4552 100644
--- a/tests/test_questions_in_prior_conversation.py
+++ b/tests/test_questions_in_prior_conversation.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -23,8 +25,9 @@
 class TestAnswerInConversation(TestCase):
     def test__temperature_is_remembered(self):
         interface = DummyInterface(["Hello!", "What is the temperature today?"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example, logger=_logger),
+            SingleFileKnowledge(config, _wafl_example, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -36,8 +39,9 @@ def test__temperature_is_remembered(self):
 
     def test__random_name_is_remembered(self):
         interface = DummyInterface(["My name is Albert", "What is my name"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example), interface=interface
+            SingleFileKnowledge(config, _wafl_example), interface=interface
         )
         utterance = "Welcome to the website. How may I help you?"
         interface.output(utterance)
diff --git a/tests/test_questions_to_statements.py b/tests/test_questions_to_statements.py
index 1c174cc0..446568ed 100644
--- a/tests/test_questions_to_statements.py
+++ b/tests/test_questions_to_statements.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.narrator import Narrator
 from wafl.simple_text_processing.questions import get_sentence_from_yn_question
 from wafl.interface.dummy_interface import DummyInterface
@@ -39,6 +41,7 @@ def test__yn_question_is_translated_to_sentence4(self):
     def test__yn_questions_use_entailer_for_positive_answers(self):
         text = "This bot is doing well"
         query = Query("is this bot ok?", is_question=True)
-        qa = Extractor(Narrator(DummyInterface))
+        config = Configuration.load_local_config()
+        qa = Extractor(config, Narrator(DummyInterface))
         prediction = asyncio.run(qa.extract(query, text))
         self.assertEqual("yes", prediction.text.lower())
diff --git a/tests/test_recursion_in_python_space.py b/tests/test_recursion_in_python_space.py
index e24ddbde..f676f85c 100644
--- a/tests/test_recursion_in_python_space.py
+++ b/tests/test_recursion_in_python_space.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -25,8 +27,9 @@ def test__recursion_when_normalizing_names(self):
                 "the jubilee line",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, _rules), interface=interface, code_path="/"
         )
 
         while asyncio.run(conversation_events.process_next()):
diff --git a/tests/test_reminders.py b/tests/test_reminders.py
index d7d14b25..2f504260 100644
--- a/tests/test_reminders.py
+++ b/tests/test_reminders.py
@@ -3,6 +3,7 @@
 
 from unittest import TestCase
 
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.events.generated_events import GeneratedEvents
 from wafl.events.events_from_module_name import EventsCreatorFromModuleName
@@ -27,8 +28,10 @@
 class TestReminders(TestCase):
     def test__time_reminder_can_be_set(self):
         interface = DummyInterface()
-        knowledge = SingleFileKnowledge(_wafl_example)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
         generated_events = GeneratedEvents(
+            config,
             knowledge,
             events=EventsCreatorFromModuleName("events"),
             interface=interface,
@@ -48,8 +51,10 @@ def test__time_reminder_can_be_set(self):
 
     def test__time_reminder_can_be_set_1_minute_from_now(self):
         interface = DummyInterface()
-        knowledge = SingleFileKnowledge(_wafl_example)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
         generated_events = GeneratedEvents(
+            config,
             knowledge,
             events=EventsCreatorFromModuleName("events"),
             interface=interface,
diff --git a/tests/test_retrieval.py b/tests/test_retrieval.py
index 03e10c58..fb2e3c30 100644
--- a/tests/test_retrieval.py
+++ b/tests/test_retrieval.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -32,7 +34,8 @@
 
 class TestRetrieval(TestCase):
     def test_retrieval(self):
-        retriever = DenseRetriever("msmarco-distilbert-base-v3")
+        config = Configuration.load_local_config()
+        retriever = DenseRetriever("text_embedding_model", config)
         sentences = ["this is a test", "the food is hot on the table"]
         for index, sentence in enumerate(sentences):
             asyncio.run(retriever.add_text_and_index(sentence, str(index)))
@@ -43,9 +46,10 @@ def test_retrieval(self):
         assert predicted[0][0] == expected
 
     def test_retrieval_from_rules(self):
+        config = Configuration.load_local_config()
         interface = DummyInterface(to_utter=["tell me how the user is like"])
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_remember_rules, logger=_logger),
+            SingleFileKnowledge(config, _wafl_remember_rules, logger=_logger),
             interface=interface,
             logger=_logger,
         )
@@ -69,7 +73,8 @@ def test_exact_string_retrieval(self):
         assert predicted[0][0] == expected
 
     def test_short_text_retrieves_nothing(self):
-        retriever = DenseRetriever("msmarco-distilbert-base-v3")
+        config = Configuration.load_local_config()
+        retriever = DenseRetriever("msmarco-distilbert-base-v3", config)
         sentences = ["The user greets"]
         for index, sentence in enumerate(sentences):
             asyncio.run(retriever.add_text_and_index(sentence, str(index)))
@@ -81,8 +86,9 @@ def test_short_text_retrieves_nothing(self):
 
     def test_input_during_inference(self):
         interface = DummyInterface(to_utter=["Please remember that my name is Alberto"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_remember_rules, logger=_logger),
+            SingleFileKnowledge(config, _wafl_remember_rules, logger=_logger),
             interface=interface,
             logger=_logger,
         )
diff --git a/tests/test_rules_creation.py b/tests/test_rules_creation.py
index 8dd325e8..73838aaf 100644
--- a/tests/test_rules_creation.py
+++ b/tests/test_rules_creation.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -17,8 +19,9 @@
 class TestRulesCreation(TestCase):
     def test__one_line_rule_can_be_created(self):
         interface = DummyInterface()
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example),
+            SingleFileKnowledge(config, _wafl_example),
             interface=interface,
         )
         input_from_user = "I need you to create a new rule"
diff --git a/tests/test_scheduler.py b/tests/test_scheduler.py
index e9526a98..0e5cc44e 100644
--- a/tests/test_scheduler.py
+++ b/tests/test_scheduler.py
@@ -35,7 +35,7 @@ def return_four_past_seven():
 class TestScheduler(TestCase):
     def test__conversation_loop_can_run(self):
         config = Configuration.load_local_config()
-        knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+        knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
         interface = DummyInterface(["hello!"])
         conversation_events = ConversationEvents(
             knowledge,
@@ -57,7 +57,7 @@ def test__conversation_loop_can_run(self):
 
     def test__scheduler_can_run_with_conversation_loop(self):
         config = Configuration.load_local_config()
-        knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+        knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
         interface = DummyInterface(["hello!"])
         conversation_events = ConversationEvents(
             knowledge,
@@ -81,7 +81,7 @@ async def test__scheduler_can_run_with_conversation_and_event_loop__no_trigger_f
         self,
     ):
         config = Configuration.load_local_config()
-        knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+        knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
         interface = DummyInterface(["hello!"])
         conversation_events = ConversationEvents(
             knowledge,
@@ -118,7 +118,7 @@ async def test__scheduler_can_run_with_conversation_and_event_loop__does_trigger
         self,
     ):
         config = Configuration.load_local_config()
-        knowledge = SingleFileKnowledge(_wafl_example, logger=_logger)
+        knowledge = SingleFileKnowledge(config, _wafl_example, logger=_logger)
         interface = DummyInterface(["hello!"])
         conversation_events = ConversationEvents(
             knowledge,
@@ -136,6 +136,7 @@ async def test__scheduler_can_run_with_conversation_and_event_loop__does_trigger
         event_loop = GeneratedEventLoop(
             interface,
             GeneratedEvents(
+                config,
                 knowledge,
                 events=EventsCreatorFromFunctionList([return_four_past_seven]),
                 code_path="/",
diff --git a/tests/test_shopping_example.py b/tests/test_shopping_example.py
index 0162d069..b9a99c37 100644
--- a/tests/test_shopping_example.py
+++ b/tests/test_shopping_example.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -61,7 +63,8 @@
 
 class TestShoppingList(TestCase):
     def test_no_activation(self):
-        knowledge = SingleFileKnowledge(_rules)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _rules)
         results = asyncio.run(
             knowledge.ask_for_rule_backward(
                 Query(
@@ -81,8 +84,9 @@ def test_second_rule_is_not_run_if_prior_clause_fails(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_rules), interface=interface, code_path="/"
+            SingleFileKnowledge(config, _rules), interface=interface, code_path="/"
         )
         asyncio.run(conversation_events.process_next())
         asyncio.run(conversation_events.process_next())
diff --git a/tests/test_speaker.py b/tests/test_speaker.py
index e69fc3b0..35fe57fc 100644
--- a/tests/test_speaker.py
+++ b/tests/test_speaker.py
@@ -2,6 +2,8 @@
 import os
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.speaker.fairseq_speaker import FairSeqSpeaker
 from wafl.speaker.soundfile_speaker import SoundFileSpeaker
 
@@ -14,19 +16,22 @@
 
 class TestSpeaker(TestCase):
     def test_voice(self):
-        speaker = FairSeqSpeaker()
+        config = Configuration.load_local_config()
+        speaker = FairSeqSpeaker(config)
         text = "Hello world"
         asyncio.run(speaker.speak(text))
 
     def test_long_text(self):
-        speaker = FairSeqSpeaker()
+        config = Configuration.load_local_config()
+        speaker = FairSeqSpeaker(config)
         text = (
             "Shall I compare you to a summer's day? Thou art more lovely and temperate."
         )
         asyncio.run(speaker.speak(text))
 
     def test_number_pronunciation(self):
-        speaker = FairSeqSpeaker()
+        config = Configuration.load_local_config()
+        speaker = FairSeqSpeaker(config)
         text = "The time is 54 past 8"
         asyncio.run(speaker.speak(text))
 
diff --git a/tests/test_task_creation.py b/tests/test_task_creation.py
index 0105f06e..3c21ffc7 100644
--- a/tests/test_task_creation.py
+++ b/tests/test_task_creation.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.connectors.bridges.llm_code_creator_bridge import LLMCodeCreatorBridge
 from wafl.connectors.bridges.llm_task_creator_bridge import LLMTaskCreatorBridge
 from wafl.events.conversation_events import ConversationEvents
@@ -24,7 +26,8 @@
 
 class TestTaskCreation(TestCase):
     def test__task_creation_connector(self):
-        connector = LLMTaskCreatorBridge()
+        config = Configuration.load_local_config()
+        connector = LLMTaskCreatorBridge(config)
         task = "the user wants to go swimming in the sea"
         triggers = "\n".join(
             [
@@ -43,8 +46,9 @@ def test__task_creation_connector(self):
         assert expected == prediction
 
     def test__task_creation1(self):
-        knowledge = SingleFileKnowledge(_wafl_example)
-        task_creator = TaskCreator(knowledge)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
+        task_creator = TaskCreator(config, knowledge)
         task = "the user wants to go swimming in the sea at brighton beach"
         answer = asyncio.run(task_creator.extract(task))
         expected = """
@@ -58,8 +62,9 @@ def test__task_creation1(self):
         assert expected == answer.text.strip()
 
     def test__task_creation2(self):
-        knowledge = SingleFileKnowledge(_wafl_example)
-        task_creator = TaskCreator(knowledge)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
+        task_creator = TaskCreator(config, knowledge)
         task = "the user wants to know if they need and umbrella"
         answer = asyncio.run(task_creator.extract(task))
         expected = """
@@ -72,8 +77,9 @@ def test__task_creation2(self):
         assert expected == answer.text.strip()
 
     def test__task_creation3(self):
-        knowledge = SingleFileKnowledge(_wafl_example)
-        task_creator = TaskCreator(knowledge)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
+        task_creator = TaskCreator(config, knowledge)
         task = "the user wants to go from London to Manchester"
         answer = asyncio.run(task_creator.extract(task))
         expected = """
@@ -87,8 +93,9 @@ def test__task_creation3(self):
 
     def test__task_is_created_from_conversation(self):
         interface = DummyInterface(to_utter=["Tell me if I need an umbrella"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(_wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -97,7 +104,8 @@ def test__task_is_created_from_conversation(self):
         assert interface.get_utterances_list()[-1] == expected
 
     def test__code_creation(self):
-        connector = LLMCodeCreatorBridge()
+        config = Configuration.load_local_config()
+        connector = LLMCodeCreatorBridge(config)
         task = "connect to 'localhost:port' and return the data as json"
         function_shape = "json_data = connect_to_localhost(port)"
         prediction = asyncio.run(connector.get_answer("", function_shape, task))
@@ -113,8 +121,9 @@ def connect_to_localhost(port):
         assert expected == prediction
 
     def test__task_creation_with_function(self):
-        knowledge = SingleFileKnowledge(_wafl_example)
-        code_creator = CodeCreator(knowledge)
+        config = Configuration.load_local_config()
+        knowledge = SingleFileKnowledge(config, _wafl_example)
+        code_creator = CodeCreator(config, knowledge)
         task = "folders_list = list_subfolders('/var/') <the user wants list all the subfolders in a folder>"
         answer = asyncio.run(code_creator.extract(task))
         expected = """
@@ -132,8 +141,9 @@ def list_subfolders(folder_name):
 
     def test__task_is_created_from_conversation_with_code(self):
         interface = DummyInterface(to_utter=["Please list of the subfolders of /var"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(_wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
             interface=interface,
             code_path="/",
         )
@@ -144,8 +154,9 @@ def test__task_is_created_from_conversation_with_code(self):
 
     def test__math_task_is_created_from_conversation(self):
         interface = DummyInterface(to_utter=["Multiply 100 and 43"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(_wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
             interface=interface,
             code_path="/",
         )
diff --git a/tests/test_task_extraction.py b/tests/test_task_extraction.py
index 6c4a5ef2..1be7edcc 100644
--- a/tests/test_task_extraction.py
+++ b/tests/test_task_extraction.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.extractors.task_extractor import TaskExtractor
 from wafl.interface.dummy_interface import DummyInterface
 
@@ -11,7 +13,8 @@ def test__dialogue_extractor1(self):
         interface._utterances = [
             [0, "user: what time is it"],
         ]
-        task_extractor = TaskExtractor(interface)
+        config = Configuration.load_local_config()
+        task_extractor = TaskExtractor(config, interface)
         prediction = asyncio.run(task_extractor.extract("")).text
         expected = "wants to know the time"
         print(prediction)
@@ -25,7 +28,8 @@ def test__dialogue_extractor2(self):
             [2, "bot: The time is 20 past 13"],
             [3, "user: what is in the shopping list"],
         ]
-        task_extractor = TaskExtractor(interface)
+        config = Configuration.load_local_config()
+        task_extractor = TaskExtractor(config, interface)
         prediction = asyncio.run(task_extractor.extract("")).text
         expected = "the user wants to know what is in the shopping list"
         assert expected == prediction
@@ -42,7 +46,8 @@ def test__dialogue_extractor3(self):
             [6, "bot: yes, it is running normally"],
             [7, "user: what about the Jubilee line"],
         ]
-        task_extractor = TaskExtractor(interface)
+        config = Configuration.load_local_config()
+        task_extractor = TaskExtractor(config, interface)
         prediction = asyncio.run(task_extractor.extract("")).text
         expected = "the user wants to know if the Jubilee line is running"
         print(prediction)
@@ -58,7 +63,8 @@ def test__no_task_present_is_predicted_as_unknown(self):
             [4, "bot: the shopping list contains milk, bread, and eggs"],
             [5, "user: you"],
         ]
-        task_extractor = TaskExtractor(interface)
+        config = Configuration.load_local_config()
+        task_extractor = TaskExtractor(config, interface)
         prediction = asyncio.run(task_extractor.extract("")).text
         expected = "unknown"
         print(prediction)
diff --git a/tests/test_task_lists.py b/tests/test_task_lists.py
index 210db3d8..7edfa966 100644
--- a/tests/test_task_lists.py
+++ b/tests/test_task_lists.py
@@ -3,6 +3,7 @@
 
 from unittest import TestCase
 
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -24,8 +25,9 @@ def test__double_command_is_executed(self):
         interface = DummyInterface(
             to_utter=["tell me about the weather and then delete the apples"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example), interface=interface
+            SingleFileKnowledge(config, wafl_example), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         expected = "the sun is shining"
diff --git a/tests/test_task_memory.py b/tests/test_task_memory.py
index 9ae29174..4dce3001 100644
--- a/tests/test_task_memory.py
+++ b/tests/test_task_memory.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.events.task_memory import TaskMemory
 from wafl.interface.dummy_interface import DummyInterface
@@ -70,8 +72,9 @@ def test__executables(self):
                 "Hello, my name is Bob",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
             logger=LocalFileLogger(),
@@ -83,8 +86,9 @@ def test__executables(self):
 
     def test__hello_does_not_get_into_task_memory(self):
         interface = DummyInterface(to_utter=["hello", "Albert"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -101,8 +105,9 @@ def test__task_memory_does_not_propagate_down_for_depth2(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -121,8 +126,9 @@ def test__task_memory_does_not_propagate_down_for_depth3(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
         )
@@ -139,8 +145,9 @@ def test__task_memory_works_for_yes_questions(self):
                 "no",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(wafl_example),
+            SingleFileKnowledge(config, wafl_example),
             interface=interface,
             code_path="/",
             logger=LocalFileLogger(),
@@ -156,8 +163,9 @@ def test__prior_list_name_is_remembered(self):
                 "add bananas as well",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(memory_example),
+            SingleFileKnowledge(config, memory_example),
             interface=interface,
             code_path="/",
             logger=LocalFileLogger(),
@@ -176,8 +184,9 @@ def test__prior_list_name_is_remembered_second_time(self):
                 "ok now add apples",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(memory_example),
+            SingleFileKnowledge(config, memory_example),
             interface=interface,
             code_path="/",
             logger=LocalFileLogger(),
@@ -197,8 +206,9 @@ def test__prior_list_name_is_remembered_second_time_for_coffee_filters(self):
                 "add coffee filters",
             ]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(memory_example),
+            SingleFileKnowledge(config, memory_example),
             interface=interface,
             code_path="/",
             logger=LocalFileLogger(),
diff --git a/tests/test_testcases.py b/tests/test_testcases.py
index 994debe6..131338d3 100644
--- a/tests/test_testcases.py
+++ b/tests/test_testcases.py
@@ -1,6 +1,8 @@
 import asyncio
 
 from unittest import TestCase
+
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.dummy_interface import DummyInterface
 from wafl.knowledge.single_file_knowledge import SingleFileKnowledge
@@ -68,8 +70,9 @@ def test_greeting_goes_as_planned(self):
         interface = DummyInterface(
             dialogue_data["test the greetings work"]["user_lines"]
         )
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_greetings), interface=interface
+            SingleFileKnowledge(config, _wafl_greetings), interface=interface
         )
         asyncio.run(conversation_events.process_next())
         assert [
@@ -79,20 +82,23 @@ def test_greeting_goes_as_planned(self):
         ] == dialogue_data["test the greetings work"]["bot_lines"]
 
     def test_conversation_testcase_single_test_success(self):
+        config = Configuration.load_local_config()
         testcase = ConversationTestCases(
-            _test_case_greetings, SingleFileKnowledge(_wafl_greetings)
+            config, _test_case_greetings, SingleFileKnowledge(config, _wafl_greetings)
         )
         assert testcase.test_single_case("test the greetings work")
 
     def test_conversation_testcase_single_test_failure(self):
         new_test_case = _test_case_greetings.replace("Bob", "Albert")
+        config = Configuration.load_local_config()
         testcase = ConversationTestCases(
-            new_test_case, SingleFileKnowledge(_wafl_greetings)
+            config, new_test_case, SingleFileKnowledge(config, _wafl_greetings)
         )
         assert not asyncio.run(testcase.test_single_case("test the greetings work"))
 
     def test_conversation_testcase_run_all(self):
+        config = Configuration.load_local_config()
         testcase = ConversationTestCases(
-            _test_case_greetings, SingleFileKnowledge(_wafl_greetings)
+            config, _test_case_greetings, SingleFileKnowledge(config, _wafl_greetings)
         )
         assert asyncio.run(testcase.run())
diff --git a/tests/test_voice.py b/tests/test_voice.py
index b4bff2e9..675ca421 100644
--- a/tests/test_voice.py
+++ b/tests/test_voice.py
@@ -26,8 +26,9 @@
 class TestVoice(TestCase):
     def test_activation(self):
         interface = DummyInterface(to_utter=["computer", "my name is Jane"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example), interface=interface
+            SingleFileKnowledge(config, _wafl_example), interface=interface
         )
         interface.activate()
         asyncio.run(conversation_events.process_next(activation_word="computer"))
@@ -36,8 +37,9 @@ def test_activation(self):
 
     def test_no_activation(self):
         interface = DummyInterface(to_utter=["my name is bob"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example), interface=interface
+            SingleFileKnowledge(config, _wafl_example), interface=interface
         )
         interface.deactivate()
         asyncio.run(conversation_events.process_next(activation_word="computer"))
@@ -45,8 +47,9 @@ def test_no_activation(self):
 
     def test_computer_name_is_removed_after_activation(self):
         interface = DummyInterface(to_utter=["[computer] computer my name is bob"])
+        config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            SingleFileKnowledge(_wafl_example), interface=interface
+            SingleFileKnowledge(config, _wafl_example), interface=interface
         )
         interface.deactivate()
         asyncio.run(conversation_events.process_next(activation_word="computer"))
@@ -58,7 +61,7 @@ def test_hotwords_as_input(self):
         interface = VoiceInterface(config)
         asyncio.run(
             interface.add_hotwords_from_knowledge(
-                SingleFileKnowledge(_wafl_example), count_threshold=1
+                SingleFileKnowledge(config, _wafl_example), count_threshold=1
             )
         )
         expected = ["jane", "name is", "is jane", "says", "says their", "their name"]
@@ -67,7 +70,8 @@ def test_hotwords_as_input(self):
     def test_sound_file_is_translated_correctly(self):
         f = wave.open(os.path.join(_path, "data/1002.wav"), "rb")
         waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
-        listener = WhisperListener()
+        config = Configuration.load_local_config()
+        listener = WhisperListener(config)
         result = asyncio.run(listener.input_waveform(waveform))
         result = _normalize_utterance(result)
         expected = "DELETE BATTERIES FROM THE GROCERY LIST"
@@ -76,7 +80,8 @@ def test_sound_file_is_translated_correctly(self):
     def test_random_sounds_are_excluded(self):
         f = wave.open(os.path.join(_path, "data/random_sounds.wav"), "rb")
         waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
-        listener = WhisperListener()
+        config = Configuration.load_local_config()
+        listener = WhisperListener(config)
         result = asyncio.run(listener.input_waveform(waveform))
         expected = "[unclear]"
         assert result == expected
@@ -89,7 +94,8 @@ def test_voice_interface_receives_config(self):
     def test__hotword_listener_activated_using_recording_of_hotword(self):
         f = wave.open(os.path.join(_path, "data/computer.wav"), "rb")
         waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
-        listener = WhisperListener()
+        config = Configuration.load_local_config()
+        listener = WhisperListener(config)
         asyncio.run(listener.input_waveform(waveform))
         result = asyncio.run(listener.hotword_is_present("computer"))
         assert result
@@ -97,7 +103,8 @@ def test__hotword_listener_activated_using_recording_of_hotword(self):
     def test__hotword_listener_is_not_activated_using_recording_of_not_hotword(self):
         f = wave.open(os.path.join(_path, "data/1002.wav"), "rb")
         waveform = np.frombuffer(f.readframes(f.getnframes()), dtype=np.int16) / 32768
-        listener = WhisperListener()
+        config = Configuration.load_local_config()
+        listener = WhisperListener(config)
         asyncio.run(listener.input_waveform(waveform))
         result = asyncio.run(listener.hotword_is_present("computer"))
         assert not result
diff --git a/wafl/connectors/bridges/llm_code_creator_bridge.py b/wafl/connectors/bridges/llm_code_creator_bridge.py
index b35a62b9..739f5d50 100644
--- a/wafl/connectors/bridges/llm_code_creator_bridge.py
+++ b/wafl/connectors/bridges/llm_code_creator_bridge.py
@@ -9,7 +9,7 @@
 
 
 class LLMCodeCreatorBridge:
-    def __init__(self, config=None):
+    def __init__(self, config):
         self._connector = LLMConnectorFactory.get_connector(config)
         self._config = config
         try:
diff --git a/wafl/connectors/bridges/llm_qa_bridge.py b/wafl/connectors/bridges/llm_qa_bridge.py
index c88eed51..c7ac1b5f 100644
--- a/wafl/connectors/bridges/llm_qa_bridge.py
+++ b/wafl/connectors/bridges/llm_qa_bridge.py
@@ -34,7 +34,7 @@ async def get_answer(self, text: str, dialogue: str, query: str) -> str:
 
     async def _get_answer_prompt(self, text, query, dialogue=None):
         if not self._knowledge:
-            self._knowledge = await load_knowledge_from_file("qa", _path)
+            self._knowledge = await load_knowledge_from_file("qa", self._config)
 
         if not self._adversarial_knowledge:
             self._adversarial_knowledge = await load_knowledge_from_file(
diff --git a/wafl/connectors/bridges/llm_task_creator_bridge.py b/wafl/connectors/bridges/llm_task_creator_bridge.py
index 29a6dda8..5973cd08 100644
--- a/wafl/connectors/bridges/llm_task_creator_bridge.py
+++ b/wafl/connectors/bridges/llm_task_creator_bridge.py
@@ -9,7 +9,7 @@
 
 
 class LLMTaskCreatorBridge:
-    def __init__(self, config=None):
+    def __init__(self, config):
         self._connector = LLMConnectorFactory.get_connector(config)
         self._config = config
         try:
diff --git a/wafl/connectors/factories/speaker_connector_factory.py b/wafl/connectors/factories/speaker_connector_factory.py
index 8414e6b4..bad8fbe7 100644
--- a/wafl/connectors/factories/speaker_connector_factory.py
+++ b/wafl/connectors/factories/speaker_connector_factory.py
@@ -8,4 +8,4 @@ def get_connector(config):
         if config.get_value("speaker_model")["model_is_local"]:
             return LocalSpeakerConnector(config.get_value("speaker_model"))
 
-        return RemoteSpeakerConnector(config.get_value("speaker_model"))
+        return RemoteSpeakerConnector(config.get_value("speaker_model")["remote_model"])
diff --git a/wafl/connectors/factories/whisper_connector_factory.py b/wafl/connectors/factories/whisper_connector_factory.py
index f3b7b255..f39b5874 100644
--- a/wafl/connectors/factories/whisper_connector_factory.py
+++ b/wafl/connectors/factories/whisper_connector_factory.py
@@ -8,4 +8,4 @@ def get_connector(config):
         if config.get_value("listener_model")["model_is_local"]:
             return LocalWhisperConnector(config.get_value("listener_model"))
 
-        return RemoteWhisperConnector(config.get_value("listener_model"))
+        return RemoteWhisperConnector(config.get_value("listener_model")["remote_model"])
diff --git a/wafl/connectors/local/local_speaker_connector.py b/wafl/connectors/local/local_speaker_connector.py
index 74d89642..83ad9b13 100644
--- a/wafl/connectors/local/local_speaker_connector.py
+++ b/wafl/connectors/local/local_speaker_connector.py
@@ -30,5 +30,5 @@ async def predict(self, text: str) -> Dict[str, float]:
             wav, rate = TTSHubInterface.get_prediction(
                 self._task, self._model, self._generator, sample
             )
-
+        wav = wav.cpu().numpy().tobytes()
         return {"wav": wav, "rate": rate}
diff --git a/wafl/connectors/remote/remote_speaker_connector.py b/wafl/connectors/remote/remote_speaker_connector.py
index 82cda28a..3d1226b4 100644
--- a/wafl/connectors/remote/remote_speaker_connector.py
+++ b/wafl/connectors/remote/remote_speaker_connector.py
@@ -11,8 +11,8 @@ class RemoteSpeakerConnector:
 
     def __init__(self, config):
         self._server_url = (
-            f"https://{config.get_value('listener_model')['model_host']}:"
-            f"{config.get_value('listener_model')['model_port']}/predictions/speaker"
+            f"https://{config['model_host']}:"
+            f"{config['model_port']}/predictions/speaker"
         )
         try:
             loop = asyncio.get_running_loop()
diff --git a/wafl/events/generated_events.py b/wafl/events/generated_events.py
index e9e44e65..dace15c7 100644
--- a/wafl/events/generated_events.py
+++ b/wafl/events/generated_events.py
@@ -12,14 +12,15 @@
 class GeneratedEvents:
     def __init__(
         self,
+        config,
         knowledge: "BaseKnowledge",
         interface: "BaseInterface",
         events: "BaseEventCreator",
         code_path=None,
-        config=None,
         logger=None,
     ):
         self._inference = BackwardInference(
+            config,
             knowledge,
             interface,
             Narrator(interface),
diff --git a/wafl/inference/backward_inference.py b/wafl/inference/backward_inference.py
index 3a9dfe8c..fa7b2129 100644
--- a/wafl/inference/backward_inference.py
+++ b/wafl/inference/backward_inference.py
@@ -61,13 +61,11 @@ def __init__(
         self._knowledge = knowledge
         self._interface = interface
         self._config = config
-        #### go through them with the config
         self._extractor = Extractor(config, narrator, logger)
         self._prompt_predictor = PromptPredictor(config, logger)
         self._task_extractor = TaskExtractor(config, interface)
         self._task_creator = TaskCreator(config, knowledge, logger)
         self._code_creator = CodeCreator(config, knowledge)
-        ####
 
         self._narrator = narrator
         self._logger = logger
diff --git a/wafl/interface/voice_interface.py b/wafl/interface/voice_interface.py
index 67add228..959b596b 100644
--- a/wafl/interface/voice_interface.py
+++ b/wafl/interface/voice_interface.py
@@ -31,8 +31,8 @@ def __init__(self, config):
         self._deny_sound_filename = self.__get_deny_sound_from_config(config)
 
         self.listener_model_name = config.get_value("listener_model")
-        self._speaker = FairSeqSpeaker()
-        self._listener = WhisperListener()
+        self._speaker = FairSeqSpeaker(config)
+        self._listener = WhisperListener(config)
         self._listener.set_timeout(config.get_value("listener_silence_timeout"))
         self._listener.set_volume_threshold(
             config.get_value("listener_volume_threshold")
diff --git a/wafl/knowledge/project_knowledge.py b/wafl/knowledge/project_knowledge.py
index 708eab7b..92ebf645 100644
--- a/wafl/knowledge/project_knowledge.py
+++ b/wafl/knowledge/project_knowledge.py
@@ -6,7 +6,8 @@
 
 
 class ProjectKnowledge(BaseKnowledge):
-    def __init__(self, rules_filename=None, logger=None):
+    def __init__(self, config, rules_filename=None, logger=None):
+        self._config = config
         self._logger = logger
         self._dependency_dict = {}
         self._knowledge_dict = {}
@@ -124,9 +125,9 @@ def get_dependencies_list(self):
         return self._get_all_dependency_names(self.root_knowledge)
 
     @staticmethod
-    def create_from_string(rules_text: str, knowledge_name: str) -> "ProjectKnowledge":
-        knowledge = ProjectKnowledge()
-        knowledge._knowledge_dict[knowledge_name] = SingleFileKnowledge(rules_text)
+    def create_from_string(config: "Configuration", rules_text: str, knowledge_name: str) -> "ProjectKnowledge":
+        knowledge = ProjectKnowledge(config)
+        knowledge._knowledge_dict[knowledge_name] = SingleFileKnowledge(config, rules_text)
         return knowledge
 
     def _populate_knowledge_structure(
@@ -138,7 +139,7 @@ def _populate_knowledge_structure(
 
         name = _get_module_name_from_filename(filename)
         knowledge_structure[name] = SingleFileKnowledge(
-            text, knowledge_name=name, logger=self._logger
+            self._config, text, knowledge_name=name, logger=self._logger
         )
         dependencies = get_dependency_list(text)
         dependency_dict.setdefault(name, [])
diff --git a/wafl/speaker/fairseq_speaker.py b/wafl/speaker/fairseq_speaker.py
index 128f08d9..37cf78e8 100644
--- a/wafl/speaker/fairseq_speaker.py
+++ b/wafl/speaker/fairseq_speaker.py
@@ -23,7 +23,7 @@ async def speak(self, text):
             output=True,
         )
         await asyncio.sleep(0.2)
-        stream.write(wav.cpu().numpy().tobytes())
+        stream.write(wav)
         stream.stop_stream()
         stream.close()
         await asyncio.sleep(0.1)
diff --git a/wafl/testcases.py b/wafl/testcases.py
index 4555dc87..9bec5d51 100644
--- a/wafl/testcases.py
+++ b/wafl/testcases.py
@@ -14,10 +14,10 @@ class ConversationTestCases:
     GREEN_COLOR_START = "\033[32m"
     COLOR_END = "\033[0m"
 
-    def __init__(self, text, knowledge, code_path=None, logger=None):
+    def __init__(self, config, text, knowledge, code_path=None, logger=None):
         self._testcase_data = get_user_and_bot_lines_from_text(text)
         self._knowledge = knowledge
-        self._entailer = Entailer(logger)
+        self._entailer = Entailer(config, logger)
         self._code_path = code_path if code_path else "/"
 
     async def test_single_case(self, name):

From b5354d8e1299a7b1fc11698a555cc773d1e59feb Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 11:37:09 +0100
Subject: [PATCH 23/29] added config in runners

---
 wafl/run.py                       | 8 ++++++--
 wafl/runners/run_from_audio.py    | 3 ++-
 wafl/runners/run_web_interface.py | 4 +++-
 3 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/wafl/run.py b/wafl/run.py
index 5c6c9024..2276dbd6 100644
--- a/wafl/run.py
+++ b/wafl/run.py
@@ -1,5 +1,6 @@
 import asyncio
 
+from wafl.config import Configuration
 from wafl.exceptions import CloseConversation
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.command_line_interface import CommandLineInterface
@@ -19,7 +20,8 @@ def print_incipit():
 
 def run_from_command_line():
     interface = CommandLineInterface()
-    knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+    config = Configuration.load_local_config()
+    knowledge = ProjectKnowledge(config,  "rules.wafl", logger=_logger)
     conversation_events = ConversationEvents(
         knowledge,
         interface=interface,
@@ -39,9 +41,11 @@ def run_from_command_line():
 
 def run_testcases():
     print("Running the testcases in testcases.txt\n")
-    knowledge = ProjectKnowledge("rules.wafl")
+    config = Configuration.load_local_config()
+    knowledge = ProjectKnowledge(config, "rules.wafl")
     test_cases_text = open("testcases.txt").read()
     testcases = ConversationTestCases(
+        config,
         test_cases_text,
         knowledge,
         code_path=knowledge.get_dependencies_list(),
diff --git a/wafl/runners/run_from_audio.py b/wafl/runners/run_from_audio.py
index 64ce337e..cdaf4a2f 100644
--- a/wafl/runners/run_from_audio.py
+++ b/wafl/runners/run_from_audio.py
@@ -12,7 +12,7 @@
 
 def run_from_audio():
     config = Configuration.load_local_config()
-    knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+    knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
     interface = VoiceInterface(config)
     conversation_events = ConversationEvents(
         knowledge,
@@ -28,6 +28,7 @@ def run_from_audio():
         activation_word=config.get_value("waking_up_word"),
     )
     generated_events = GeneratedEvents(
+        config,
         knowledge,
         events=EventsCreatorFromModuleName("events"),
         interface=interface,
diff --git a/wafl/runners/run_web_interface.py b/wafl/runners/run_web_interface.py
index 0264b511..54ad98fd 100644
--- a/wafl/runners/run_web_interface.py
+++ b/wafl/runners/run_web_interface.py
@@ -1,5 +1,6 @@
 import asyncio
 
+from wafl.config import Configuration
 from wafl.events.conversation_events import ConversationEvents
 from wafl.interface.queue_interface import QueueInterface
 from wafl.knowledge.project_knowledge import ProjectKnowledge
@@ -13,7 +14,8 @@
 
 def run_server():
     interface = QueueInterface()
-    knowledge = ProjectKnowledge("rules.wafl", logger=_logger)
+    config = Configuration.load_local_config()
+    knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
     interface.activate()
     conversation_events = ConversationEvents(
         knowledge,

From 21759a4c80fdbdfb5f97c255219656272e1cccdb Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 16:34:48 +0100
Subject: [PATCH 24/29] updated config

---
 wafl/templates/config.json | 56 ++++++++++++++++++++++++++++++++++----
 1 file changed, 51 insertions(+), 5 deletions(-)

diff --git a/wafl/templates/config.json b/wafl/templates/config.json
index 3b26fc51..d7548499 100644
--- a/wafl/templates/config.json
+++ b/wafl/templates/config.json
@@ -4,9 +4,55 @@
   "waking_up_sound": true,
   "deactivate_sound": true,
   "improvise_tasks": true,
-  "listener_hotword_logp": -8,
-  "listener_volume_threshold": 0.6,
-  "listener_silence_timeout": 0.7,
-  "model_host": "127.0.0.1",
-  "model_port": 8080
+  "llm_model": {
+    "model_is_local": true,
+    "local_model": "mosaicml/mpt-7b-instruct",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "listener_model": {
+    "model_is_local": true,
+    "local_model": "fractalego/personal-whisper-medium.en-model",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    },
+    "listener_hotword_logp": -8,
+    "listener_volume_threshold": 0.6,
+    "listener_silence_timeout": 0.7
+  },
+  "speaker_model": {
+    "model_is_local": true,
+    "local_model": "facebook/fastspeech2-en-ljspeech",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "entailment_model": {
+    "model_is_local": true,
+    "local_model": "MoritzLaurer/DeBERTa-v3-base-mnli-fever-anli",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "text_embedding_model": {
+    "model_is_local": true,
+    "local_model": "msmarco-distilbert-base-v3",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  },
+  "qa_embedding_model": {
+    "model_is_local": true,
+    "local_model": "multi-qa-distilbert-dot-v1",
+    "remote_model": {
+      "model_host": "localhost",
+      "model_port": 8080
+    }
+  }
 }

From 2422cba968be923ca064b055188dd910424d9eaa Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 16:51:01 +0100
Subject: [PATCH 25/29] Updated docs

---
 .../build/doctrees/environment.pickle         | Bin 111414 -> 114810 bytes
 .../build/doctrees/installation.doctree       | Bin 7330 -> 7611 bytes
 .../build/doctrees/introduction.doctree       | Bin 3528 -> 3762 bytes
 .../build/doctrees/wafl_init.doctree          | Bin 9994 -> 11136 bytes
 .../build/html/_sources/installation.rst.txt  |   9 ++--
 .../build/html/_sources/introduction.rst.txt  |   6 ++-
 .../build/html/_sources/wafl_init.rst.txt     |  34 ++++++++-------
 documentation/build/html/_static/pygments.css |   1 +
 .../build/html/directory_structure.html       |   6 +--
 documentation/build/html/examples.html        |   8 ++--
 documentation/build/html/index.html           |   4 +-
 documentation/build/html/installation.html    |   8 ++--
 documentation/build/html/introduction.html    |   5 ++-
 documentation/build/html/objects.inv          |   6 +--
 documentation/build/html/rules.html           |   8 ++--
 .../build/html/rules_and_backtracking.html    |   6 +--
 documentation/build/html/searchindex.js       |   2 +-
 documentation/build/html/wafl_init.html       |  39 ++++++++++--------
 documentation/source/installation.rst         |   9 ++--
 documentation/source/introduction.rst         |   6 ++-
 documentation/source/wafl_init.rst            |  28 ++++++++-----
 wafl/variables.py                             |   2 +-
 22 files changed, 109 insertions(+), 78 deletions(-)

diff --git a/documentation/build/doctrees/environment.pickle b/documentation/build/doctrees/environment.pickle
index 86ff33ff252e281880831efcfde7e44f0977c944..f93f325ab5cf9fbc041762d0e9bd9b18a42739ed 100644
GIT binary patch
literal 114810
zcmeIb3!EHRc_%9Ct&v7gTb5r?mM|U(&B#w4!hpxp*qTTh$s-xt!J?<9yJoseJ>Bho
zXfzlF0}FVT3OJ$Rk}SE|U$RLy&*e=5n}iM7Y;Hmz$t5J*B!uO$n<ab0>*mL1f#m-G
z-#MqMPE~c!Oiz#eh=r+|t~zxd-}zqW`@Zv?$Jf34^r|aX@t?o5UM&>M7l+*Pg<`Ez
zo^i{KmcRX;X0enXi9C8&YyTTtms$h<nryY&8uR<|m0Y9dy7^+Q<-h7sp)%th%9e8O
zq1j69eB@`nmOC_?ohltd`6esRHj0(<p-I-yXRM>%^4FuBRP~a`w~MQ)UTM~HE~>~?
z%2UPZmfx>OWPYzdqFw|;*i^aT)@sE(8ot!>*VWxdQ-<VTY`En*x>s+VYxx_hwTkEF
z0FAW|4&QsC<!{PWs&lpCbODd9yzQ3TZa?S@mnPj>qv9NK8<kQKeaJQ&g$f|DHU4I6
z!=0&?vJJPMsb(7mHqe&|p0%?6cK2eg)Xckl-EeEF4}FEkOexbSxHA~wb~Ua{t&tBN
z$@@BinhWaPkWmj%=~lPeoXq6v^~_YUgyEvqt@4TWs9zp=kwX0nsF`|mYN~j#<!{ba
zN+rNTVB>E-Rm;0IH-EGU=m4tY0MSsbPQ0nP^+v6kYc%n?0eH6Ret)?+gL%nJRcbTY
zhTzbKx~dB>IHUe@ZXyz(7(N8(?=4Ob$)k0R>|_Z~HlF2O9`)rad3SKKRLPyk_a}<=
zMzK82H%<Ra8A#PdL#1N*d_7YH4z&C=-+1#IQTv5#sVP%FP`IkF+g}5WZ;idJRk)^b
zZQ*YG;qTBho{3EKDvXV_O3AAWdkP~gxd8}7L}?X{s!uo6+>)EEyTOBXjY>W{7yR5L
zKQmJ^jn<g@Vq+;=o^EERF}T$(Dv};-#;CF-Hv>{oIH-QtTUqsfkAhIfd@Ivh&JsIz
zKUS+$8kdG1Gw&`v2KZmn6+6=|u<BwXlP#4hvze*p>s~jPY1FdiI&e~Eb>82g%W$ZE
z-%Pd+G|YfRK_bO+-o2=++Q@d~dEvFvtHO&4hgA2rX|!?6m?O*zXr|ei8hq(sy*RDD
zE<CUBd{uUPv7E&B)dvokp>D~$Q`u&zk*QUH02*j}viUqZUlvRR!q>o13T_><`h>2P
z1!gMwCV)t|1TS_rD!EK$k_4T>N3~-3>iNl6nR)?GQuPxt^Oc!w(M-|}_<9EDTxpam
z4L4JBr$7wloSUgvvtUH?swZ2d3dIlV=Hb@r+%%bB9V9v@!xD7bSpZilk+TFd3mnq`
z&|u#YmZ?<Ll<CPWTvxbWq2)HiP%@KXZ$Pav^}PSQ>sB+f*;*Ns5_D!qy;-e-VC&(V
zbGotJ0HMq|NMUBCQqG_p83Eo)hx<V78Mj(2Ri@3<$RiL?<k3z66q!7@LT0LzMcaCw
zwpIbdY;6vBB#`x2S3xX716#_FDgcm(rPkOOv2nY47Gcnr@CGlo%w)?|5K%qTtbs;V
z4I9hFMzxqbKi8U<LR<CkOmVtg0e?BCzP-|ZjES5ElIxf271uHow@WiIFfRO+$-7nX
z@Z(oVdxhHyx2uM?fx#6rC;+KIN;6;Ykmv5B0HR@ox~rSb7a(i{o4!V=o&kd?PR*G|
zoB1dQ?5Z{DW|V!+I$N0rI+;hC>wszF(I(I`fb`DDvrJY92OROyqhM76?kl73wG5(M
z9Pl?8P9m&mwU>oJ*(ib=%nxvaE&%9*KMJFFo2tGW6n17H?h4s@u?~S&LdOf05@bez
zd;KDqCc!a<dlhyUj>>e(W5ZnUyL+SPD69One6IMClu#0}@CSuI;8#1tXPF3X$h$uE
zuGj#zp%r<yS)OT84dyQoRgcV&TZQ}8V<kb+dZ}11xV4rkt|e=r5kN9XHQS_a=oaNh
zajJ+9{0+_W`Eq3z+#}L>Jts1~@K@^LM)|5)%(w7FrbYETM@^-*Kl*4IrCjq!_pas!
z@?8~Gy{J}5c3SYui^5HX7pfK&%#6-q74j7*z!f!`uThmMu<<d}B~8ac(K=)%Abcs>
zJ~&1OR1WGigm9&db0({wXJ(6e($OmQl^TukO;9uWZm|qGj%o#R>NT)Fqr}k@>hX4|
z6Utn!Rusla7|I9g4O9T|p~+?gdYO5%L%x}<6{$N=UO<5ML2)a-4u!KN)nLIX+^G4g
z=oNx=M$1w!c1B)AFi-JF^-eI)-$fPDaV#ZR^V0274x_F$GK~dGD~-^S9-E{B@ZAdd
zfHb{Do=jygi2kD<7H%#K$lJpH!U6Ti-oidrew&mBcdcdZ@m-~=hANP0R`bwaA$>)K
zk!F<MSO-2%W<lBzNAg&G1VIewR?68Dsw4`S*Sn-n#rHXr#hfrJ`BZfzRN#PSd|tS#
z@CsG8(q5xDAm3>iR!hZ(Mvi$^UcI0`m(lA4RijoF1=rLIDvY{0f46iod>-h*Ylj-p
zX;sx~9PA1(zg%~-wOoPvUZg`LEAy?M8r2~-7JH$plMaRIr|#??)gS64svUegL-A=k
z9N-WND7mS>RG2^#!0ZN7p!DQQvr%nQ8#2n;I#Jg2@Dyr8{6ndMS^_njB1HzLCRm9=
zN;<PjSUu$Ek5vP@uK`chAkZTffJOPW)UBE|qs&2EgKCe87}v8x1v#(y3c3|eni?ua
z3RM9!5!VaoxMYwO1HW*~6{CL@zNbc{S`}FgRgR0Bnvtne?Hw8N3Ov+k1+}A5@W94o
zE$6?y&}dZahYuaf<;z1}J@1x^7ivRgw{fUkojIh--hKNaw|?g#OvK>KOldI3j-jxI
zn5Yh{G0sM|nx-@_q}*No$N*LikL+)`s{6sm`C=W?c20!z>PKF~Lg!4Opdw%cwGBNR
z=G)t#>ZLuuJ^tLRBs6LODPBV%yxlzKl7)nCUTiThnv`$zs`O6t5K_335v2m<Me<!6
zyb3u;BU{5$DjllK)uv2|tjVlnxbVK_-Um*caK?sDjyQLXoE#oKarf}iqvIoI&b+dv
zTD~g$RIR_T3eV19MSo&=?7jzv@56T|PTXB84pnN?=9?{CxL*XNOj8>98>@LJvv@+x
z#L%~?*M_-^Zd7=!zmay2Ar><hgoIUKJrt-W<V^#s9;vENRi&A^Jld`v!R!Le6lMu1
z$eZib8?qqv*9_K6VELuyOc{WV_KjsOg4sePR?n|dUo<M!l6%1|fv<>a$VJ<jDsiPM
zkzmx(Y9q3Gb-ALuwM%^{@5uV0^-=+l@3yLUSS-sjh#X0t?^e$vLL*Q~<oyoyUaSFn
z?L<P@I9aKj$3y4}u+Ee!wOVDi4uqF)HtTOh)AHT{dzX5y`=`WtgxusK4Q*T2%NyNw
z%yJG`C-O{x0VV`>E_Xg$U#NzzBYRSBjG`6AkwhU`n}fH(c2cZiKEgJ(hBZ-bB^^lH
z*M!e&?xV17G%^J@D~h&(?2c#=weH2bMZS)_Y7}Q&$OAL?kvBBLQE@-MF7Z*eoP*Xv
zu^`p$30u-{LV)<IUwfm$@$18KHBb>)@(jeb>A`(>*FGs)zp8W-C`2m|m~c?lT2d8E
z5~5HM5Z7jpUlGtxKZ}Q0sj==_KAp*)hcH%XP6G@6sz8G3BD?B9{gSH$t<h+_y+j(3
zOFKZv#qv~zh7Yl08Y)-)!P4Sd?`tUSKmSzObudELiKwJbWy%T6iTx*w^_*LRSOm!H
zA?@!pO{9?ecJnStIp$3|p$7d9f#Pp8whN6#SD7lx7@ph67E2(`rh&{J^EOwjz*Z2L
zJA!#<6Ac5|T!E^fzu~|u27hGlizYO`?w2BEcb0&`>$S}?tO<&j?~-@4+XNa#uy|$9
zq-wpUwlod3PPzyKDXbHXMzC1kmdh0L8CX$8>qm1y5-GcrHd4s<w0GNc8KwW8cjtie
zd6`~+1MG;?<tzsze^sW?ckmn_;0DUS5}ErZu5pTGs$>2}8W>>x#Im?wn`OZ(uxy8^
zqEV=UHZx+<1CNp}U7f2|mByO1v`B#+QXq9WSMpVd0pTsQp5`=KtenS^&0sn|Q!fN3
zXn{BHu7UNoSk1s(SI*Lgo0-h!&cj4lFQA0<=f>(BEZpS`1xmC0D1;Z6x%o_Eu4*i9
zy5v<rV-S>EszSb(^V%SXMYz8ycq2>tUBORN5PHIxw}17jRg|t*hOhJP1zKsST=?tU
z@*t=uD7GgorkgWn1pkU#!(v;*Vrp>|R1j(B{3K8cMnoF_h0zR#6>JYHKryj8rBzXL
zXJ{O>-(MYmtE_8=gU$z4ToV?VDVCv|)MhdzC>~(?AxI(+t3!e-d@bA`R1)c<G9bg8
z5xm?MwxE}rn}nAh!%T(4ye=$7<(U`(s-jf`gckNB0`;JnGW4Ab>)IXGCBw#&LFvug
z4mInwLzBhwp+d3QD3-!cB9IE|Rp0CgzA-Ptubi+UXu|Xukf`BI!6LK)s)ZU7fMGk3
zNg-!wgrdz=9tvLWpfIqD_!}sFAObY!ly#02Nm=TJFDdZMD#@tbk3z*DX@spSL9<=I
z5bL!Vl=T-|^b1i<fR|;gtuL7MR`gwR3E@FCfUT7@Tdx&C$`onM=A_@RbbfIdftZe8
z;qS7ZD4vMH`s<-3!fp-EU+5RxsvT{CWZQ6ByUYStoAK)vHqlGqZv^O+S^k~S-nJCW
z;E@o7vRv?Y7<&vxn5n^n54O8b->*?4KufR|P*i8C#VVFrRL6G(!W`q!&L{Xo<jYL9
zoEIjBHA3z@wOh8@P{b{KWD{o;EVu|--{@Y<lBuKNJzSVz=>@-<swfBMt@^p41T7p3
zepFR!mT6MYC<mc-lROE)1`eW27^imJ4Jip-AIi0kulDz7-~|s0@CU(_(cmmx9e-I=
zep9|P4%^^E_+yW6^skJ4B9zAR*Ti0U*$Y`^D`Piy#oltY$>&$ao-4NBI=&{+J{^Df
zAl|KdBhSa{RXwfaFN1qdb7VpcXr}B#t$BZ^^&AEV*y!Po(gVaA!QTkD&{Ri_c);H(
zi$=(J?UnFXLtyy*Vrqo2%PQB?T2dX>r7o=T&@Je1fdv=vo%gTGq11VpsG;g)pn1><
zf=PeE-%^F2gd{19+lSpnt?Ti)KBPdvb>ShnQCTvg3ylF8rgD*QUueFC*(@vA=hlXb
zZevO+03946dtpud&Z=o^v1}P;3VDAkJ`ir5xkx`Mfksuf-kh|b?l1~&-7QTi^T<3b
zn_2kLWSs{!-rp^}3bY5c1SEiEEjeW#!`~J41sK;Oe8%D`Ev)eu@_hOI#@2)Rg-x|^
zzrRJQ%ov|U)87b!rxLBEvOSsIH~fW{ynNN)y!N_u`qr;MGaDgV_3TSuD;kHTdhlP5
zpYsEnRgb=MaM<s_Qgoqzz0L3+{ooIewq+}-#8>-18)FLkx%=O}3(#lq>+tQ<Z}`f)
zyw?Z69^d_+y-VS*pZ#NRHu&|X9jBW<JfU3r!%j!1W#OQ|S$hUy4WR#BIb}c|U|Va*
zK;G4QOKZF};C%%3kk9TC{$9)-%GM@n#Tu%D4?gK#l-J(t)a@~K`w?|}gStJgZf{h#
zH>n#3!fLNF)i!1;gCN=lNQ4z*j<s($-|{|z!rpJ;!Y=v!FsxAr&X#7gbM@9c!KT5;
zbLVN%BZfm2rJJkZlIZs+qZ?l&UJiKgN1gsQ&80xYWojva1xm~MjDZO%Vr5e;JFAVq
z5M&#31%#ep6@X=dkQEh=`jGm(aEJNI`%BbcIO_csZct^u$kx^=eaR}~?-@3N!Vy8?
z1cJi)cI{bcBAl%D<=@g${ar6QeWT@ljg4;N*wu)<FYv*7J(e+_91cF-=496Ii!67@
zBG(jU1%p)zZ503v2D?s4Ui`HY9-Qz8b$qeWoI?o3hDH{;KLZN%XuWTsQSVE<e3KXU
z!TT02{@E@=bq=)?trA1xeH(QjUyVU|-@#uPjQ0<?qt_v?7!*hk29VBr-<2ZXKgLVO
z=OpWWPnG<E+?w7$<L(FXC~B}WM0>E_6>Bi;c3rcZx0?v&ORCTfhFI!v%{6PlMyzsG
z91{eId7`E_BK-Uv#0A0EDa2|aS_yJ*{i{`6OMsSN!H~xMO>hjmu&=-<iXZgdK-ZdK
zoYQ92l9CRH<kCN7sp9uD7=jo<=?QwmGONLb?M`Deh`fYy(NB3pkGK*`c(PS3AsIKI
z6~^n-6Jxo6(+^H^gO_7mCv(jiKG;%ot8|8Gfwej=zjnY918_mAHtVL)I)9xkX)(O5
zI?e$lz-wkWdWv88s1PvpgdZ2K(GV5?dRy{l5GGcsWuTd1`3mFmdUlnI!fow*C;knw
zH?b<bL%<`1Wl6mW&x?P({UY|Uzdcxv14Q(ygQMCKS7M3$T`+FJhQTm}P;iU|5psY?
zs62rs#`P)h{~%HH=bJMy1-M%A0$}9<v}ajRaVfA(o{0IKT1oh*3MWjyl7Vdor4ZQ$
zPc*%@;g^CX@GD&?){6>7x4|Z-mTYPTf)5eMrf5P)$KQhSFxX3};XoYinFw6m9W<NG
zkO6_B11zP16P8C=SStf$>*V&E)3iEEBlLcXkhzM_M2P~;1VMaYt9U+m(=B&^D3eN^
ztsZ*+mKAM+>Du_fHx@3;W2G<$|MSI65bFbTQ>h}W7F&->SJk{<WUV*Q1_!4dmf6a-
zuRKREfY!tel%h=bgRh8nGa%!1^)jYodq2VUmZV{)DX6e4Vac>nkv%<cK7zy4qAnA9
zetg6$O=A8VV1UqCp#xEcgdQAys-zkoqqeEw$9nvrK*aM6e5n5RHjt;U#ij0V;$zyd
zSV&&X*Od^(PZkjgh+xKm4T{7>h5b3bHlq$NP4rW~nQ|g|cSN74a_6uzsn5+!R!Tu6
znH0S;_An^D$*OUaX;nVjY1I$T2zw)t{Hl0e`pqi85A>g_G)a(DC^sC@f4>W(7e#F=
zbP$j%0_f`EyhnEt&4qA5(z*3`bMRPZZnFvNV;mU1>dTWAX_5^!h~}jC0pO1J7q}=j
zEv9h&O`8`3-dF86{;s3OmhXT)tJu?)(Y?No!s#WnwxuNgyE(%m@!!e6sNRf;w5M_v
z(?dE5dnMkzRjfqxrXNpM?4RmZZ%VOq*ea7!Q#WDmveUI}wGimQ0$l&_5rj6wh*xu9
zVR5Dq(p#CuqS^`S4FTvB%g!8_Z{W4C0J@xtEV%!C5<JU*yB`_3%%S(QtY5UYwQ2JK
zEEL7QA8{kll}Z^ERUBwiTmwAxtMKX!^?kYZzAv{P$A69qKczt+@>ra`Y6akg|Mocp
zx9&%&H$_TLfj8IrOc!fgby%RK+YTFv)HjV)lNd)*>kL0(bLh`)(x0Wb9q+cT!3nz`
zHWlefSj-F}20-&z)Pq`6#kTf^pQXY*d~H4t8@Gu6x#=@#8^gK~f(F1L1fSaJQyfCk
z>&HOA^(C=je-pIM!zvUT8W~J`ZtVh>vyfbj&h{gL_iJJ5D?nKb)U6ESOen+kGA+gz
z;yh)28=mrW=yXJ=`JXupcB_p8*|Ia~I<O&T%ZQE5gU@37NY;T@6v1_AoOq~j1O}1F
zo0(?4;Xp@*pSJ8wNVP+px(Nr%6lWqzT@yonY<dd22^vlXE@}N)T?ByYQMT?tKQEy&
z>5Vf%*`Qu&TcUH9YJ~R6S59Px41EoFB3*xY<wgfxL`)(I&VNK^-bP3(KE6#EL!pSN
zi2RuR+Y*JA8HE}|UkFFL(Le9d=+ZR<KheW*Xb?sM&vi17b}u>({qr$&+iK&0J<u&t
z{IDDOdQXSyeT~(L62#t{(cRt!O4{A*2n!MCo7y43jSC{T4XhmrTCltFPd$Q|zn04n
zY(Pr3=X34SgwxK~C`u|c{3$X}3(^9G^=j!9qk(>lnuFoSOl|ClHnM3Z(2CpGQu-P*
zt_5B9wygyMC{vs16^3J|6n>&BtnLdLTrp(By3@3~OIOi9%&DWEAJGx7QN6Hrb|7w?
zpI;=$GfFdT@(x%ym^$36d1%!&@N~_89O2dG742SN*_`8vP}WXRLj;S)?zU`>RvT*M
zsF1}%6<yf{%yenaJG|_E*dRWLX==-0<6LG-bPT3rnwf^9vm3ahLjy}^rV$Rqo*NGH
zqNM=T5-^>{-y;;ep$&?C6zCXL8E)Ixq?g-KO1J(ID*F0?r83)d&`kwV#p?thx-`Yh
z`_Ck)-{a-K;4<(1KCXImkoO1p+o)CEr&%UOd(UqJm>BInbRMfQqP-5&awaq=?z;EX
ziK8Rq8AkrTasnhMn+uhqQ?I%?iBcj#arvvMFr-sDo`(8Pl}mF%cUm)oIwkPOvuwkG
zSK3sYcV>&F5^0`pF9!FKT7&9_`tAi6(6Iyu<z2kHQtt$+5ta~4>>)1CROQ%PXquB6
zbl0<!*b?Lv8$*4g0hhsWvJT8(W^{GLA0ng@+=$)c|Jx2I>_0}RzenFEU6=;gia{#P
zakfN3Z`1Z89cbH&GmqWr(`H&zY~;$cskIx;cW883427dH4CN=xJUs2N$p*%fW?-wC
z0fmV+<hN+Z%R9S~3zq}pKl2PA3`=r!0)3Ap$4!f4kp5fAdu9-Yip3sdnHp}$iD1!l
za#(>Dvfv?EhjF0}=$;&60G4&IG;GQ#&Fwc<KOlaei1`fjJ2-clkd|q%t>)wq8aOmX
zPXl)3Ojjh$gA`0zB%bPVuWY1zM+c<zegJ6`6|FDsZbUYPsHibQ#qP;_I`m{I49Tnr
zBJFrvQMZ5dBIiIa5xni}kgUQ8B(SudxJAKnVDZx$fFQP7kWLN?FygC(NdMce4t|~;
zlhuLeu(vnjVpasY)2S<hPP5)4qC1dIbn)6FAxeXx4<ZhWFitVFvtwD65|H5aQA3hh
z6Muwl^oXojQo<xUxhKL{1RBOQ%y+V_UAT;SSIYG&KG=hcMiYrA@UD}0*UR+=xjs*>
z&&Snsc)1Z5%-ddd+lSkj_X4@zB-a=6#cJ<n-qv{o>b75A9gypbaDBo%h^sfq%MdSg
zn0vSIaw{*l1<!8hUw80wCoeDN<t4nll$V#`GUgqY>&tOPD9>GdPS>{g3VHlWxxPxS
zcguBHuJ_3Gh+L22s^C2$zwhPm`*=Bq%M;!xt{C$V;RgS)cO3UI?*y*mDfUkCuQ6Uu
z$(z&sldfOye*ATuK3{K~&(8327MCZy2lyu)x!$Ys*Sz<jTpz*}4LvMBei&Ery?U>a
z-;dz>gm;dAi!arCE&d$yGPojkDT^Dtm^pQG)oohcigFw9K1IU&Brn(Vat$x<=jB&%
zX?o`)#pb2R6Y~0rrZ=Ns$;YyEmXCLtkG)@z8Y-&2N7b#48+z7Mw^?<YQ@6*|?UK5^
z0XK~Mao$#WZ^X@eGcL+a>AekqqMmtmdpmApp09qqLw*F51J3tB!n6kt$BiQ<O4xFW
zg^w-O;O__s>BiUiSMOYlf19k>KiaKp(F8uH`4cx%k${6ZZ<~_B;JD8Num~Je@q6tG
z*)pRum%^$9u|qAHF@FOikQn)Rt~G$j71|b5xb|BSC=l{ghWlve?^|0gqr7DWNW+SJ
z>h-S!__yKW`WumfK<74CjS#u4N*jQHy6IA75-x)Eg<>A@miVh*R}(zgsCFVDT=qEJ
z=wffKSFmnG**?UWgniZat^h1*!TXP#w5UV!`*_gS#|(3^0_xx_+_~5m4{@PF+|r~5
zLL1FQDcO;NAzsh{c(xN_ER27T%dY5~&H_uY+{X8?(X_a}&ZuA_fY|Tn1Qz+*A_SI9
z^0QfBc?U?$H{(**vPquI*R?p3S03@d?md-~hr|HM^Px_XXF&O`xSx;_lQ#eK|1a5_
zWkP@@j>b``xx{9CP=y=A)H6BPr-GpeA8jI{T0(u`^K;HL%g%7M=G=C>bL(w~@4V&k
zowqqmUN_YDuwD&j^I(8j1QzSc3{5V=bt8>o6%_?iDsu14K?hk>U=?z(Z?IX)bLq&W
zXANXzQ{G51H6bq+oQR5VO=vTD@q!zel9X}hSv0Pw+4O#*<dXc=q1n_(41)-YiJu^*
z3qO^=s6Y6_-HLhH6cmy1>wuh#kF>h^LAQj?!K7Gmh?Y0kom+-(8M@<6JFm@+!8%cv
zZTn+iefja9X!o6^IOUTAUq)<DBql4Htk|32Gm*<10Fv*4Y$I#rP}5n3VyQ0{uibck
zY)Ux7X8a{e4V0D0mNe=$cmfJGTjS)3wbzVKI&5I!YrS=je}>YVzk<Cm(389!st?{9
z*sC}4@@8J%!pqxundjy0xVYXfT#v8uuEfpXgjh1fpEv4<Ti#W8Fz@Y_>(z4IgDcea
zYvjkZxH1wD>XA{kym#Q47U$RFPo*4%ldwtQevPHtQj>$Xo%A8^1*}<C(H*BeO%r<I
ztU~p{MrDv1=U{#C7X0syI|nURobZa?tiL0P@VmAove3Feh3sQUx_G+XIjRzeNMM1a
z(7?WFy|G0|G_8O|i$6n1+Dxc7wD{A>iX+3^4O$dm_U6eZ@{g)CM7DqoXj6;PP0Uo3
zf%9X=F6VDM42SdK3G9jxCO8p5;ODSVjL@|A8|;#Xj;w63DG>0(p2dr(!LHRR%$^p$
zX9W*h?*-HwO$Thd;qNBlun>R;{I${{?D@i0OYC83<OkV7x6=~AWK>gR@kzAWp1#sn
z8sgIj3ABWR`3yi%+caC=XHl7tJg8F)qsC4&_Ql_fE5nP5h*!oEiLbdm1N$)esg6+a
zL!f9GXoEb?9rmc+e`3kK*BmGG{f8V!*ZHw7>qN4|0Pj@qK8TuPBoksbSdRBm6o}xR
zK~R%<vps@-hc#;i{cXDvFZ%9N9o{KiG;P_q_&wIYG-4m{K7)^zf{EVe*orXc|AoJL
zhK1|aF9i#||H^J}4B(&<<SXo(IH*Ge(ZM1Au;k8mKssILx4NzKo9w5+aLL%#uh^kV
zwALQiZUQ*l;ac=v9M_`n1lQK9mTXKLWbKy`(+;4$o?+Tcy1+C8g${Ujt(wrAm)zA3
zc&6*z*KM7P$FsOesk3oMN%fY0#Q_u1W(oQ@32Gi~>kKJotexCFggg<02#6ij`cB-S
zWy(Z#qUGsiP*#>UdSlumkI|F&oG%6ju8zJKVaU&B)7F6ZK63S+;3Wrw^(IKQfd_^!
z=jFwG=zEdEvc_Ryj|9?uO6^`;y<kh9y^8IH?`6wqbX{yDlSml*m9>2F2^EnuZ{=TY
zd@%H6VV%0vE%VBAO(&`1-1EuC{A1l4Y(g_Y#BKw>Zz3vnYLv01FyiTKDhI_z<KO|)
zYr?=+K^Pb!#p+JhF&P`2`W*Hh%nbG2Q)v_=Gz2ki+VlXMBFu+0>D3XO45K3wCzRu6
zyvx<7HJv}5gmB7YNlmBs9u$U)@V)Bxlj`<9xoM{R?=bI5)cl`#Y<XwwxiqWMb&_eu
zUJ3f+Lqm={KYZ9pO^m@UO^1<)<*>sbI?R9s57rqyNMo9QjXYb29i$h+ezd+|iE6A%
z3l9m$vy`wu{i@U^un9)8*kL2PY5}V>hL(Gurctpk2XR@HL;>6b`v_sd7j+G$U*!W)
zHf^ZHK*y!c;!P7<M>$f&nE}hNGcg#kP;~sIg#@2scNR(0i$H>qem|M4*b5P3OA6&Z
zL1?Q@HWE(>l9S{)BstkcscA=a4LQkxZ&VOgj`^(kGwaM0kzuil<a&tBLg*=?R*|u?
zhW!#1Lz1w)9~2@cRU%qb@86`s7+=s77q#j<eY#~$+@B=j+iU9Gs_@jFNlaWk%KGjX
zAZ#`d*jF2aNDCZ*ndv98&3v(P>&pg_5zd*KnyI?eeJ^m3bSx-D^PUax<yWTwrF#E2
zfK$|!un6K`VC!4qG?G_#-0|jpB!w65Xamid;mmi3r$EaFKC+DgXv(~_MPx&yt@t3x
zLBtI6trfwHUZ>)dC6HaXz~meeoJrM0^dyixhU1s1O$&j)v+@YMyA8<W2)y|PVr2%*
zVP3O{-+B{8t1C7v6|KDgmjnKLUcQ0Le1JyYx9~HF>Q6%*y<$rcVjOjTbGA^#CPzu=
zgZ(sFX96xoBq>LJ^h$X`xg{kC-{222B#TCaR2RsaC#a&6VmT&b$xz=g;_Sc|v$ebg
zz^iJ&oU^5RCGeX<ACiF3A&HU4j>*$<kQ1s=)tbl{z&MVP1@H}|Mh-liI!Jzdd@#1r
zV+SUno#09Y%J*A<h)r<>Ms^d|bZ8=sLS2}lXvzO)WC|kr*>~_!k<KeVE%um}1h#HA
zC%x!$0PT*h@XKO9od6LUAQnBjY1;4g>Fg(7J98;%?F}b<L3_*EidN*k((bZeivC@=
zL$%gXt2|D<Yw>F3?h_|YN|Vlj(zmkCeWxGTZ_`h^LKd{gdW#jInt41~aYW7Bo1$iZ
zooXhwV^*LX8a)$Qqgt1NHz6DYq7w@WZU-`tv8Rv;Q<31&LCUZhVPV0n35e8&TrH5f
zLtM_7Q;{ZMmfX<DtpYf90~yV$rOF&dIae(v^AvU);KYmiP~R9dDLF-ei%!CwJCM|>
zQ=(XkQzHLov-n;=2N#zGsj6RAo;XP@;HZkz{7V|Rg?x`BairI(@(UF4+1QwZe8ppx
zS)>529VBk?m<c4`hO!4?+pL=1aAjm!YG{PP+!t{U2rxkMFJKvC%o91JS7j~mB4T-?
z*38EAz%8^kkzU4jEzo-_5Bh;NppPqg=U!l7Mf=TQ^`*DG^p?ZCID>;Y!_pah_2|*j
z;mpy|GsE|s7|D!}-2cGn_{b}6#p~&6lj=?hv~O+G87!4%4)b^n<nFc9#uaW$fmn_E
zA|Sl9_02LA(HFIWbzBksHhHYgAF)vHq>%>ed05U6Y>Z5%vUyDy?dWMoXBRemM2%ch
zOxLKa#$Zsufo)J*OAxBea))zS=E5ZtC!gznQw1Xa9ON;UrP72L{+K{b(&^1DW={`s
zAZ4f4HEkha>tj!JAdnuZu}^krVp(b|`)<_OCnKwir^Q?@0n9&GV}}sDd>MFP^MP$K
zgt9yJGd-FZv&${fT97)z57KD2-*ZSrHrw644~QsI*K-`-?zVr?q!9qbw!R`JA4YaW
z+8A0(XuXNi#MItkaNdWAhsuAj10jdj&bKIz#&cnGqP@71ZmZ;J3b>cH1h^%gVa99s
zuLST#`5zSG8O&1VBtWtorDFOxitR_at``K*kQ1G;{Y~-JNc?Swro~NU8<!)>xwY$V
z;e}SX>yBn*J>P#$f6?-G-I?6Hz1(<L$jh#~Ak(evyz|$og8|j%yRVV>x%n=5d?$Y-
zbJNOhJRCgI%dL1~h!5SraO^C4A6_Iq>jJy+bk5bMazEZ*5XgVV%Q0R?c==;q{)m^~
z<mKbIgnnUuFfWDYrQp02itNvm%4Cf#m5E7CDihV8m3beQ8lTGj5~MrjH;%+Z_sDM?
ztug8*f!{dt%31_$!ui9>RJVqIb@UrAg3pGF|Mkg=m*XQ2`@evXxS`hJ)Mv3Gm~nZy
zn=II{w+xn6Eb)=;6^44O*60msxJV<4MS^pJ=P$+={0Hfxa$&Y*w&`ga^l5p3ae{|-
zae=R1#}@NXO&6?b-IIiVZ<f_pv*PIPK6{>1mev35tZcgp<^rxf9ETJ@`~<AqO-zY%
zQcNrYU6soP;8oUgOeK;W@+b(N;(^R9@GBN8SZ|+ES#Mys;VOcr6`Z`lb%;(rXk09U
z19*(Q5L{Yd*6ECdVI2l<JjQ8X&FKPsH+>3sfD~{wa(Yb?LwF?-W1!nr-v_C19A?%D
zE#%6c^Dkx47Sg?N<&kcK(%BY7y5A1DfJ{Cn8V4&O2~iz{&*h&!fWSnO7$2U>e<OAu
zMcv4%6it|fhss|!)b}6`*<hL?S^|0EhioN7mdQC;90MI2aCZZ(9Hu!^1!!nQH+bqA
z8HvhWPb9?;@uH*QK^l)@4CNU=8VgPCSa~$roQ@`G+H@#b5-L5kY3pqVZCZq<Xw!ih
z^+HzJwKmNvdZ$f$U!@Av!yFb`mG(qmmIN06jV;^;Wm!F=4(<JSKBEHd{Vo4u0*fB2
z%mV39W%m9D+gY^M?0ucZ7sy`mcP#UiWv}q=Bh4JeCD;tiC*fvbzVgTwpW4m9M1H6M
zALh!h2WcoaoY2S6Sq9wTsl`<)gn&?Bk$<&OWYsx4okF%Xxve6;ibJ@Rtk^%&ZLp(0
zS8o9w_7+i@>XoSmb`n9xFx#D+$Cr1IqXHfU8c9!%o^>>QVi6-t|J;J)k0b}2qB|}c
zlHpdQORPAmJKCU4(H##RsZ{4`B1H#s`(;x%Z2gls)vYp=a~qXX@$S&<KUAz3gO(0c
z*p>3RZRYbkj5U!~>-xnst@OXnMJ;f*I&>j40WS>hz~<)f<Dq|z3L-H(KuY6zm^_Q1
zh#H(0Zc$f}Ho-b?_(Bu>(EE|=@-z;BEy95dB?y>aKwfK@{jn;88lFFhMI543prrG}
zmuYy_sJfTu9JQKrDwE6+P8ACJJa9#+^Qa~u9<J7KJ{S&v5m%kHw^i)ob!UL&wD*iA
zx4rwNk-Uqgq7H~LuSB!M=|@oK)G<luGuItV!@@o=*Ck&|Zc61|X4QhgvYvo`hja$$
z=Rtaup<3eZ%CM@<No=nx97Hw&R*ftKD2arZn(*OGEawkFeZ--MCDy>4ys~t09n(80
zL-+tT$c?E%B<;>3bD1y=Q<jiM&SfNMFDMT-LImp-Y0<-RSFD9SkH)4Ua+X?aEClnR
z4?k^Y@XL?C&kXO&kN?zjv$()4T1@Dddc=e}u!N0i;xvWl|HxS&p2`7BN>SV&YbZ!S
zF%F2^Mo?Vw4E?H(6F?<jtxjjea|gsPY={N4!()`dRuGlxF#eU;94DgK%Im4_j5SHW
zzVegQx421q=+n$md~C!ybL!r+4-SuyIHPBr)8nV$rXM-#>>WOX-+Qq;WAyB?QxBX)
z@c;Pu@Yvahom2NZ!($IS$4AGG9&|<?Iz2ve=8SV{+!;N2`o!o6o{f$jIq|^J(XsoS
zd+^=ZDX2K3P;^k~*;5W1)K!g+;JbUBlOy9tj-lq^dqz);o_+YBbMNTcG1hr6DjjxC
z509T6J@UYb;c@5m1LLPpof$#%M^WwA=-9pEXl3N&$k^E-w2EiW$gA<gIdg3I#0hC?
z_yP2OT>5w9)ai%ENAEj!);T6Qn9n%(jG$)>Mo>**P)AM-kDff}934J6d>?x^?wmr0
z$EBF=-Gj$Q<Pq8%#(zi7j-DFhFpiuWJ3Ee_2QkX=v%#kij-DAg=nRjKo*_W)9Y2NY
z2~K=Ln2qtfu@O}ZK`p%wW&}kDum>>cpf5*9hEJd_OwX8A*v9&Y{<zcZg3ZeOg2z5L
z!_S}@wphvUtvoB)lFmv(8;nvg!(1)#{i{I|mxVU1%7V{c`g!46!!o`stkj0COje=g
z*>js#7uvKc@Q#>Zo^=UCy)TetK95Uag5i_U1jAPz7d%g`35LV~t?DB^GQnJPf77jD
zxmBx3kS!KD*dXMV;J`6!ZMER-P|jjJS8M{5gjT;tc=gUq^G~eKuGoK|TQkk09CRie
zG*0kVgI>UJb5z_8a&iKW6jp21`m8qC(5rxCNm4gMg7xAuTw~>nJkxN-2JF2HRVm5F
z7OvEqh3&nah0p@9jTJ{tJodBzF@FvI?`Te#(UeW4kwe_WEu{hnGY=_SNt1g?7s2e+
zUebQ6?zVeKe+M*`x`&i6^d3@Q@0?Y_&mO(nMjC*K+eqWVnRj#X!;_EaoGG495d^eP
z@~n(HtOFOY3qhZ$)+o?60%H#jT!Xm;XUfMG=l=4mv(V<2l}8)xxv>EUKz#t)?IUOt
z$%z$DGIWhPEY(2K><ED4Hz2GS)V(7dS2SRvLmd`CMphmm{R)$Y(bCfLx@grUOl<PX
zWM@4K8RL+=BRqd4ac+}7Zbkg1b8>LZY^~UU<Gd}9e>e{0?y9%o|44F3y)jh>a5=6w
z+CKCY!2ig26CP%Xfe_=UoWTQs0DS^wZaP8UXOS^DR15h`VapSvT~yA5OfiP@{yodD
zJeX?PEO)f~3PTZQTj%R5KfT)&c~w?^dgBY9PEIKAHIR~$pFmUbIsT@y6jJPQ%^BjX
zGTx3(qB$69GlNEo!sGp2)QJ#7l?YE4P1W`mT7-!@XX{^)zIMF`BOyMw2wP-QY~fnZ
z>P6U(lOwznmtYabC*dNDuRK!3Q@aQwF+gegC<(TmAAF$gX3xa=@9W4~V+l?5GfNzP
zoTC>S{4oFO-QwzF$%?zr&@6JxUP#6LoF=nxoImM=zYFmq8NCe$@Ao+bS($(rwFUh^
z0`}pV7nX(?KDK7yb4frgM<EHL5dI`tab!qLa=r2yodunPjLti#@WJbufuk@ZbJ}9+
z<=ygU2JXttWHxucfn9k_td4hKCgyK&FyF#OCtO}F375wfmt|Q?gX^&%P!chmSsfkt
zWz^hWS9b8>B6BKt1bSLd<uD6%9CM>@I-f4l8F?|&aRG13aQoPd(3(joJts&PDM$sS
zp3Q<3*=$LJf5^+KK3skv=wS{);>&q?5lO)(g+&suut(x}YE$r$Qo#5=)=A1Pfz$66
zDJwo^i*s3gzg;0q3JegUB7gSsuinYwo01j#<J}rL(;2lbm=gx7e;P)VPPvL87s<v@
zN0du_ioqzzxCdALG;E#B-k^3$h#_<aDZXS~I)kmhu*#I&3(Std)}3jFnba74FC~~@
znhtrDVxcbaG{y2zU$8MB=@pneOb5Q0Vp9lr5<`UAJzVDAjFiUAfwuhY0)v56zzh=Q
zAo8e*uz(Ufq1M-ZSYOKtlU9G@QU3qZfng#2OOm*`9MvbZDZiK%M{UYB6@UZ8Z5#V|
z6lZWaF_0#hS4m1Jh;JJ&7WIWS+>w<Zu8x>V3^$%V;o~$K)9NEpT`s*dh($x77_H<&
zSlT31W|m7>k$<RCD9gJu!w);haO~EcWG$gxX)5yhK~+%pOT??MoNrrsw(Kshaul>@
z;h8)Tg&fM7bOyK)&HJ#hBO*K^XYnVChjgK%b`ppZql<@r2yq><d(GfWJv&!F?Cd=`
z=LD#MNf8k^>SSjuY}l(d&Zs1i!o3p=74ej{I`TIL%rqhk_JRflN#Ozu8Ur5gg-B>1
z60z>wi=<^Zq8!MqbF!*DKy8|ubaPoCrL)&yY~}o3;x-bv%wZq)OtF+joOC68PlC{6
z!1gY*T1So-ej$R4y`zss#ssi9dpptvptRS*-G?U9VT)*)ML`$QG|Pi88Zr<Tb7~aE
zsC=1FM(rV-SzQXGBV`EdU_^_7Hojd5-l)&E4(C>$17E4=c_G5`KMSOFqDmuG6cIB>
zya~%Z^dsybZPx0N@I)sH!l~6|>L5xLGE{K3)`WtC;}#vrErv95>!HzfR3V3DhWbun
zzH75Zh7`LOQM>FZBR(UIipoo5Xk9cSOOs*Rz#1z?602D#bW_lKkd;dN5$$lWXW!^7
zLH_8<qme!YBaTM#g}k<%NKXGKG9}FP%EpphsVrm{lhug5F7ZMs(zT7ARXk@}Sfpt|
z;QeeiEqMQm1ocK-0vkP_gf@D<@<<C$t&N_<fVIP~_sDv%WnAa<Wh{xM8u<1ri~0Nt
zVIdUx^ZcuKmV#eQR@{C11qc-GvB_{~3)lzhvUSbuvZ4OR4LXvI0fHvTGz;-qKzIxE
zGwN_uTqHy71fr-%MGw+$?x{+%#;r0Cponr&S!eN)Nff4X`x|KMU0*NlwhOj;@rfh^
zgY|48``3EaebW;a6Sr3KXIu0AsScIKogkg;x|-d7Z4Hn{b}6#Az-IBp-`O1$t&VmY
zeOzuWqNCwz{^NvztmfCKp4*s;F)Tg@>UNzQ8t5=6$;@r|Ctq7b{9<qCBJ|b#WwK%~
z95zqij4jOk&y4DohmF|8c_t>UR1YEvws>14m5EXGNk5W9AEk7Le6@(sCN4&eApHTt
z#l$?O)?LWRhv-e&9-}g$N(O56oypc`77u$FSc0u+HEibK!MG+jwa!V6O=jr9EYh+v
zZ)TABG^RfO>C<#@SaX=+VQsOr0a}RkKa=wvaEdO7I*nHJX`wb|C0#-ORyoNtq=&d0
zDoGLx>5MjcDvz6u%!{Yj9T9p}Ia6(dO?httdfny~l9sEJ6-Ov`TMEVg8ju=breITv
zeP`WCod;GK6llwK@t!$9j-5Sw8Vf)K>DIC40#S1Jne)<@zVu~^>=Z1N?E$2#@&$v&
z8n8$Ni#yo#G>xNCF<{VaLQ@~vfi`C#tT;m7@`9lQF^YVqb>2dPUCFuXHMQyEAZ)Bi
zp|))SwP|dQlUoWxFOS}cii@YWtr2?5m2e79G{!al(gO0q-U2z4jr)@oM<|V_;l^d-
z&x<;zQJ>=MJn&!9mBR1xpr#*PCOE@gY<Y?fg$x7o0R{3?Qzv&bNII~51$w5W>)|O<
zFriQCnn`bvq0m*Qn#eQ^l4f3E(q6S$Lzc`0g*{U`ZB6>&<lOX{vh-;gHWs8%)|P;>
zh_`XFilgrGXo^U;c$$hzP$EGrEGzli0`ZyNf;gnB)5(e>bag`tUEOQb74kaEvWg~0
z5{HZ}E=-X9S-oMBs`^mlVk0J5dR3_fv}|&0y~fMutF?#?#T2{@^(!^^am-9k|MGAX
z6Bl1?`CFiOQ0~jA?Frg2Z?Ry&;Y|y*E>;KI{t!W%t}TL85TCOMF47_>+Vr#8A~@i^
zo)kRC%Rh6i^nG4l$e;UoImycp@zUVsQCz~Tul#ggKAV?M=B4<&6paKYN#(Luk;-ME
zB$bO2CzXrPVdWml{HYCHBHbYi>?RUvMjdU{E>3s}vI(aN!brd~$0YeoOy7&Wv{>xV
z5iG(7ewu%^u|qDL2wD?;m<IM|k`?<S-9{`0&|1I<sS;or^^V{rP$0477)m&xB_|{f
zmMGRLWuEn7L+Un5GR8j_?`om~3z{EJ4mw3(EgG6(^70R{;%F$04PHq3cx;GuNSdYp
zTW?hNl@R<LG!l(oSh$}{KD8nohfWlg7)N{+FpBkdcy=1jWTA(Z>WKE==aAbK$5TK<
zmjijI!618M<lIe`7yGq6*FCJ)LV-VBc@)r59|_RKQQ+hYoKn3nV(aUJwT>B(t8;x*
za1~1)9R3i8^$>}yPu#;9q_iKZ7y78`1PY%Gz8=>dMZ+&$PBhfXDiW~#K$~r+UVN|Q
z?Pq~;6A>Wmv*Q8>h+1$)PM#WSzc&vIXsMN%Y0*BAwXDJRXMDE<Mkf3j-5tvJ&mEcw
z4WSG36D>u;L;2WuFgNjT+^9}7=>XWpk2}<@7u~5eW~|S${Eqapi-CTGdl|%y^UWj#
zy?|L_$H7u6_t#H0aaa$|O1@&y93JxiVAn)Y>v7%t1n$TA$WK0ou)e)mA690evVgbN
znpNQ)dk-__#68H@vsv!;$TX`NIv(&Q;zF?B*DJ_n8T}L)_jF`#Ch@K~gYAnKAi^_^
zZ2f#a^4ZYPP#?~6j#{>!&K-?%xSO{0LeMf5eXHF$rQs}V%S&RG<AU~u;2dztnj=PG
zSe|b37%edh1i30=8AliUktHJU#PEBlbEXmIK1EfDL4OfWe}D5NEcfR#k2Wg}*FNd|
zq0b<g?|>X)o{H~`%c{&OpBgj{i8Iux>Q&Ge6F~~V3dmgw>4_b+NLXKN%ngACtl(sd
z1*t;i3YUWebwn6kYtU$PRK0T8vGhzapNAC&>I|KJWjNj#gkM3JeBXft{aKzre8LLE
zsbCZ(&?`Dnl^4pJPNyS_?G3z0d&L7EuV2xqxFYr@NLTi#Ga0&4$Lcuq9ZC0Ct!V_-
z)GG4pvxAIvq9d`0aj90~<Q@gMt^nmV$QdA4nJr5g9p;25G(z=P`{A?LVvsGN(tty>
zljs8pk^XCE357I%7wyhc=YPd!KNw-0qJQ-nHI85yBJ4lFzQa+QG7F4CT?QSl)I8YA
z$LW>laW^R*cLFUfO+V0DR;YZ8N)-t@I2RY{J!LAve8<uDk(F#VXjQN*4-B&v7a~_Q
zXkuxs6V(OGlQl7bX~;&5!pb9tK72F3Vu+E8%+N|ngJ7cK=rOtSjR$QDl6V%9$asYX
z!8M3CaS14|5X9D%475?@@s&rF1B!>de#KDb%-$6g>2cJ!zvqqFnD7ARJ2o7d?ocW0
zMn|zH{k<zc=?B%Mw|X_{OIb{N`#8Qwcov#E95QWTswLY<w;epfHfYKYm(a&`orx7e
zJGC$&4gWnglF(9?VvJBr0NGVE-9)xFQG0bXkBawECAi&AC(SZCx8$KShmIrWkIRU(
zjkOG5s8mJwM*LB1*X*Q=#YqS2(l0ziMqm@&Gp5(p8uzz}g1z&rq^)reDKh><w^S19
zf4`pWY)CmvG(IT;e*rtyp1^h26T}#|JRzc6uadc8(b+p$W9SV}%))U9+!D?Rp1oLF
z%YIhuJ(JT5YVM6T3Uyyi)N1nujA{Aqkwsc<Zc~$+fKXiIJti(I@)fGB#*UUpY_8r+
zDa+JO(9@?!0MPsz3<mW`pc9_VWOD^Tm}_gbH8KL?y|D<8H!r>?5TmIx31PZ~-k_Fa
zk^bQ0n5z9hl4#v)Z`@1TOjA3lk~B8_Fj0IW>W)csAO!CrQ?hV~MVwyRYBLdvCRITP
zLGbX3wQ1<Cy*J{YI!sE!8?n^}jHzAu1GWS}fe*`8qSp8Kl>3JM2=?CiBkoL50fH{I
zohQ4aOM=Fh=p5Uyh`8|V2KHPINURq~#Hg>+(3YYxYB7=~0S_zc``<DtOYx8-EFj-a
zVx=Vk6WZYa6cP&jscAGTFCCmY>*AnUGS&b&hWg@0C}@Oa-$4<DK4xoh11zFZL<$Fn
zqcRVQFoEdXe72Dl6%!Wxpc%2nsvW|x#&V~|9E`|iZ0nGUX0X{k;yE|6LmJR#55-eL
z8){to{N2AGC>Vlk&)N=mptS^R+dL5>kEvSmwN1ebo0RYAP<<E3A2K!e+c34iN?~fx
z8br3?*=f3Z#Gvj{4C=)K;4bDURMD5rpsEwmP>u=3Uh278v1&3nsYC$eEj$}pHnWuA
zr$W39vS=_7d5|gqyE@OS{7&4{iN69jmz=6RgHxP4Xd9Kw+!I4h0|}bjYWKtx)apbO
zUN)u_R*LfS5z5Q1_!QZLV%zOjs69geyA}FRJO$`KE|SR#U`mtGEC6kq5rPTD8jBuz
zttn)v_3quDTqXZZ&_PTbdQT9fDj=b~l=#;j;GV$PZ4>qoY?SS{UfR?9V;!35f)j<(
zg8etr;#DcqVo4yiY$lx`(<6*LqA>EUGKMa|uy}^NlnyV-W}=ndxJ4k|j=$B!t?F3d
ztoI&RTaoJfy>d%=-{E*`2@1B&SfO5g+}b9va3EEfla$dZS_l7gnrU~fVaWWIa=i*y
zZx1f|)CYzXk9pV0yX)n8gIu2{*XQH<tUcaZf_O$`ocD5^&%WcWKTa<7F<gR_A$$_1
z4B;z}DF4)^3?UgHYCk3Oaoa54ONidz@t{hm3=yO~3^tojd2jK}uMkK=q<_u7dKbh0
zrDVna$*yDg<5{B@h~>{vg3G?M(6Yt2CzVzt0F{dT#=*gSqTFvoeIu}2im!$`l{SzC
zA#Aj6&SYbu|0~{_HDljS0=74n$#1dZ=sp2^3L&@SCic6}#<RD=obDJ~@U77ww?%*4
zE<X^2Y2)hhtBac4S8ZK!lY0m;okTnVv6z<k(EW%J98<^Aiq1&HOQygrV5>56$rf>J
zJ5ZMPAGq}jvW*hum8l&T9~yq72rM)}VxDkaZqDHNZshmK;^Z}r%i1(=Og?lCGFx2D
znPTol=R&r`#BigG^MiR<eiHTN?ZJSrU`1D{)=knlcv9><aoULx1Rf6c4PzhZ4ASJP
z_(7pVV|zw|9`21+A%i%$s!}gDDljlfKAa4WopznO3XMj!e)!O#X}B|+lS2s3I~1PU
zen>X;u;42vG65DTz4@VQpMx<>bM0VkYx>(kB<<LL;wbwUcQ-#ak*nQnoI1NFdph)F
zDay9LmU(DedY7EE<9%=gB6n|IBu1I2_wQ3{lK6T83EXez+CZ=TONIg;SUi#jAovbG
zywn=-l)|ezIVhcstJ)DbWj#yF_Se^tQJ{v*3<K<#@|5mC=e!$nIevxJX^BF*B4%Fi
zH0$v-fxQB-dy+7(hYV34k+cv)^yi0_tVLE!?65PAN0ob0^AzNm1i!%60kF9Nm3uPD
zGR5%-uCiYROC$?uw^tShs`4~Eo>O3pL(#D6V2%W2PosWW(*N!rkx7TC)A>siQx}*1
zH;B^~f#H$lyy3<T8=MQ2jmqsYjBtfr<sq70t%xNt)|lM(AAv#%aZ8cgm}Rgy<W-;@
zD$NnQRw&KsGv6!1QGNnE$RB(Peit!}DjnUVwA1p?233ABO~HR{8j~n86;H@VXpr9Q
zg_^XG>a{D6RM)iubR4OUVf1Qm1Gnr*nlLIOjRGzqs)_y>#BCgOX2M+5M|AQr8>qdj
zHj1jH%ZaMbYXiX;sy?&_>JNcPjmybSRxTi5jCne&Z6N`tl@O0kpca0rQU7I5W3CEw
zCv-ZkgdXlYZ~*gg;J`urF+Or~<m5dg<L1}d@zIf2kEma0g5ft=o@9$8IF+(`tUa9Q
zDD0&d8|q=P;m!;)N3qd1O=->5SrNN{q&uKW8L0X&hmh&`H`JhuCGOWga3H2B`ZK+N
zQ;;}&AxPQ!&g(nSoF`k2*4G=@X+CZ5GV(WQfZO=J29sdd|JDxmFGZiyg5qDXI?;yM
zabv?>eX!4Nwd1JXf-fV-vHDx0C}WRjqroM+`uASmL4^aZPkO1nHz=Oyy?SBy{+FIc
zy}#<fffSOohp{73!XD3md>V~s*MS2GUSf}CTkO3(md`wm#&Y$61F0;~9?!0nGWM9h
z^fVgN^9~&7#J%mIUE98>J;HB4jYhchz=62@u}8Jler=Cr?Y8y{@fBd#9XZ?90|%l~
z(;h`%_{tu^?#nTP_)4~uyy?+OR&NJRED;u;{cSTfRh?MI2B!7KQps=aEi}X2Iz!2d
zy>LBrD<peNq4cknb)N3OL)#>mKu{dx2gi3RXbtXF$v*VjgnhfhaC@{EoM=|tT-Zq&
zS?A_6+z4T-SRIauzhr?z)au}*GOSJ{(76uN7M3gJY0J70+EF7adE(o>5|nJMX8?DV
zOu0jp%<G@ZZrK?9_zHK$1a7CoC>h56>XpZ|I~AslqorkTr9GAGY)G2eN|6X8h2sg!
zVndmNjyO4nN9Qp9glj-KB}v=#xnz>Xl8u;fi`B8=2>A%`LFnj0E{FE9o3CBjhHaEu
z>BcP9R8G!8uUV6h`}bBJVU{8R{f%UbT;I3+_1Ri>vY5jkRhXKK7h8p+h`(q~@lXGX
z{l-FmlCY9Bq0MI1_PJ1~+)31hH9flad(U1T<sg<FZSN@+&&zfkS|pHP1G(24JOb$z
zf|sG00_;=Hk#uLUjpu?}hbf5S^)dUiOMT%1bYk6T^BD~QQa5{o!~iztJzYB)wL$$T
zCgHM~OJ9~Y-6<-=Cm%GH{BYuA!f`y@DE1y=rj=(g<zP6i`@4B{;uX@Brx(@b1U>5N
z)Hj5;EAu~4gr|*a-=lsj1~Flhhzuyncgoqx9ZNR)1co9N-ub&J!+{_o1_uLz>`Cuu
z)b93_4$0zkKeh6FPRGmHydecy?iglNu^en>W-L5gEH{^f8I!N6U&-vjVO*NC3AMW_
zEP(v-$^+!SHq;a6jaOl)hb56vd)CyZOq4VH#^vM;qv>OdOCWzU_5u!?wNTvW$(Kf*
zK^9`m>#6LJg*#L`_G&CHaJY(D{PJwOu{8!wn;2d31SVfwc=Ng5;!U_v`;%nFp*DD&
z>R^1KHkZ`OtQAJhopDuoNU%idBk$7(ED4nfla$TiirCUCAUzT{wdXI!F4ewLOD#>W
zCR{2lvmc=i-nL16ISIpFYjdX+LfW&1$%zy7NT6!ShFU<dShLPF6`xjsil%hLx5@)}
zZMN5=I-^YEo0pSmoJogWf@y3wnA?_f1SJ9*UIzOhZ7qp?C}V%nbew&}UR&&A^Y)(F
z{X+J!F<EhheLS4PK7KdJKCphQ6|sd23rCYM0!OjanTGhVT4lxoLqXt{Qo2lGM0UY}
zr{dF~qq{knS-@M=iS1-S`8+*%`nX->w_A|-P0eZDU>I7ySZB%{v>W3@&yFEk2y;zx
zUVF{bUZcp;#-J3I_S(g-;l@Wa5u~m9+AQI0UboVXMVa8ufbnHpQ)SvfJ1*T{LXn^s
zHnWvx2{E5aF*cNm<*O3mnrJm0+F<Ou77Gbqvhqkc)dnnax%zxjmS01bbL&CjJh!Ra
z?FSu17-R2BG|TIPrK4ytayikUkUritS*Un&Ct0YucBp4}tx8i+EM6Aw7><W|*x*lj
zZ{gKMZ}BRWhUbzMN2K9QiZuM#*}1A6vEmHK)>SCXyweJ0Vp)*uq;`J4S)KBPHAt!p
z*;+9>$>gLWSItio0}b^#?=VL$vYF~YXawv;H}@~BkHfMhh1#p)zwrzkMLR{loSeU2
zOTCIBKpRt1q+ZUb=JfV3GR-LRqQJ``n6HS$tyv4DS1qXIKgJ4Tsi`kZi&4h+`pe1q
z>TTd2mw)eg*sUKLs{}+>H{K1|(14t0aAf3RGiFlbNQw;ZjA%0EH%3m%SQi+TqNL;$
zWzWJKPD3ioVWnpI5t;0mqWN^|oW)iBl_#FLHj@~a)=w^*c#c+rBV+01icU?`B+(tE
zJ^i{DCCi_@oMid>HZvM0%ZzLs(q0tdh<nQwZQTzo?%X_NA~P8VN*5*6*}&Xk8H>tT
zan?+F8C!wKC0c_WzFY~6?>%YJBA#DbdE$9<I;az>pN_{H%nlmG14dGNgLX>D-ZBg!
z)Qc9c{B65Wr7JSQy!Ol`-da%pRBxdiDt@0#Rvc0M-j<^HjSNdDveDB_)S&EF<L;4}
zVkyhLbM*rAG9em9VyPiNC}YgT#144uQJogZ{v<iFUaLg&3NdXMrl>^!e%V~T2<K}t
zTh3_piM&BSa(Gq&Aq{7qQjXv?7Bz})UpCySpz~O?=9pgf%;|Pi3j7V`{jwP+-rfcS
z;!@zRIT4KDSBoH6CPKQ=`>UC5Q*DuHJ7L&2gHsr4Vjk2HEKCx_Oz1d{flVN5=N!y^
zQ&ZTDQ_gW`1C!m_w5Os9u$7fqBz*$*@NaBZE;JCp2I0eq7h=@JD@=AH?6VcaW*=Yk
zINxxqLZIvE#4Mj!<Y4tCowmb;)Vk~gw*4dD=)gk~`DE4rST;|;;uUsv-|bLc7eTCH
z-Wc{1d`J9o`#8T~#2qKh;*_0685gp)JWX>!dSN!fFvR7@)9EB$yB`FhLx@W@*SG)=
z3Sfx3K-ab#O1H&}?_HzGZ8!FGr<SlFeeI4F@@8C}tT-aZ-<u-F9~ll@7Rns~D@)dy
zFlLwuBj1A@hb*Ob9T{H*d4^F;Cmwr^`SjeSfDAN4xGJ?Rn>GfLBM8KGg4FuLe%e#8
z(R9MD{FV-tFN^TlYeRU4mIyMti%S~+)^u>|WNXo>up7B&W#JGf=PsGWPby|%<20Zg
zUo21b*uU}`+6lwZx^ppgXyu!Wsxhy|R9!YT=6!7-9#>=Tpkz<;u^11e@okDS1I31S
zn?k#*!s4P+y~W}*dG)hx01`*R{o-8_=SpAj=WXGix2r!Bsa%%uT@)!AmlG*|E*%DO
zBKO0MR)b1dU^S9hc!!0InL`S7ExRew7B9Q6J*yJ&a0$vV@5s(r8#_A{v~cj9y~V+B
zLGC9jj!5!fOOfOUbczUOaDZcLdK$)|=m@z6S8?mHRrgXpv<ClE$vy_Mx(jidMu6{E
z$Y(<%MF#vBITHDH*WLzdF|w>yR&7-oRA{xBR&mnuUPsGHV|dSSqhOt_lI8PJ?0AHy
zVgI5G<(DrfL-}BvIgLx1u~Du^0b(W(m6d5ULK)9Bmcv09owJy`iOV2PNU%Cp+EK47
zw+Q1CD^D1oNC#qqD@XQ-4pycHHA5Jr0XV^&BV`lpaT(@OGONY&=&eVr>;yJnj=!{^
z{<+>lJ><oIlB_twi+?MH7r&A0$lk|FJj^q(yya-C&cQ`qMp8YbU%1F*U?#IXvVu)P
zX%cfPS(9Yxn=o&AzId=S%ORo#1trjoMLD+tw(F(Wt5>E&_Ojy3NjL@aAhCAq_S}iD
zcW9&wp%WTU*n3Q+7*B36Yq)gST4>j4)Nyj`awYUhMeH^nrl8#`BMx1&%L3a1CWsMr
zIeZ>S6HV_J?qd^%U?*1IonD(g=c{+NH)SN|yqnWC`Z_eQtodfo&3s?q5iHhpcN%by
zru%o>Om}?MF-D?ZmeMm_bKS;(QgQa%thU#cD<G<o?FHyB+oJaO+CVd|ZoJ%hTT@wW
zI@K6{Y(S^EZNF8OO)$50z~=<Pbju_UcW7i;M8n=2qH)?0O#l^(a5@dVM}+f7ZKgU-
zIQt=79fkW;>GvNN1s>;!mm33WZ#g{k^2SW85(`WCE{g8sy+HT%N>ylk8hvPF|7;s5
z#1Q_WHOPQv@7Rl}&av1Z0hs9F!gHX<P&%5BAv5U;uFB&?ZG>gb?u;y>-KUXLpxhYh
zJ64&M00ss2{ZNjuja58KI3w)>+)UC`Bqs#ol^9FUN@I!;DHf-iiRNP@cepsP6fUJ{
zITL$tV%V#5)84p|`Zq2QNP-AHF3WoZ6r0aXc3=TL<1=1|MwZ2A*n7igZWrZuY4f`b
zSZq$g4MqO_@KoM}1Brj$xd}c=yNTDYEF^lwAV1fJHN+X@eW?r*G(&P!Mvj|!CZyv`
z>4!WpGT5i30}yW7YqQUu)f#24PXh4E)+H9tT>qjC1Y^wAe=~J6wQXCB;OR+Fw6GbH
z01a*3=v3T-GOZeWqoxnTX45SmKf0(M0mWs0f#8en6+TJyi$42^Q6}VeLEkLh;NSL^
zdeSV3UtHwGeUV^FN{NF;u0WotydlQKDpCicvJ%8{XrHt^W58?}A|a20Sj=Ew=Ru|!
zXI^rZsZnPl&t5=AMux^mBi~`eg|M?jcPSAeMNvl}gmoHUa|AMEOw9DFHPy|L(b^2{
z*E&o|LVk3|Ge6p)iDgL-_T5O2-+$K3oJBF6rl&{3;!ABPCN3<#v}j?`QC5gJ!6Az-
za+#puEVJx`TM)VBX`_<Q&b<m6n-tVl$wL-<jAbsFx9SuCl!=8w)A)hY8C_PRlzz%E
zUDqhHR1}aI2nStMWNpKuC}~TvXa8`c;`K8irOPN@ztRTh;^OuB2aeQS9Qgo8p5b}O
zw_6?rwhT^{<_-i?CW*{8x-(TIWGmL~3})V!$bh2z-frkvtIZ(4+FS1RWmYFyg1(5q
zx=N9iCieb*kpT6SAgCj{M<iX2;AM!i0k5(zXJMCCCmb@?6f3J@Iag|`NJJ89<RxPc
z^_H!>u+(~`Gg-^xjKfCE`?#_VLs^eBY;n-<_ICc#fd9=lz>jm#Hxc-~GvqmUQ60dZ
z98A%fvqw)oa8|ge%HpHlm&GzO|CoiR^U8o=#Qyzs=ungkt=rWDF0@tx1-)<KjJ8WA
zH`hnjfa-XfQ^cY3?etlTOI2SIm3D}Ah$k{#h6{~8rp3F^`bL6e-uARcUs$x@0KV<c
zH|atX3teY7BrA?U`hR0sanAl}(n6R#HQjA?c+ja-nVGUu8{#@+{MZ@&P2D+h?2H($
z%Fc;1#~hU8ODYmL&IgJ%Bt%V;rWZxMkmGxj>NMRU*jiIU>MB{e$;KQVD;-^@Mb<cx
z)fcT;DL&`VJX42eE#JbyStvA=oaw;%*98itvD5D>!nAP;C=_R>%io@6_;F-TIiJL)
zlvg@LgsLR%BM(PSA^a>B3-a{qUX<0|bvaq>Kc~-Vg4IT|DaS*>?RQ;Al7SZ`nl*<J
zidrd7)I`jLDIyZq6zR|jIX=)nNHD?>yFTrc)_;8j!E>j5;w;l)$n`Pr9=RTo>rs*P
zJiBj1em^@;`yB8dCLew^FSjx4`ypOF!~9-<$jdrzJz34m5A*UMFTcsl$9cJuu@yUb
zndjxLynKe2Kjh_FR(drr_wzD_OVc|KVDh9cHajm(J|WG`OH=dG%)B%)FV)XW)$>yA
zyi_?a)y+5MurF36otMmY()s-yfplI{BueKcjhJ*^vhPUeB_n}!UN+)M=OuPrIxi7~
z(s_xZVCOvwlBQRY5qOWPTOBtfLusnpth&vq+hgi>N!{Ln8%_~>oVQip8*%gAjLRjg
z631KK+wdpqnOC>B<2L5`>c>0eN5BJ`lTCjka$#p-!N|6}Pf!{Ck32YSZN8Xe&TZD`
zuWu9^2;yiFK<{Ufui_HP6dPpYR<4RY!_7toCvX;XVxB|{oh+9TY#ZhEZvp_Ki~D~-
zo#^y;)$JeE?R)C>1G#A)vkF6i;QaueEzpr&M~gM2w&JmcIH#qVL)H&-qMhRX?_6dd
zKDclnHjZ4(&QuA#=-}VC%!WU-aKrl_bW7M715akfd2smN6QW1mGIYz(9e2XrnG;8-
zoLhOL)w5q*X3svnaL+cJDCXR9-JXh%F0<W_EZpuj_cvXjLbX=G!JCq9qFSuFvOOR=
zH=kN&Pd>VEPu7hyD9VESA1|}jk1gElZfR9E_D{kZ(x6EMMl7ovf4$6Z{QAP(*fQQM
zmuWmBR$7gJeVL74SVZHaW$a2UA*l~{2t=p-yRpU>KJQ%fBQ7|>k6yp1#&KL!9*ij7
z_}VLNX1LVGFD=~o*3mLDuV4$eJ~uu(_8rS?es<yJ+a7YQIPvqA*Mp|tSHd}5aXCd9
zqXY#xy(jFNtk)C%Nml0xzasPTgoBXyJ)vL{q$gBGn(zd%iJ+cf8L>r8Ij7DO_!Ekr
zfP$lG`fD4NTtsMoU|k!b`O$VSJ`b?^JHW(oRB$6xMaK8(TDDrS4auSK{Q(5ya;5U&
z*gPyOmHmyd_PMokw$yqeJoc1of{%ULxk3f6aM)|%s3w=~JOx#3%`YL8Cd2jl!fmN4
z(m<kWysgU`y>DU)R27H1t>PR^dqyo;`c%Id&8E&>=Sf{q!<j<8OVhH_=absjLi3sH
z7Idfap@RNIw^f7_c&^(j^aKi%Sn>o8cwNq5x_<a$7(_3oje}We+TPJEz`|*JyHw$|
zh1#li9L}7zyfEqGoC}=nT5hz2i~Ae!C(_=+pR)yZ`&*PN2-_B@S9v@6Y~xJ!V&1Jb
z3a#U-{SCQnRiy5izjnG*nQYDb>kGv^4sXX_{rc<R!A5mPyPIzv2l$j!VOk56?W<*H
zgSM|jJDROsk3W?${~yWVz74=1U#pP%7rF&7F;Z2b036zg7KWGZR!A35ET<P>Y$7t-
z&G10{+?zlubxjyuu3x@@VfKP@INXIO=kwiyG^CvWTdKHBlp|vbDd$I0DCb9Gl(QzJ
z9Pb@`*F)-gC+j0U8QPQ<67)2IVv3$NDPs6Ww_p$HNr8P?^z_GS=GrQ6UCM)<qsWkm
z^{Fh=8jQfQ*NN9$wL<vq@7h;XO=F{8eo!~9XCqYFcBB1nlr}HK`CZ*s5i&Cc{4VBC
z3whD{+cC4YysTRppK9<J>Cr@TC<`&Fd%A^qIBBoywu*4l?&`J*J!v1oNZWJDUK8RX
ztwq%yO(O@l&@|3;3&3z1y>6=rr*XR5D)cnU>bf26wO1s%CB76}+rR12oN*)z&Dndq
zg;qFc@9wsWaL#^Qs%XpDx>nNCS1-T0Qt<UR?b8S0)J+ggD49OqEto<`e@ua?9ddd-
zUB?Lagxc8OZvryK)-m7Vv&*oK`Tx*PLht&0JXCtu2Bmj>u3G?ydY1xl7jip}%3V~U
z*^ij?+RkvVrO0Az?(28=My2D(7Gg(h(AF~5w^iL%5zgTcmV-%Hi;6LJ$#d8>muv5_
zxV1-9#{n%gbwl04J>+jMk}BHjP`wwv+h2eL?NcTAfy;wggz8o-m&@suf}X!^ADcy{
z5z}m99dmN|(EOops|X3<J~bh|<~lnfV8<3%r02EZUSBb|Zx7+F+f4wz+AY*VG@j|U
ziWLX^)(GHprJ@D(_pBJy`$MR+(FDlf)h)b2kU!aN6)O(%D2r*hb%gjwJ)6I=VnC0u
z7}ab7>>uqGW+B)=)NK`Uuy?61DaB8TjV`JPdoj@MK(y9&0RpnE-0J<hW=q>Jfp5hS
zYGF@(x<icvN|*TGhZ|SH{qJKyTevNagLlF<sjB!psiH09dN1)2W&m&SR2GT9nZVm3
z#_d<zitfVWStRTr@5KqtW(TEN4Tuny{b)O?_%7Ub0+xN<R`C&9u*K!QL8@qruie@>
zb~6RL<VznYyKbJjx9>asz<vw(x33uRui95C%?Q{BrFG=Zo~|~H7z(H0mTut}qVr(4
zRm7(tWM+#-g!c!tsEDeID#Bj;ZMUS&UYKa3C9i<G#V@eKHi1j$dxTYto?3_<7P_7M
z5P#fms|aUqvfC>3%t@%wWt+K9QD5)r(cE!F3(eiTx`kRecTaX(ML2gq+HDnj?j*Qt
z$#d7W-C=>4x&PFo`QxY-n!n%b7INYIeL||ZjH<}yNd6{E6n<%?0OxPnhcs5fsh<fY
z<gb?x#s8<<Dncswb2SmYHacvNpA=@ne9fNT=za-g^>^$uNln@Veid3@ruO%Pr!(MF
zk1tm$=L=U9@C?Gb;I;?+zU2en>9&d$$N08K<toUJt{CKZ?o;O}MUR<FFq?b3g<Ht7
zk91qbii5t*QFRLNr4<AG_I>8eEOR(e0_??ZVHSdYs@p179PAyA7gC^q=Zb;;%6-A<
zKaso#3Gn;f!Y%~=e79AsIQSPn8bZy&2UlzsuG^<`TVexGBBy&|GX6uikPIi|SGuiY
z#U~>@AH14?KU=X0*tU<U-8)ghpLPqe5a^%nwu%)8dNPZM0{H)0F@SI07bXNr+O+<m
zTS$e#{&u%j#DU#~K`OLqsnuB*RfN6x^=>s}wYqNl+pu9OgV6ho39vUCj<MC58&GiL
zh6dai$$WgZY~I2z#?Il!fEqkx7zBRNrG9*!?AAKIMz(6<Ax#yyaS?I6ujy}PgGi~O
z!u`2dOFfz@PDdVXN2vyqm1p!e0kx-#JvoOB(fu?FZo|cuUh&Zz_~?ziyqTA`@bWfZ
z=6QKLF0OQzWxv5Fn{VObHvR3geIe7RWNPkYvslW@j%zmXPLyPWPfAPSFSf*AgvXQ8
zWcZ71hrif~@E3a%{$jVnU+iD_i~Zv-0{2PjXz;7)_j4-+`YYh6x8B+EcbJ_M*3-T`
z_Jbq3n48Qor~VZ=xoxghDveBiZf3GlYI$!#3;y~u>estkdN&l!=41YrdT|mPb*G0X
zD;L~W`1>Aa$-(b+a5Z3W$e6!5@8)p!uiD-@=5N4GXW4$H)4}-LiuG|fT4vtgl*ttU
zYiurQooo6185~nmJ`z4@PWl@vlOFbwbKbo-qd&*7xo=Yrhm=mcb+;iy*`R+$i)_r{
zSW($@f-&n4@tuAs*w$};VaBKUr0K88RjaJhyYCuc#uI4HJBGh(fOseHXv{mwtG`JG
zf2ww>3IJ?H616I}x4NeRg_$~GWu6Szrt#Z5C7+&_E4QhPdH3V*d2bw7Y`{M&H<*~Y
z1wS(2b(lZ*qV!C`z}pN&VMn>w4<C|3aZ_}mX+bCy4@sf85s7dkh2lmE#f_dY+-L#D
zjTDL-DfC>c+4NU?irij}Zh<^E;GkLAJAEmfinYi!P>_!4LjB0MmvJ9$3h>qE?Bl$2
zab9{jFCCnh{>@AG=B0P@(z$u*+q`sbUV1h!9h;YaAzg&Qg4NZzNW<Ra(#hcMnp$13
z!&ChVpVu2g+WuzjMW3$7#w2!Am-E*n^Qv2tj{6(2;82kF-i_J|NB#bK6}jy$4wWiM
zf$oCjGG}Yqa$Rj{K3%I^oWlmu0q;F1?QhGJvag%VV5_$jaPh`puf7K?)mo<1^4E>Z
z+%{ToY<WM4@4SD*%lmlwDO}#xdTVR)Z7oD1R*-FvSb(0-4F<ok+2_3|HW2&P-*QqW
z%V}Tx&qZoqUw5;$T%qOtG9I?8a`PD}<ebh<yREeT{z{}qtCR6A`@2r7^KYz9z6}(J
zZL8Sq6-<G^T?7BEE$?U1fcNjDi}=O9>JH=A2l?wm`klcNe;pj6phOUN(_delLC@;|
zpq|BMqlgLEelIqzkx@NRE<SoxrQQGo9PoYzcuR&$0(#QloUKh_6;vClV%t92`?P*b
z5_;0_Z_HK(u}iLj6ME!*lVAQW`}ALMc@m5)U(!3|ej5+`{-c%Ia;cKdvvr-H(%)G@
za^WJj^Jb*0nP#nsuKSzFMKYR$`<ub8GE8WS<D~iaN=Q*o9z-P2BNOby_OG^IuyqcT
z(D1La-_0QVDbo?)&2{!0sV)<FzsG)${rr(8V;`#?g&Kvw+x{55y)jo+JxabZoo!AI
F{r}?r;%NW?

literal 111414
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
Z3UvX0m;Euga&4}xdX&sEovlv}{r{F&=mh`(

diff --git a/documentation/build/doctrees/installation.doctree b/documentation/build/doctrees/installation.doctree
index 5379ef1077d283c5aae8ab91d7a58fad46da9811..4eabba053735073a50caab40b63c0db8ab034c73 100644
GIT binary patch
delta 876
zcmd6lJ8u&~5XZ9w3*$I3c6bz4<e^GXuz3`bqDVnBJPkpJS3|M6oAd5*-gWNwuw0-(
zfxwcBz#a`HJrc+zpMnC3!cxSe;!`ktkOEO7(adUhe)FH*|LmL94{L?Tg;(zu-WRsY
z3qNiNgakdUeCYAmfJ}fxmwQ4gv@gr++XzxgBY6Y_1+tUI+(@k)80eVbNPCp@u@~t<
z7nK1WK*Uui<sF2s_AyFYrRy5Fw^yeSee}U-h*Jf3&tGVR3}B#B=yR(7eJ%~~1XlJM
zNR=3_JZxp+!2L`d9sT!Lul{v)tLCoQNu{(cFX=u$#Q3B$JB^HNrU}M02$S}pFQW)H
zQDHz9{PLLWk{&l?8evq|DqU7!1kJ$X2|5*Ddk;uKcAe`US0n(W>F>GqM@RW@TRzR6
zWRJ2XQ4g8DQEl4UVv#M`w{zcE#lEPVW6R@@l@-PswphK$77001YOtxPbd#pKV`mTT
z*m`Y-(u=icY>m<<?C07>ag`8~Y}ixtw$XOHSPrkzIx58&V2t!R{Ol^rnJ@E4_B&0x
zK693x9ybqv+Q(jxr;mM~MnlKp76q{@CSl}u(uI32+@_F@4l3S7Gw5OB-VwTrq1YYf
e@Gu9Tr{cIv<vL|C5jS%Y@ikWnH^%My9rhC^R3rBQ

delta 705
zcmd6jv1=4T6vi{^8WVElk{D64#RM!8j!O}UAWDn~o|uRtu@aTJ-FNqPb2od=&Yq+Q
zmlSFawusD1igY2hAXnN8{sDG@fLhs!g{^O<NNa2J&A#`2^Lz95(~ZOH-nRFC-~Z^n
z9P|IIBk&Z0M25U0l;%;&1vOL`lzCHH?or(mspf4FU?hRRidro$0Ya`5j-m?`uRVHV
zE0syE3AZLx)2eJ{f<7K3A+)&A6r?d-kP%4D(+)8fM%R%BxWR#tybcbMrIBn>JWPT+
z8=!d9ww(H=HKn!elr&ILM;AE!tiVh8|Gr1%UwgbRc8aZH4rlPUdFL&%tLF3g_j8O5
z4VmrpzWGw-Y;N$ge2uXQGdo#hSIpjc)%$=m@q{^;JfiN()LT}i?!5Um_3%Q4ZaVYc
zMYFU_MTV957M=O1f(9s%0ffaWvl;8w=_j&<;`AAWEl)48>frA5*E1|1_?Lg2?KLPF
z2PAlc$MJJpJ+*S*N{uATN2F+j-t0hX*NN?oKA!YlxbK3y8O~bEamMf%A3F$sbA<S|
Y!;~6HqGh7t1-;gy@=_2Ddj3uJ7r=Y!IsgCw

diff --git a/documentation/build/doctrees/introduction.doctree b/documentation/build/doctrees/introduction.doctree
index 7f22361d106f03b73b088d618de140b128987f66..35b82c28ea01c99c4c37c57b024d3e52d010e53e 100644
GIT binary patch
delta 402
zcmX>hy-Aj}fpzL~zKyIK8S8sW!X4dw6f%ny5*5;l5_40_^NX?-((;QG3Q~)T^YapO
z6cW=@^Gb^KxI9Y~GV@AO(~A;IQi~OQ5{uGP6><{u(o2B~6ms)ZQge!R6p9N{Q<F0k
zic*vF)AKS*GV}8k67y0NN>VFI6iV`;(t1-e*kh+;i1n1z4~XrpQyQn#PSMDa&Y1j#
z*;C?KNCwdV2;V2?=O$(5r4~>A%Xm$)2aoK9$*-8XCSPDRW@O*2!Lovp(R=bmRwG94
w%`9w1OpGm?%Q+q}%fw|w7x!@H0fV-rvLLk>XmLhdXK{uikdEG5%oEB80PQW7I{*Lx

delta 227
zcmdladqSGEfpzL$-i@pq8QmiU85tPD9o>8sGK&=w71D|lb5qOni?S8c@{1HQ@^e!a
z5{rv7i%SyoN{aQkJWD{zQc{aE)ALeO6iV_HlJj$uGV@X=i!xuMqFEOvuVM<`tj;=_
zaq>MDV@A%+@7Ri%7|S*%az0>|3CQp*?%~V>I<%y+Ahmc(?Uamw&f*M3Anm(3mN%3U
E01rz}(EtDd

diff --git a/documentation/build/doctrees/wafl_init.doctree b/documentation/build/doctrees/wafl_init.doctree
index 2c38fb3af47609340dea5cb17df4253bc5e5b2d8..f4eb3481e94f435ad0ef54c6334a9416ac7a75f6 100644
GIT binary patch
delta 3083
zcmcImUuauZ7~j21`gg8&P2!p+?P<2QuI<u4AeAE8G8u|etm~`~mT;4t=A88A-t?Y(
zn^qZ#h)gA*-HD(>MW4mt$g_y<Ns2;Y4+DL%Z;FNWUC{5`<TiiWZH>j3kbBPe_xF9@
z?|dK3<rdvJ_s7=Aru)6I(=Te&q>4)4R7|RC1=74!Agy`V0$w)@ypXTE-~93K?Dztq
z48`<RO3~tomh~BCXmR%P%R>xhbYlf!ZH*ebmcp7@GV04uK2&ih_vs<3?-t%JTq`_D
zddL_Fkdq`hSL~33ZaIIGPc$RG+K%`?%{@HQ5*TemC`40fLtmo|M@)sSu+TIz4GW8_
za5&s{&57iIa{nWh`R}K%s^JTzXx#b11%eqy44Wp^5)2tQVX2CVkx4LG)>T!{!1=V}
z@TlUIbid=0XEJ*Z5<evpx1vy$_Nc1IRwApGZel2o6U^(sNGDDVBZvrv6yZ5SH4__#
zl@=vsA!HviJ2Z=71DQIC8CXPXSSr*lLrr4e5}JUtOq4dLZcuY08wOl1>juK>N-C}5
z(Ta@}h?*#)XeLr@Gs0>V@;7KAfekD=!<J6bcwEIuUk16DuB~B%*{v3CYa2$PjIsha
zMXYoLx+We%&{+aOO-Tur*X)m|ZjK@dJT6>-0!CKazF-^7#3{#7$gs4FiWR4N2&MEm
zu6Mw6O9Kzkv|MTF$|A+UD6J|RCA*9!G)1j3%Y+|D9%70ru@&K+LMkP@^_^A?ayhOF
z%+zE^&uC@1;arJ50Rxm)DI)+&LRVC<YBvji))UCy`X6c;ZaZ=zvyE1=)aI4x_~v-=
zXYDf7H)8_{G#I}#rME@cJGsxYhfL8<?(^yrH#SENhCbE66cs9zaZgZ&djKfoF8|hl
zKD!O1vF?yWe(4djcDzxm?|?T#ne0PH`&jOrg2ka&wG1N4ROXO{GKn<e3GD5&h%jaI
zNEO8QZHUEl^p}A6d@aPWDu`>@X6iq(4ZrR2_@WOqdkhkDAWYUkXh&_gIy~)g6UR!-
zq-*e0L@HMm-kb(1Yk)W_Kqg!GE8Q3Qm;M&_FzHFUxD*_!>(?s>9`ow?I|{`<fMH36
zr{=4DWbKXNxK12guL62?Z$ur1)Tc0x4tXZ(bEtw4?L#;U5C#N<()NwMUT<C+E?8uQ
z7$itWN$*R75q{<$c~R?@b5b1Xn33h=3;QO<z{K-lV$hwOg>8cW)Hx-Map}w_P01*H
zGrsBV;ajeD?(OhOlf`>yh9o&@IO@_AAL;P(InSTcb^b%p&#!pLqz~bCqU}0p0}uJ~
zPw`oI7teV@r>b%&Nq753q_2c@-@bGcTBh*SR*Q<T-fEh3PeZ8hltRtHS#i(jm!&(l
z+rjP&(w6P^j^p+>+wB+KcU|JhHt-A>_`YI*@A=Lacl{HRv?o-hT|OVMT)U3+3`qY`
zE6rzvF;}My=8*TS+$G=eb@N|?6S80C^WEccz-M}2b#(~=2)OAISm==XE&sq{NfB{r
zktL&iJJ84PcRv0cWaMmlnDmKtw|@y%Z)deGujUFl2fO*e!JFc0-_x>8<>J@<J0}M(
jf!pK^{IGnhU_f&tjT!9FNpbN$BmMAqMlKcy7NvgySw}yj

delta 2424
zcmeHJO=uHA6z*)ACT#_gVzfzXryGn`O`3@PQPEmO#D9=Vy-3|O)6TY=oppa2i<By&
z_!E&b(W|IeFR~}4qJkhEJb4rGAc!{+&xQJCH%b3Q5IlAQ%QEx5?|tvRdD(Ym@b;<T
zmEisP#7yvJ*Sa%~uB-YeE+``!R&~`b(a`x4tuNLNkV|%nmx?PPGqZEYqJvbiagGrS
z+f=piFw5r^JqJ5|K0~DVH^}wU)zVaHD~-`k-e0$kf2a$)S?O18_}s@pP0i&7%pWyI
zI17dP@ro4(oi;H|$FNnVTUap(Ry2(jNDfXw4god#1Tif|0C;m4pZo)fz!jL80|SVp
zpo~K(j^UY~IB^n-U<5>0@&vOHpB9i=X7k<Q*x?n7-bNhvV~aUp3pp7jIx!U+WECj!
zg$ZUjDX?+aa18z|)H3}?rhg=Az*yE)%N8Do@+?O*c@LJEL3Bm!EI@$_VkT`>pG*;5
z-T@xtcmRSE$Y~8b7HAw{CI%Q8rr0FIY!vPSWG@BG|F+`zw60A;$evTrh2|H@atwo+
zkdGy5rzx{V9fmYEYJlowuh6$_`EqS)5{oh|hXIQXlVz2xs;Ty5r9fq>CHxaibMj=U
zY6~vXsqO_IUjCQ!`$m4<{JcVwETOejjp)O`tL6!FY>%~Pfz{LRvzC##j9g9%{$;OX
zLzG#9N6zf*Nu}YJ@hY_}6P3~la3yTGRYIH3B2o-2z3JZc3e!a!zBT~2E}@w!ckgN+
z`ng)|!$o(da`&pewAzRGzxCmo#eK+U!e{x@jceT}O$kY&Zz~_kU<Z6MU-Ju1I9PzU
zmpmQmK^^=+Xg!~bTno@I7FU{L{6!d}9qz#mTaZM5RBTbkeYCL_p#Yz5jq=ycov4xj
zY|b<UP)&`KrIBJ6e<L^X{n2C@awEDOwF*c}6;g*s;D0Yws(!!60(?H&72E}4=Bu*i
z+*~Xwp+0bQ2p#d9^i`aE_MAM7z2~1cH3CFfchlI|UXI%m5}k98w;e?&FN~1N-(d%y
z^U>Xil+XF&_RG>;#M|U3y5~hQAZO46ftT(f{#-r-+k$i-klv{nU5xh}78=*k78-D}
zgtm$4qy0RLH>N)UCB+1k^d=yM#$g27yy$RYJaWIsdnM@`a@!MM1Bq7<)z~aNtYW<w
a6zoZZSTNX(iGy1fZHL!c<aTTuM85%@Q`waO

diff --git a/documentation/build/html/_sources/installation.rst.txt b/documentation/build/html/_sources/installation.rst.txt
index 1624cd84..2eb6156d 100644
--- a/documentation/build/html/_sources/installation.rst.txt
+++ b/documentation/build/html/_sources/installation.rst.txt
@@ -33,9 +33,12 @@ Please see the examples in the following chapters.
 LLM side (needs a GPU)
 ----------------------
 
-The second part is a server that runs on a machine accessible from the interface side.
-This last machine will need to have a GPU to run the Large Language Model at a convenient speed.
-This part can be run using a docker image by running the script
+The second part is a machine that runs on a machine accessible from the interface side.
+The initial configuration is for a local deployment of language models.
+No action is needed to run WAFL if you want to run it as a local instance.
+
+However, a multi-user setup will benefit for a dedicated server.
+In this case, a docker image can be used
 
 .. code-block:: bash
 
diff --git a/documentation/build/html/_sources/introduction.rst.txt b/documentation/build/html/_sources/introduction.rst.txt
index 683ba6a0..a1a6c0e9 100644
--- a/documentation/build/html/_sources/introduction.rst.txt
+++ b/documentation/build/html/_sources/introduction.rst.txt
@@ -1,8 +1,10 @@
 Introduction
 ============
 
-WAFL is a framework for home assistants.
-It is designed to combine Large Language Models and rules to create a predictable behavior.
+WAFL is a framework for personal agents.
+It integrates Large language models, speech recognition and text to speech.
+
+This framework combines Large Language Models and rules to create a predictable behavior.
 Specifically, instead of organising the work of an LLM into a chain of thoughts,
 WAFL intends to organise its behavior into inference trees.
 
diff --git a/documentation/build/html/_sources/wafl_init.rst.txt b/documentation/build/html/_sources/wafl_init.rst.txt
index 72fe7386..070713d9 100644
--- a/documentation/build/html/_sources/wafl_init.rst.txt
+++ b/documentation/build/html/_sources/wafl_init.rst.txt
@@ -1,7 +1,7 @@
-Running wafl init
------------------
+Initialization
+--------------
 
-What does this command do?
+This command initialises WAFL's work environment
 
 .. code-block:: bash
 
@@ -24,19 +24,25 @@ It creates a set of files that can be used to the interface side of WAFL.
 .. code-block:: text
 
     {
-      "allow_interruptions": true,                  # interruptions are allowed in the conversation
-      "waking_up_word": "computer",                 # the word that wakes up the LLM and the name of the chatbot
-      "waking_up_sound": true,                      # A sound is generated when the LLM is woken up
-      "deactivate_sound": true,                     # A sound is generated when the LLM is woken up
-      "listener_model": "openai/whisper-tiny.en",   # The model used for speech recognition.
-                                                    # Only whisper models are supported
-      "listener_hotword_logp": -8,                  # The threshold log probability of the hotword
-      "listener_volume_threshold": 0.6,             # The threshold volume when listening
-      "listener_silence_timeout": 0.7,              # The silence timeout when listening
-      "model_host": "127.0.0.1",                    # The host of the LLM
-      "model_port": 8080                            # The port of the LLM
+      "allow_interruptions": true,
+      "waking_up_word": "computer",
+      "waking_up_sound": true,
+      "deactivate_sound": true,
+      "improvise_tasks": true,
+      ...
     }
 
+These settings regulate the following:
+
+    * The "allow_interruptions" allows the user to create rules with the highest priority.
+      For example, the user might want a rule to be triggered in the middle of a conversation.
+
+    * "waking_up_word" is the name of the bot, used to wake up the system in the "run-audio" mode.
+
+    * "waking_up_sound" and "deactivate_sound" are played to signal the system is up or is back to idle.
+
+    * "improvise_tasks" allows the system to create its own rules to accomplish a goal.
+
 
 - The rules.wafl file contains the rules that guide the chatbot.
   The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
diff --git a/documentation/build/html/_static/pygments.css b/documentation/build/html/_static/pygments.css
index 08bec689..84ab3030 100644
--- a/documentation/build/html/_static/pygments.css
+++ b/documentation/build/html/_static/pygments.css
@@ -17,6 +17,7 @@ span.linenos.special { color: #000000; background-color: #ffffc0; padding-left:
 .highlight .cs { color: #3D7B7B; font-style: italic } /* Comment.Special */
 .highlight .gd { color: #A00000 } /* Generic.Deleted */
 .highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */
 .highlight .gr { color: #E40000 } /* Generic.Error */
 .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
 .highlight .gi { color: #008400 } /* Generic.Inserted */
diff --git a/documentation/build/html/directory_structure.html b/documentation/build/html/directory_structure.html
index 4ea970c3..57674d11 100644
--- a/documentation/build/html/directory_structure.html
+++ b/documentation/build/html/directory_structure.html
@@ -18,7 +18,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="License" href="license.html" />
-    <link rel="prev" title="Running wafl init" href="wafl_init.html" /> 
+    <link rel="prev" title="Initialization" href="wafl_init.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -49,7 +49,7 @@
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
+<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Initialization</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Directory structure</a></li>
 </ul>
 </li>
@@ -123,7 +123,7 @@ <h1>Directory structure<a class="headerlink" href="#directory-structure" title="
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="wafl_init.html" class="btn btn-neutral float-left" title="Running wafl init" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="wafl_init.html" class="btn btn-neutral float-left" title="Initialization" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="license.html" class="btn btn-neutral float-right" title="License" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/build/html/examples.html b/documentation/build/html/examples.html
index 2bae854d..bf67886c 100644
--- a/documentation/build/html/examples.html
+++ b/documentation/build/html/examples.html
@@ -17,7 +17,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Running wafl init" href="wafl_init.html" />
+    <link rel="next" title="Initialization" href="wafl_init.html" />
     <link rel="prev" title="Rules and backtracking" href="rules_and_backtracking.html" /> 
 </head>
 
@@ -49,7 +49,7 @@
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
+<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Initialization</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
@@ -84,7 +84,7 @@
 <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h1>
 <div class="toctree-wrapper compound">
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
+<li class="toctree-l1"><a class="reference internal" href="wafl_init.html">Initialization</a></li>
 <li class="toctree-l1"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </div>
@@ -95,7 +95,7 @@ <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this head
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="rules_and_backtracking.html" class="btn btn-neutral float-left" title="Rules and backtracking" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="wafl_init.html" class="btn btn-neutral float-right" title="Running wafl init" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="wafl_init.html" class="btn btn-neutral float-right" title="Initialization" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/build/html/index.html b/documentation/build/html/index.html
index d40ae8ce..91e8034e 100644
--- a/documentation/build/html/index.html
+++ b/documentation/build/html/index.html
@@ -96,7 +96,7 @@ <h1>Welcome to WAFL’s 0.0.45 documentation!<a class="headerlink" href="#welcom
 <li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Writing the rules</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#say-command">SAY command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#remember-command">REMEMBER command</a></li>
 <li class="toctree-l3"><a class="reference internal" href="writing_the_rules.html#retrieve-command">RETRIEVE command</a></li>
@@ -112,7 +112,7 @@ <h1>Welcome to WAFL’s 0.0.45 documentation!<a class="headerlink" href="#welcom
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Running wafl init</a></li>
+<li class="toctree-l2"><a class="reference internal" href="wafl_init.html">Initialization</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
diff --git a/documentation/build/html/installation.html b/documentation/build/html/installation.html
index ad2e7a31..79b2ac84 100644
--- a/documentation/build/html/installation.html
+++ b/documentation/build/html/installation.html
@@ -103,9 +103,11 @@ <h2>Interface side<a class="headerlink" href="#interface-side" title="Permalink
 </section>
 <section id="llm-side-needs-a-gpu">
 <h2>LLM side (needs a GPU)<a class="headerlink" href="#llm-side-needs-a-gpu" title="Permalink to this heading"></a></h2>
-<p>The second part is a server that runs on a machine accessible from the interface side.
-This last machine will need to have a GPU to run the Large Language Model at a convenient speed.
-This part can be run using a docker image by running the script</p>
+<p>The second part is a machine that runs on a machine accessible from the interface side.
+The initial configuration is for a local deployment of language models.
+No action is needed to run WAFL if you want to run it as a local instance.</p>
+<p>However, a multi-user setup will benefit for a dedicated server.
+In this case, a docker image can be used</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>-p8080:8080<span class="w"> </span>--env<span class="w"> </span><span class="nv">NVIDIA_DISABLE_REQUIRE</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>--gpus<span class="w"> </span>all<span class="w"> </span>fractalego/wafl-llm:latest
 </pre></div>
 </div>
diff --git a/documentation/build/html/introduction.html b/documentation/build/html/introduction.html
index 0f3342c9..a6cc727b 100644
--- a/documentation/build/html/introduction.html
+++ b/documentation/build/html/introduction.html
@@ -78,8 +78,9 @@
              
   <section id="introduction">
 <h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading"></a></h1>
-<p>WAFL is a framework for home assistants.
-It is designed to combine Large Language Models and rules to create a predictable behavior.
+<p>WAFL is a framework for personal agents.
+It integrates Large language models, speech recognition and text to speech.</p>
+<p>This framework combines Large Language Models and rules to create a predictable behavior.
 Specifically, instead of organising the work of an LLM into a chain of thoughts,
 WAFL intends to organise its behavior into inference trees.</p>
 <p>WAFL is a work in progress.
diff --git a/documentation/build/html/objects.inv b/documentation/build/html/objects.inv
index e586606e..9f6aff40 100644
--- a/documentation/build/html/objects.inv
+++ b/documentation/build/html/objects.inv
@@ -2,6 +2,6 @@
 # Project: WAFL
 # Version: 
 # The remainder of this file is compressed using zlib.
-xڅ�KN�0��>�p�VE�
�J��T��.#���Dmw\��q�8nҊMd��/�ļ%Ss����BW�~g48*�J#`v
�Bf^Q�`�\�\H.+�EA�G��Z̩g��O��^7��
�[���PK]⡋*�E�I�᧰dC�'f�
*aj2�Y>�~��,���-�p[���+�<�Wj2�\Oo_#kJ�y�ڠ�ڠ0%j7d/��*nXm�3Sh��d���+�瑹���G���G����l��Ի��
*�Gg��ܗ`�`C�Y�[�b�5,c��,�\|���@�[�$2xr�C��w`����0�܊j<Ĩ��[��|�l��U!����� C���J
-�
-��l&f>�_�sL
\ No newline at end of file
+xڅRKN�0���
Z	6�*
H]F�34��ڲ�\��`�q�Vl"��y<ޒ�9IQ�V�+�E_
�ʛ��]?��WT+X&:�JiQ���‘m���t�M	�{^7!=HXt��ۢ���}'U|�*����Y��)֨����zy�����`1_̯����5u���)��R���x�u@���)��&�
O�
aJ
+�n4����X�ڔ'��f���'���G��c[��m��-��X#�9��E#TR�z=+��ρ���D��[YRD�K8FE�uYl�x'�?!�e��2�s�s>T��f؁qԀ��鶅9�VT�!F,�_#��[d;��
+�%��G0��$ɕ��������S��d0�_���� �/,�w
\ No newline at end of file
diff --git a/documentation/build/html/rules.html b/documentation/build/html/rules.html
index 48432c97..5c72cc8b 100644
--- a/documentation/build/html/rules.html
+++ b/documentation/build/html/rules.html
@@ -17,7 +17,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Rules" href="writing_the_rules.html" />
+    <link rel="next" title="Writing the rules" href="writing_the_rules.html" />
     <link rel="prev" title="Query processing pipeline" href="query_processing_pipeline.html" /> 
 </head>
 
@@ -48,7 +48,7 @@
 <li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Rules</a></li>
 <li class="toctree-l1"><a class="reference internal" href="#examples">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Writing the rules</a></li>
 <li class="toctree-l2"><a class="reference internal" href="rules_and_backtracking.html">Rules and backtracking</a></li>
 </ul>
 </li>
@@ -87,7 +87,7 @@ <h1>Rules<a class="headerlink" href="#rules" title="Permalink to this heading">
 <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h1>
 <div class="toctree-wrapper compound">
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="writing_the_rules.html">Rules</a><ul>
+<li class="toctree-l1"><a class="reference internal" href="writing_the_rules.html">Writing the rules</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#say-command">SAY command</a></li>
 <li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#remember-command">REMEMBER command</a></li>
 <li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html#retrieve-command">RETRIEVE command</a></li>
@@ -109,7 +109,7 @@ <h1>Examples<a class="headerlink" href="#examples" title="Permalink to this head
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="query_processing_pipeline.html" class="btn btn-neutral float-left" title="Query processing pipeline" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="writing_the_rules.html" class="btn btn-neutral float-right" title="Rules" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="writing_the_rules.html" class="btn btn-neutral float-right" title="Writing the rules" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/build/html/rules_and_backtracking.html b/documentation/build/html/rules_and_backtracking.html
index f688577f..b4483b41 100644
--- a/documentation/build/html/rules_and_backtracking.html
+++ b/documentation/build/html/rules_and_backtracking.html
@@ -18,7 +18,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="Examples" href="examples.html" />
-    <link rel="prev" title="Rules" href="writing_the_rules.html" /> 
+    <link rel="prev" title="Writing the rules" href="writing_the_rules.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -48,7 +48,7 @@
 <li class="toctree-l1"><a class="reference internal" href="query_processing_pipeline.html">Query processing pipeline</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="rules.html#examples">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Rules</a></li>
+<li class="toctree-l2"><a class="reference internal" href="writing_the_rules.html">Writing the rules</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#">Rules and backtracking</a></li>
 </ul>
 </li>
@@ -109,7 +109,7 @@ <h1>Rules and backtracking<a class="headerlink" href="#rules-and-backtracking" t
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="writing_the_rules.html" class="btn btn-neutral float-left" title="Rules" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="writing_the_rules.html" class="btn btn-neutral float-left" title="Writing the rules" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="examples.html" class="btn btn-neutral float-right" title="Examples" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/build/html/searchindex.js b/documentation/build/html/searchindex.js
index 8d33cda2..8039ff3d 100644
--- a/documentation/build/html/searchindex.js
+++ b/documentation/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["automatic_rules_creation", "directory_structure", "examples", "index", "installation", "introduction", "license", "query_processing_pipeline", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init", "writing_the_rules"], "filenames": ["automatic_rules_creation.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "query_processing_pipeline.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst", "writing_the_rules.rst"], "titles": ["Automatic rules creation", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Query processing pipeline", "Rules", "Rules and backtracking", "Running WAFL", "Running wafl init", "Rules"], "terms": {"consid": [1, 12], "follow": [1, 4, 5, 6, 7, 12], "your": [1, 4, 5, 12], "project": 1, "function": [1, 11, 12], "py": [1, 11, 12], "wafl": [1, 2, 4, 5, 7, 12], "rule": [1, 3, 4, 5, 7, 10, 11], "1": [1, 4, 11, 12], "fact": [1, 12], "greet": [1, 12], "2": [1, 12], "interrupt": [1, 11], "The": [1, 4, 5, 6, 7, 9, 10, 11, 12], "can": [1, 4, 10, 11, 12], "organis": [1, 5], "nest": 1, "each": [1, 12], "must": 1, "contain": [1, 10, 11, 12], "first": [1, 4, 9, 12], "one": [1, 9, 11, 12], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 10, 11, 12], "infer": [1, 5, 7, 9, 12], "within": [1, 9, 12], "file": [1, 4, 6, 10, 11, 12], "accord": [1, 7, 12], "syntax": [1, 12], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 12], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 9, 11, 12], "ar": [1, 7, 9, 10, 11, 12], "part": [1, 4], "For": [1, 9, 11, 12], "exampl": [1, 3, 4, 9, 10, 11, 12], "abov": [1, 6, 12], "subfold": 1, "i": [1, 4, 5, 6, 7, 9, 10, 11, 12], "limit": [1, 6], "below": [1, 11, 12], "more": [1, 9], "complet": 1, "you": [1, 4, 9, 10, 12], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 12], "run": [2, 3, 4], "init": [2, 3, 4], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 11], "side": [3, 11, 12], "llm": [3, 5, 7, 11, 12], "need": 3, "gpu": 3, "audio": 3, "server": [3, 4], "cli": 3, "test": [3, 11], "queri": 3, "process": 3, "pipelin": 3, "sai": [3, 8, 9, 11], "command": [3, 4, 8, 10, 11], "rememb": [3, 8], "retriev": [3, 8], "ask": [3, 8], "question": [3, 8], "gener": [3, 8, 11], "text": [3, 8], "item": [3, 8], "wise": [3, 8], "execut": [3, 8, 9, 10, 11], "trigger": [3, 8, 9, 11], "anoth": [3, 8], "code": [3, 8], "entail": [3, 8], "backtrack": [3, 8], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 9, 12], "thi": [4, 6, 10, 11, 12], "version": [4, 5, 12], "built": 4, "two": [4, 9, 12], "system": [4, 10, 12], "both": 4, "same": 4, "machin": [4, 11], "local": [4, 10, 11], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": 4, "which": [4, 10], "creat": [4, 5, 11, 12], "config": [4, 10, 11], "json": [4, 10, 11], "edit": 4, "chang": [4, 10], "default": [4, 10], "set": [4, 11, 12], "A": [4, 6, 11, 12], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 9, 12], "from": [4, 6, 7, 12], "last": 4, "larg": [4, 5], "languag": [4, 5, 11], "model": [4, 5, 11, 12], "conveni": 4, "speed": 4, "docker": [4, 11], "imag": [4, 11], "script": [4, 11], "p8080": 4, "8080": [4, 11], "env": 4, "nvidia_disable_requir": 4, "all": [4, 6, 9, 10, 12], "fractalego": [4, 6], "latest": 4, "ha": [4, 12], "fill": [4, 12], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 12], "framework": 5, "home": 5, "assist": 5, "It": [5, 10, 11], "design": 5, "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 10], "an": [5, 6, 9], "chain": 5, "thought": 5, "intend": 5, "its": [5, 9], "progress": 5, "current": 5, "user": [5, 7, 9, 10, 11, 12], "while": [5, 12], "readi": 5, "plai": 5, "might": 5, "product": 5, "depend": 5, "case": [5, 11, 12], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 12], "person": 6, "obtain": 6, "copi": 6, "associ": 6, "document": [6, 10], "deal": 6, "without": [6, 12], "restrict": 6, "right": [6, 12], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 11, 12], "so": [6, 9], "subject": 6, "condit": [6, 9, 11, 12], "notic": [6, 12], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 10], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 11], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 12], "liabil": 6, "whether": 6, "action": [6, 9, 11, 12], "contract": 6, "tort": 6, "otherwis": [6, 9, 12], "aris": 6, "out": 6, "connect": 6, "WITH": 6, "try": 7, "answer": 7, "": [7, 9, 12], "diagram": 7, "repli": [7, 12], "flow": 7, "bot": [7, 9, 12], "divid": 7, "three": 7, "main": 7, "branch": [7, 9], "direct": 7, "thei": [7, 12], "written": [7, 11, 12], "creation": 7, "accomplish": 7, "input": [9, 12], "satisfi": 9, "make": [9, 12], "most": 9, "relev": 9, "go": 9, "through": [9, 12], "list": [9, 11, 12], "howev": [9, 12], "fail": 9, "next": [9, 12], "activ": [9, 10, 11, 12], "until": 9, "feel": 9, "well": 9, "name": [9, 10, 11, 12], "john": [9, 12], "happi": [9, 12], "ok": 9, "jane": 9, "my": [9, 12], "am": [9, 12], "return": [9, 10, 11, 12], "fals": [9, 12], "Then": 9, "becaus": 9, "veri": 9, "similar": [9, 12], "end": [9, 12], "result": [9, 10], "appli": 9, "recurs": 9, "true": [9, 11, 12], "truncat": 9, "start": [9, 11], "new": [9, 12], "few": 10, "how": [10, 12], "There": [10, 12], "four": 10, "mode": 10, "loop": 10, "wait": 10, "speak": 10, "word": [10, 11], "defin": [10, 12], "comput": [10, 11, 12], "whatev": 10, "want": [10, 12], "web": 10, "listen": [10, 11], "http": 10, "request": 10, "port": [10, 11], "8889": 10, "act": 10, "chatbot": [10, 11], "line": [10, 12], "doe": [10, 11, 12], "webserv": 10, "testcas": [10, 11], "txt": [10, 11], "what": [11, 12], "l": 11, "start_llm": 11, "sh": 11, "configur": 11, "allow_interrupt": 11, "allow": 11, "convers": 11, "waking_up_word": 11, "wake": 11, "up": 11, "waking_up_sound": 11, "sound": 11, "when": [11, 12], "woken": 11, "deactivate_sound": 11, "listener_model": 11, "openai": 11, "whisper": 11, "tini": 11, "en": 11, "speech": 11, "recognit": 11, "support": 11, "listener_hotword_logp": 11, "8": 11, "threshold": 11, "log": 11, "probabl": 11, "hotword": 11, "listener_volume_threshold": 11, "0": 11, "6": 11, "volum": 11, "listener_silence_timeout": 11, "7": 11, "silenc": 11, "timeout": 11, "model_host": 11, "127": 11, "host": 11, "model_port": 11, "guid": 11, "top": 11, "bring": 11, "yourself": 11, "onlin": 11, "hello": [11, 12], "time": 11, "data": 11, "These": 11, "everi": 11, "minut": 11, "mai": 11, "simpli": 11, "format": 12, "3": 12, "indent": 12, "number": 12, "space": 12, "valu": 12, "If": 12, "stop": 12, "demo": 12, "found": 12, "encount": 12, "singl": 12, "actor": 12, "One": 12, "simpl": 12, "9": 12, "type": 12, "someth": 12, "append": 12, "like": 12, "user_qu": 12, "about": 12, "themselv": 12, "tall": 12, "turn": 12, "output": 12, "At": 12, "cycl": 12, "element": 12, "memori": 12, "select": 12, "embed": 12, "displai": 12, "would": 12, "item1": 12, "item2": 12, "item3": 12, "mark": 12, "variabl": 12, "later": 12, "ye": 12, "No": 12, "truth": 12, "never": 12, "fashion": 12, "italian_nam": 12, "italian": 12, "differ": 12, "hand": 12, "statement": 12, "done": 12, "python": 12, "call": 12, "def": 12, "print": 12, "argument": 12, "f": 12, "avail": 12, "prior": 12, "date": 12, "todai": 12, "continu": 12, "fly": 12, "descript": 12, "bracket": 12, "stdout": 12, "oper": 12, "rh": 12, "lh": 12, "lsh": 12}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"automat": 0, "rule": [0, 8, 9, 12], "creation": 0, "directori": 1, "structur": 1, "exampl": [2, 8], "welcom": 3, "wafl": [3, 10, 11], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "queri": 7, "process": 7, "pipelin": 7, "backtrack": 9, "run": [10, 11], "audio": 10, "server": 10, "cli": 10, "test": 10, "init": 11, "sai": 12, "command": 12, "rememb": 12, "retriev": 12, "ask": 12, "question": 12, "gener": 12, "text": 12, "item": 12, "wise": 12, "execut": 12, "trigger": 12, "anoth": 12, "code": 12, "entail": 12}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Automatic rules creation": [[0, "automatic-rules-creation"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"], [8, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "License": [[6, "license"]], "Query processing pipeline": [[7, "query-processing-pipeline"]], "Rules": [[8, "rules"], [12, "rules"]], "Rules and backtracking": [[9, "rules-and-backtracking"]], "Running WAFL": [[10, "running-wafl"]], "$ wafl run-audio": [[10, "wafl-run-audio"]], "$ wafl run-server": [[10, "wafl-run-server"]], "$ wafl run-cli": [[10, "wafl-run-cli"]], "$ wafl run-tests": [[10, "wafl-run-tests"]], "Running wafl init": [[11, "running-wafl-init"]], "SAY command": [[12, "say-command"]], "REMEMBER command": [[12, "remember-command"]], "RETRIEVE command": [[12, "retrieve-command"]], "Asking a question": [[12, "asking-a-question"]], "Generate a text": [[12, "generate-a-text"]], "Item-wise execution": [[12, "item-wise-execution"]], "Triggering of another rule": [[12, "triggering-of-another-rule"]], "Code execution": [[12, "code-execution"]], "Entailment": [[12, "entailment"]]}, "indexentries": {}})
\ No newline at end of file
+Search.setIndex({"docnames": ["automatic_rules_creation", "directory_structure", "examples", "index", "installation", "introduction", "license", "query_processing_pipeline", "rules", "rules_and_backtracking", "running_WAFL", "wafl_init", "writing_the_rules"], "filenames": ["automatic_rules_creation.rst", "directory_structure.rst", "examples.rst", "index.rst", "installation.rst", "introduction.rst", "license.rst", "query_processing_pipeline.rst", "rules.rst", "rules_and_backtracking.rst", "running_WAFL.rst", "wafl_init.rst", "writing_the_rules.rst"], "titles": ["Automatic rules creation", "Directory structure", "Examples", "Welcome to WAFL\u2019s 0.0.45 documentation!", "Installation", "Introduction", "License", "Query processing pipeline", "Rules", "Rules and backtracking", "Running WAFL", "Initialization", "Writing the rules"], "terms": {"consid": [1, 12], "follow": [1, 4, 5, 6, 7, 11, 12], "your": [1, 4, 5, 12], "project": 1, "function": [1, 11, 12], "py": [1, 11, 12], "wafl": [1, 4, 5, 7, 11, 12], "rule": [1, 3, 4, 5, 7, 10, 11], "1": [1, 4, 12], "fact": [1, 12], "greet": [1, 12], "2": [1, 12], "interrupt": 1, "The": [1, 4, 5, 6, 7, 9, 10, 11, 12], "can": [1, 4, 10, 11, 12], "organis": [1, 5], "nest": 1, "each": [1, 12], "must": 1, "contain": [1, 10, 11, 12], "first": [1, 4, 9, 12], "one": [1, 9, 11, 12], "explain": 1, "section": 1, "us": [1, 4, 5, 6, 10, 11, 12], "infer": [1, 5, 7, 9, 12], "within": [1, 9, 12], "file": [1, 4, 6, 10, 11, 12], "accord": [1, 7, 12], "syntax": [1, 12], "keyword": 1, "folder_nam": 1, "includ": [1, 6, 12], "specifi": [1, 5], "folder": 1, "tree": [1, 5], "onli": [1, 9, 12], "ar": [1, 7, 9, 10, 11, 12], "part": [1, 4], "For": [1, 9, 11, 12], "exampl": [1, 3, 4, 9, 10, 11, 12], "abov": [1, 6, 12], "subfold": 1, "i": [1, 4, 5, 6, 7, 9, 10, 11, 12], "limit": [1, 6], "below": [1, 11, 12], "more": [1, 9], "complet": 1, "you": [1, 4, 9, 10, 12], "have": [1, 4], "look": 1, "still": 1, "earli": 1, "wafl_hom": [1, 12], "run": [3, 4, 11], "init": [4, 11], "directori": [2, 3], "structur": [2, 3], "introduct": 3, "instal": 3, "interfac": [3, 11], "side": [3, 11, 12], "llm": [3, 5, 7, 11, 12], "need": 3, "gpu": 3, "audio": [3, 11], "server": [3, 4], "cli": 3, "test": [3, 11], "queri": 3, "process": 3, "pipelin": 3, "sai": [3, 8, 9, 11], "command": [3, 4, 8, 10, 11], "rememb": [3, 8], "retriev": [3, 8], "ask": [3, 8], "question": [3, 8], "gener": [3, 8, 11], "text": [3, 5, 8], "item": [3, 8], "wise": [3, 8], "execut": [3, 8, 9, 10, 11], "trigger": [3, 8, 9, 11], "anoth": [3, 8], "code": [3, 8], "entail": [3, 8], "backtrack": [3, 8], "licens": 3, "index": 3, "modul": 3, "search": 3, "page": 3, "In": [4, 9, 12], "thi": [4, 5, 6, 10, 11, 12], "version": [4, 5, 12], "built": 4, "two": [4, 9, 12], "system": [4, 10, 11, 12], "both": 4, "same": 4, "machin": [4, 11], "local": [4, 10, 11], "access": 4, "microphon": 4, "speaker": 4, "To": 4, "sudo": 4, "apt": 4, "get": 4, "portaudio19": 4, "dev": 4, "ffmpeg": 4, "pip": 4, "after": 4, "requir": [4, 5], "initi": [2, 3, 4], "which": [4, 10], "creat": [4, 5, 11, 12], "config": [4, 10, 11], "json": [4, 10, 11], "edit": 4, "chang": [4, 10], "default": [4, 10], "set": [4, 11, 12], "A": [4, 6, 12], "standard": 4, "also": 4, "pleas": 4, "see": 4, "chapter": 4, "second": [4, 9, 12], "from": [4, 6, 7, 12], "last": [], "larg": 5, "languag": [4, 5, 11], "model": [4, 5, 12], "conveni": [], "speed": [], "docker": [4, 11], "imag": [4, 11], "script": 11, "p8080": 4, "8080": 4, "env": 4, "nvidia_disable_requir": 4, "all": [4, 6, 9, 10, 12], "fractalego": [4, 6], "latest": 4, "ha": [4, 12], "fill": [4, 12], "ip": 4, "address": 4, "localhost": 4, "altern": 4, "clone": 4, "repositori": [4, 12], "framework": 5, "home": [], "assist": [], "It": [5, 10, 11], "design": [], "combin": 5, "predict": 5, "behavior": 5, "specif": 5, "instead": 5, "work": [5, 10, 11], "an": [5, 6, 9], "chain": 5, "thought": 5, "intend": 5, "its": [5, 9, 11], "progress": 5, "current": 5, "user": [4, 5, 7, 9, 10, 11, 12], "while": [5, 12], "readi": 5, "plai": [5, 11], "might": [5, 11], "product": 5, "depend": 5, "case": [4, 5, 11, 12], "softwar": 6, "under": 6, "mit": 6, "copyright": 6, "c": 6, "2023": 6, "alberto": 6, "cetoli": 6, "io": 6, "permiss": 6, "herebi": 6, "grant": 6, "free": 6, "charg": 6, "ani": [6, 12], "person": [5, 6], "obtain": 6, "copi": 6, "associ": 6, "document": [6, 10], "deal": 6, "without": [6, 12], "restrict": 6, "right": [6, 12], "modifi": 6, "merg": 6, "publish": 6, "distribut": 6, "sublicens": 6, "sell": 6, "permit": 6, "whom": 6, "furnish": 6, "do": [6, 12], "so": [6, 9], "subject": 6, "condit": [6, 9, 11, 12], "notic": [6, 12], "shall": 6, "substanti": 6, "portion": 6, "THE": 6, "provid": 6, "AS": 6, "warranti": 6, "OF": 6, "kind": 6, "express": 6, "OR": 6, "impli": 6, "BUT": 6, "NOT": 6, "TO": 6, "merchant": 6, "fit": 6, "FOR": 6, "particular": 6, "purpos": [6, 10], "AND": 6, "noninfring": 6, "IN": 6, "NO": 6, "event": [6, 11], "author": 6, "holder": 6, "BE": 6, "liabl": 6, "claim": 6, "damag": 6, "other": [6, 12], "liabil": 6, "whether": 6, "action": [4, 6, 9, 11, 12], "contract": 6, "tort": 6, "otherwis": [6, 9, 12], "aris": 6, "out": 6, "connect": 6, "WITH": 6, "try": 7, "answer": 7, "": [7, 9, 11, 12], "diagram": 7, "repli": [7, 12], "flow": 7, "bot": [7, 9, 11, 12], "divid": 7, "three": 7, "main": 7, "branch": [7, 9], "direct": 7, "thei": [7, 12], "written": [7, 11, 12], "creation": 7, "accomplish": [7, 11], "input": [9, 12], "satisfi": 9, "make": [9, 12], "most": 9, "relev": 9, "go": 9, "through": [9, 12], "list": [9, 11, 12], "howev": [4, 9, 12], "fail": 9, "next": [9, 12], "activ": [9, 10, 11, 12], "until": 9, "feel": 9, "well": 9, "name": [9, 10, 11, 12], "john": [9, 12], "happi": [9, 12], "ok": 9, "jane": 9, "my": [9, 12], "am": [9, 12], "return": [9, 10, 11, 12], "fals": [9, 12], "Then": 9, "becaus": 9, "veri": 9, "similar": [9, 12], "end": [9, 12], "result": [9, 10], "appli": 9, "recurs": 9, "true": [9, 11, 12], "truncat": 9, "start": [9, 11], "new": [9, 12], "few": 10, "how": [10, 12], "There": [10, 12], "four": 10, "mode": [10, 11], "loop": 10, "wait": 10, "speak": 10, "word": 10, "defin": [10, 12], "comput": [10, 11, 12], "whatev": 10, "want": [4, 10, 11, 12], "web": 10, "listen": 10, "http": 10, "request": 10, "port": 10, "8889": 10, "act": 10, "chatbot": [10, 11], "line": [10, 12], "doe": [10, 12], "webserv": 10, "testcas": [10, 11], "txt": [10, 11], "what": 12, "l": 11, "start_llm": 11, "sh": 11, "configur": [4, 11], "allow_interrupt": 11, "allow": 11, "convers": 11, "waking_up_word": 11, "wake": 11, "up": 11, "waking_up_sound": 11, "sound": [], "when": [11, 12], "woken": [], "deactivate_sound": 11, "listener_model": [], "openai": [], "whisper": [], "tini": [], "en": [], "speech": 5, "recognit": 5, "support": [], "listener_hotword_logp": [], "8": [], "threshold": [], "log": [], "probabl": [], "hotword": [], "listener_volume_threshold": [], "0": [], "6": [], "volum": [], "listener_silence_timeout": [], "7": [], "silenc": [], "timeout": [], "model_host": [], "127": [], "host": [], "model_port": [], "guid": 11, "top": 11, "bring": 11, "yourself": 11, "onlin": 11, "hello": [11, 12], "time": 11, "data": 11, "These": 11, "everi": 11, "minut": 11, "mai": 11, "simpli": 11, "format": 12, "3": 12, "indent": 12, "number": 12, "space": 12, "valu": 12, "If": 12, "stop": 12, "demo": 12, "found": 12, "encount": 12, "singl": 12, "actor": 12, "One": 12, "simpl": 12, "9": 12, "type": 12, "someth": 12, "append": 12, "like": 12, "user_qu": 12, "about": 12, "themselv": 12, "tall": 12, "turn": 12, "output": 12, "At": 12, "cycl": 12, "element": 12, "memori": 12, "select": 12, "embed": 12, "displai": 12, "would": 12, "item1": 12, "item2": 12, "item3": 12, "mark": 12, "variabl": 12, "later": 12, "ye": 12, "No": [4, 12], "truth": 12, "never": 12, "fashion": 12, "italian_nam": 12, "italian": 12, "differ": 12, "hand": 12, "statement": 12, "done": 12, "python": 12, "call": 12, "def": 12, "print": 12, "argument": 12, "f": 12, "avail": 12, "prior": 12, "date": 12, "todai": 12, "continu": 12, "fly": 12, "descript": 12, "bracket": 12, "stdout": 12, "oper": 12, "rh": 12, "lh": 12, "lsh": 12, "write": [3, 8], "deploy": 4, "instanc": 4, "multi": 4, "setup": 4, "benefit": 4, "dedic": 4, "agent": 5, "integr": 5, "initialis": 11, "environ": 11, "improvise_task": 11, "regul": 11, "highest": 11, "prioriti": 11, "middl": 11, "signal": 11, "back": 11, "idl": 11, "own": 11, "goal": 11}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"automat": 0, "rule": [0, 8, 9, 12], "creation": 0, "directori": 1, "structur": 1, "exampl": [2, 8], "welcom": 3, "wafl": [3, 10], "": 3, "0": 3, "45": 3, "document": 3, "content": 3, "indic": 3, "tabl": 3, "instal": 4, "interfac": 4, "side": 4, "llm": 4, "need": 4, "gpu": 4, "introduct": 5, "licens": 6, "queri": 7, "process": 7, "pipelin": 7, "backtrack": 9, "run": 10, "audio": 10, "server": 10, "cli": 10, "test": 10, "init": [], "sai": 12, "command": 12, "rememb": 12, "retriev": 12, "ask": 12, "question": 12, "gener": 12, "text": 12, "item": 12, "wise": 12, "execut": 12, "trigger": 12, "anoth": 12, "code": 12, "entail": 12, "initi": 11, "write": 12}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Automatic rules creation": [[0, "automatic-rules-creation"]], "Directory structure": [[1, "directory-structure"]], "Examples": [[2, "examples"], [8, "examples"]], "Welcome to WAFL\u2019s 0.0.45 documentation!": [[3, "welcome-to-wafl-s-0-0-45-documentation"]], "Contents:": [[3, null]], "Indices and tables": [[3, "indices-and-tables"]], "License": [[6, "license"]], "Query processing pipeline": [[7, "query-processing-pipeline"]], "Rules": [[8, "rules"]], "Rules and backtracking": [[9, "rules-and-backtracking"]], "Running WAFL": [[10, "running-wafl"]], "$ wafl run-audio": [[10, "wafl-run-audio"]], "$ wafl run-server": [[10, "wafl-run-server"]], "$ wafl run-cli": [[10, "wafl-run-cli"]], "$ wafl run-tests": [[10, "wafl-run-tests"]], "Installation": [[4, "installation"]], "Interface side": [[4, "interface-side"]], "LLM side (needs a GPU)": [[4, "llm-side-needs-a-gpu"]], "Introduction": [[5, "introduction"]], "Initialization": [[11, "initialization"]], "Writing the rules": [[12, "writing-the-rules"]], "SAY command": [[12, "say-command"]], "REMEMBER command": [[12, "remember-command"]], "RETRIEVE command": [[12, "retrieve-command"]], "Asking a question": [[12, "asking-a-question"]], "Generate a text": [[12, "generate-a-text"]], "Item-wise execution": [[12, "item-wise-execution"]], "Triggering of another rule": [[12, "triggering-of-another-rule"]], "Code execution": [[12, "code-execution"]], "Entailment": [[12, "entailment"]]}, "indexentries": {}})
\ No newline at end of file
diff --git a/documentation/build/html/wafl_init.html b/documentation/build/html/wafl_init.html
index eb1700fb..d5223345 100644
--- a/documentation/build/html/wafl_init.html
+++ b/documentation/build/html/wafl_init.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Running wafl init &mdash; WAFL  documentation</title>
+  <title>Initialization &mdash; WAFL  documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -49,7 +49,7 @@
 <li class="toctree-l1"><a class="reference internal" href="rules.html">Rules</a></li>
 <li class="toctree-l1"><a class="reference internal" href="rules.html#examples">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Running wafl init</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Initialization</a></li>
 <li class="toctree-l2"><a class="reference internal" href="directory_structure.html">Directory structure</a></li>
 </ul>
 </li>
@@ -71,7 +71,7 @@
   <ul class="wy-breadcrumbs">
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
           <li class="breadcrumb-item"><a href="examples.html">Examples</a></li>
-      <li class="breadcrumb-item active">Running wafl init</li>
+      <li class="breadcrumb-item active">Initialization</li>
       <li class="wy-breadcrumbs-aside">
             <a href="_sources/wafl_init.rst.txt" rel="nofollow"> View page source</a>
       </li>
@@ -81,9 +81,9 @@
           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
            <div itemprop="articleBody">
              
-  <section id="running-wafl-init">
-<h1>Running wafl init<a class="headerlink" href="#running-wafl-init" title="Permalink to this heading"></a></h1>
-<p>What does this command do?</p>
+  <section id="initialization">
+<h1>Initialization<a class="headerlink" href="#initialization" title="Permalink to this heading"></a></h1>
+<p>This command initialises WAFL’s work environment</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>wafl<span class="w"> </span>init
 </pre></div>
 </div>
@@ -101,20 +101,25 @@ <h1>Running wafl init<a class="headerlink" href="#running-wafl-init" title="Perm
 <li><p>The <cite>config.json</cite> file contains the configuration.</p></li>
 </ul>
 <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>{
-  &quot;allow_interruptions&quot;: true,                  # interruptions are allowed in the conversation
-  &quot;waking_up_word&quot;: &quot;computer&quot;,                 # the word that wakes up the LLM and the name of the chatbot
-  &quot;waking_up_sound&quot;: true,                      # A sound is generated when the LLM is woken up
-  &quot;deactivate_sound&quot;: true,                     # A sound is generated when the LLM is woken up
-  &quot;listener_model&quot;: &quot;openai/whisper-tiny.en&quot;,   # The model used for speech recognition.
-                                                # Only whisper models are supported
-  &quot;listener_hotword_logp&quot;: -8,                  # The threshold log probability of the hotword
-  &quot;listener_volume_threshold&quot;: 0.6,             # The threshold volume when listening
-  &quot;listener_silence_timeout&quot;: 0.7,              # The silence timeout when listening
-  &quot;model_host&quot;: &quot;127.0.0.1&quot;,                    # The host of the LLM
-  &quot;model_port&quot;: 8080                            # The port of the LLM
+  &quot;allow_interruptions&quot;: true,
+  &quot;waking_up_word&quot;: &quot;computer&quot;,
+  &quot;waking_up_sound&quot;: true,
+  &quot;deactivate_sound&quot;: true,
+  &quot;improvise_tasks&quot;: true,
+  ...
 }
 </pre></div>
 </div>
+<p>These settings regulate the following:</p>
+<blockquote>
+<div><ul class="simple">
+<li><p>The “allow_interruptions” allows the user to create rules with the highest priority.
+For example, the user might want a rule to be triggered in the middle of a conversation.</p></li>
+<li><p>“waking_up_word” is the name of the bot, used to wake up the system in the “run-audio” mode.</p></li>
+<li><p>“waking_up_sound” and “deactivate_sound” are played to signal the system is up or is back to idle.</p></li>
+<li><p>“improvise_tasks” allows the system to create its own rules to accomplish a goal.</p></li>
+</ul>
+</div></blockquote>
 <ul class="simple">
 <li><p>The rules.wafl file contains the rules that guide the chatbot.
 The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.</p></li>
diff --git a/documentation/source/installation.rst b/documentation/source/installation.rst
index 1624cd84..2eb6156d 100644
--- a/documentation/source/installation.rst
+++ b/documentation/source/installation.rst
@@ -33,9 +33,12 @@ Please see the examples in the following chapters.
 LLM side (needs a GPU)
 ----------------------
 
-The second part is a server that runs on a machine accessible from the interface side.
-This last machine will need to have a GPU to run the Large Language Model at a convenient speed.
-This part can be run using a docker image by running the script
+The second part is a machine that runs on a machine accessible from the interface side.
+The initial configuration is for a local deployment of language models.
+No action is needed to run WAFL if you want to run it as a local instance.
+
+However, a multi-user setup will benefit for a dedicated server.
+In this case, a docker image can be used
 
 .. code-block:: bash
 
diff --git a/documentation/source/introduction.rst b/documentation/source/introduction.rst
index 683ba6a0..a1a6c0e9 100644
--- a/documentation/source/introduction.rst
+++ b/documentation/source/introduction.rst
@@ -1,8 +1,10 @@
 Introduction
 ============
 
-WAFL is a framework for home assistants.
-It is designed to combine Large Language Models and rules to create a predictable behavior.
+WAFL is a framework for personal agents.
+It integrates Large language models, speech recognition and text to speech.
+
+This framework combines Large Language Models and rules to create a predictable behavior.
 Specifically, instead of organising the work of an LLM into a chain of thoughts,
 WAFL intends to organise its behavior into inference trees.
 
diff --git a/documentation/source/wafl_init.rst b/documentation/source/wafl_init.rst
index 53dea035..070713d9 100644
--- a/documentation/source/wafl_init.rst
+++ b/documentation/source/wafl_init.rst
@@ -24,19 +24,25 @@ It creates a set of files that can be used to the interface side of WAFL.
 .. code-block:: text
 
     {
-      "allow_interruptions": true,                  # interruptions are allowed in the conversation
-      "waking_up_word": "computer",                 # the word that wakes up the LLM and the name of the chatbot
-      "waking_up_sound": true,                      # A sound is generated when the LLM is woken up
-      "deactivate_sound": true,                     # A sound is generated when the LLM is woken up
-      "listener_model": "openai/whisper-tiny.en",   # The model used for speech recognition.
-                                                    # Only whisper models are supported
-      "listener_hotword_logp": -8,                  # The threshold log probability of the hotword
-      "listener_volume_threshold": 0.6,             # The threshold volume when listening
-      "listener_silence_timeout": 0.7,              # The silence timeout when listening
-      "model_host": "127.0.0.1",                    # The host of the LLM
-      "model_port": 8080                            # The port of the LLM
+      "allow_interruptions": true,
+      "waking_up_word": "computer",
+      "waking_up_sound": true,
+      "deactivate_sound": true,
+      "improvise_tasks": true,
+      ...
     }
 
+These settings regulate the following:
+
+    * The "allow_interruptions" allows the user to create rules with the highest priority.
+      For example, the user might want a rule to be triggered in the middle of a conversation.
+
+    * "waking_up_word" is the name of the bot, used to wake up the system in the "run-audio" mode.
+
+    * "waking_up_sound" and "deactivate_sound" are played to signal the system is up or is back to idle.
+
+    * "improvise_tasks" allows the system to create its own rules to accomplish a goal.
+
 
 - The rules.wafl file contains the rules that guide the chatbot.
   The rules are written in the WAFL language, with a trigger condition on top and a list of actions below.
diff --git a/wafl/variables.py b/wafl/variables.py
index f3b52715..161fa5be 100644
--- a/wafl/variables.py
+++ b/wafl/variables.py
@@ -1,4 +1,4 @@
 def get_variables():
     return {
-        "version": "0.0.66",
+        "version": "0.0.70",
     }

From 923133e171bb7ae44dfb793c9b189a2cd90aefc7 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 16:52:31 +0100
Subject: [PATCH 26/29] reformatted

---
 tests/test_inference.py                       | 24 ++++++++++++++-----
 tests/test_task_creation.py                   | 12 +++++++---
 .../factories/whisper_connector_factory.py    |  4 +++-
 .../connectors/remote/remote_llm_connector.py |  2 +-
 wafl/extractors/entailer.py                   |  4 +++-
 wafl/extractors/extractor.py                  |  4 +---
 wafl/knowledge/project_knowledge.py           |  8 +++++--
 wafl/run.py                                   |  2 +-
 wafl/runners/run_from_audio.py                |  4 +++-
 9 files changed, 45 insertions(+), 19 deletions(-)

diff --git a/tests/test_inference.py b/tests/test_inference.py
index 157cb75e..6ee4b726 100644
--- a/tests/test_inference.py
+++ b/tests/test_inference.py
@@ -53,7 +53,9 @@ def test__simple_question(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(text="What is this bot's name", is_question=True, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -66,7 +68,9 @@ def test__fact_check_true(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(
             text="The user is in a good mood", is_question=False, variable="name"
@@ -79,7 +83,9 @@ def test__fact_check_false(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(text="The user is sad", is_question=False, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -90,7 +96,9 @@ def test__simple_rule(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(text="The user says hello!", is_question=False, variable="name")
         answer = asyncio.run(inference.compute(query, depth=1))
@@ -101,7 +109,9 @@ def test__forward_substitution(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(
             text="The user says: I can swim", is_question=False, variable="name"
@@ -114,7 +124,9 @@ def test__backward_substitution(self):
         config = Configuration.load_local_config()
         inference = BackwardInference(
             config,
-            SingleFileKnowledge(config, wafl_example), interface, Narrator(interface)
+            SingleFileKnowledge(config, wafl_example),
+            interface,
+            Narrator(interface),
         )
         query = Query(
             text="The user says: I have black hair", is_question=False, variable="name"
diff --git a/tests/test_task_creation.py b/tests/test_task_creation.py
index 3c21ffc7..39879846 100644
--- a/tests/test_task_creation.py
+++ b/tests/test_task_creation.py
@@ -95,7 +95,9 @@ def test__task_is_created_from_conversation(self):
         interface = DummyInterface(to_utter=["Tell me if I need an umbrella"])
         config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(
+                config, _wafl_example, knowledge_name="/"
+            ),
             interface=interface,
         )
         asyncio.run(conversation_events.process_next())
@@ -143,7 +145,9 @@ def test__task_is_created_from_conversation_with_code(self):
         interface = DummyInterface(to_utter=["Please list of the subfolders of /var"])
         config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(
+                config, _wafl_example, knowledge_name="/"
+            ),
             interface=interface,
             code_path="/",
         )
@@ -156,7 +160,9 @@ def test__math_task_is_created_from_conversation(self):
         interface = DummyInterface(to_utter=["Multiply 100 and 43"])
         config = Configuration.load_local_config()
         conversation_events = ConversationEvents(
-            ProjectKnowledge.create_from_string(config, _wafl_example, knowledge_name="/"),
+            ProjectKnowledge.create_from_string(
+                config, _wafl_example, knowledge_name="/"
+            ),
             interface=interface,
             code_path="/",
         )
diff --git a/wafl/connectors/factories/whisper_connector_factory.py b/wafl/connectors/factories/whisper_connector_factory.py
index f39b5874..84571b9f 100644
--- a/wafl/connectors/factories/whisper_connector_factory.py
+++ b/wafl/connectors/factories/whisper_connector_factory.py
@@ -8,4 +8,6 @@ def get_connector(config):
         if config.get_value("listener_model")["model_is_local"]:
             return LocalWhisperConnector(config.get_value("listener_model"))
 
-        return RemoteWhisperConnector(config.get_value("listener_model")["remote_model"])
+        return RemoteWhisperConnector(
+            config.get_value("listener_model")["remote_model"]
+        )
diff --git a/wafl/connectors/remote/remote_llm_connector.py b/wafl/connectors/remote/remote_llm_connector.py
index 7c206258..418d53f7 100644
--- a/wafl/connectors/remote/remote_llm_connector.py
+++ b/wafl/connectors/remote/remote_llm_connector.py
@@ -110,4 +110,4 @@ async def check_connection(self):
             print("Please run 'bash start-llm.sh' (see docs for explanation).")
             print()
 
-        return False
\ No newline at end of file
+        return False
diff --git a/wafl/extractors/entailer.py b/wafl/extractors/entailer.py
index 5afc0e59..718d305d 100644
--- a/wafl/extractors/entailer.py
+++ b/wafl/extractors/entailer.py
@@ -1,6 +1,8 @@
 from typing import Dict, Union
 
-from wafl.connectors.factories.entailment_connector_factory import EntailmentConnectorFactory
+from wafl.connectors.factories.entailment_connector_factory import (
+    EntailmentConnectorFactory,
+)
 
 
 class Entailer:
diff --git a/wafl/extractors/extractor.py b/wafl/extractors/extractor.py
index a56e5320..183c0269 100644
--- a/wafl/extractors/extractor.py
+++ b/wafl/extractors/extractor.py
@@ -67,9 +67,7 @@ async def _check_fact(self, query_text, text, variable_name, threshold):
                 text=self._entailer_to_qa_mapping[answer], variable=variable_name
             )
 
-        answer_text = normalized(
-            await self._qa.get_answer(query_text, "", text)
-        )
+        answer_text = normalized(await self._qa.get_answer(query_text, "", text))
         if answer_text != "unknown" and answer_text != "no":
             return Answer(text="Yes", variable=variable_name)
 
diff --git a/wafl/knowledge/project_knowledge.py b/wafl/knowledge/project_knowledge.py
index 92ebf645..b70658c4 100644
--- a/wafl/knowledge/project_knowledge.py
+++ b/wafl/knowledge/project_knowledge.py
@@ -125,9 +125,13 @@ def get_dependencies_list(self):
         return self._get_all_dependency_names(self.root_knowledge)
 
     @staticmethod
-    def create_from_string(config: "Configuration", rules_text: str, knowledge_name: str) -> "ProjectKnowledge":
+    def create_from_string(
+        config: "Configuration", rules_text: str, knowledge_name: str
+    ) -> "ProjectKnowledge":
         knowledge = ProjectKnowledge(config)
-        knowledge._knowledge_dict[knowledge_name] = SingleFileKnowledge(config, rules_text)
+        knowledge._knowledge_dict[knowledge_name] = SingleFileKnowledge(
+            config, rules_text
+        )
         return knowledge
 
     def _populate_knowledge_structure(
diff --git a/wafl/run.py b/wafl/run.py
index 2276dbd6..0b6555c8 100644
--- a/wafl/run.py
+++ b/wafl/run.py
@@ -21,7 +21,7 @@ def print_incipit():
 def run_from_command_line():
     interface = CommandLineInterface()
     config = Configuration.load_local_config()
-    knowledge = ProjectKnowledge(config,  "rules.wafl", logger=_logger)
+    knowledge = ProjectKnowledge(config, "rules.wafl", logger=_logger)
     conversation_events = ConversationEvents(
         knowledge,
         interface=interface,
diff --git a/wafl/runners/run_from_audio.py b/wafl/runners/run_from_audio.py
index cdaf4a2f..fc11e0f9 100644
--- a/wafl/runners/run_from_audio.py
+++ b/wafl/runners/run_from_audio.py
@@ -4,11 +4,13 @@
 from wafl.events.generated_events import GeneratedEvents
 from wafl.interface.voice_interface import VoiceInterface
 from wafl.knowledge.project_knowledge import ProjectKnowledge
-from wafl.run import _logger
+from wafl.logger.local_file_logger import LocalFileLogger
 from wafl.scheduler.conversation_loop import ConversationLoop
 from wafl.scheduler.generated_event_loop import GeneratedEventLoop
 from wafl.scheduler.scheduler import Scheduler
 
+_logger = LocalFileLogger()
+
 
 def run_from_audio():
     config = Configuration.load_local_config()

From 8b2884bb391f4c8cf8b7012a36c27672767ef4d8 Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Fri, 25 Aug 2023 17:28:23 +0100
Subject: [PATCH 27/29] updated setup.py

---
 setup.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/setup.py b/setup.py
index ae65ce72..ff09e3f5 100644
--- a/setup.py
+++ b/setup.py
@@ -17,6 +17,10 @@
         "wafl",
         "wafl.answerer",
         "wafl.connectors",
+        "wafl.connectors.bridges",
+        "wafl.connectors.factories",
+        "wafl.connectors.local",
+        "wafl.connectors.remote",
         "wafl.events",
         "wafl.extractors",
         "wafl.inference",

From 545699653687f15614ed753974867df4a5608f0f Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 26 Aug 2023 16:57:21 +0100
Subject: [PATCH 28/29] local version tested

---
 todo.txt                                      | 12 ++++++--
 wafl/answerer/arbiter_answerer.py             |  6 ++++
 .../bridges/llm_task_creator_bridge.py        |  4 +--
 .../local/local_entailment_connector.py       | 21 +++++++++++---
 wafl/connectors/local/local_llm_connector.py  | 26 +++++++++++------
 .../local_sentence_embedder_connector.py      |  9 ++++--
 wafl/data/task_creator.csv                    | 29 ++++++++++---------
 wafl/policy/answerer_policy.py                |  3 --
 8 files changed, 73 insertions(+), 37 deletions(-)

diff --git a/todo.txt b/todo.txt
index 776a268a..94f347c9 100644
--- a/todo.txt
+++ b/todo.txt
@@ -1,9 +1,15 @@
 ### TODO
 
-* make stand-alone connectors (no need for server-side)
+* make system faster to load locally. Why does it load functions.py 4 times? why the long wait?
+* add a small wafl_home to the init, with folders and everything
+
+* rule creation for "hello" is terrible. Revise all rule creation
+
+
+/* make stand-alone connectors (no need for server-side)
   /* modify config for all connectors
-  * check remote connectors work!
-  * create note about local speaker for python 3.11
+/  * check remote connectors work!
+/  * create note about local speaker for python 3.11
 
 * rewrite documentation !!!!
    * talk about how the system will improvises rules
diff --git a/wafl/answerer/arbiter_answerer.py b/wafl/answerer/arbiter_answerer.py
index 808b3ae3..80c97e07 100644
--- a/wafl/answerer/arbiter_answerer.py
+++ b/wafl/answerer/arbiter_answerer.py
@@ -72,6 +72,12 @@ def create_answerer(config, knowledge, interface, code_path, logger):
         return ArbiterAnswerer(
             config,
             {
+                "The user greets and there is no rule for that query": DialogueAnswerer(
+                    config, knowledge, interface, logger
+                ),
+                "The user speaks about themselves and there is no rule for that query": DialogueAnswerer(
+                    config, knowledge, interface, logger
+                ),
                 "The user makes small talk and there is no rule for that query": DialogueAnswerer(
                     config, knowledge, interface, logger
                 ),
diff --git a/wafl/connectors/bridges/llm_task_creator_bridge.py b/wafl/connectors/bridges/llm_task_creator_bridge.py
index 5973cd08..f14da88c 100644
--- a/wafl/connectors/bridges/llm_task_creator_bridge.py
+++ b/wafl/connectors/bridges/llm_task_creator_bridge.py
@@ -42,7 +42,7 @@ async def _get_answer_prompt(self, text: str, task: str, triggers: str = None):
         retrieved_items = "\n\n\n".join(
             [item.text for item in retrieved_items][::-1][:5]
         )
-        prompt = f""""
+        prompt = f"""" + "\n"
 {retrieved_items}
 
 
@@ -56,7 +56,7 @@ async def _get_answer_prompt(self, text: str, task: str, triggers: str = None):
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {{...}}.
 Use the least steps:
         """.strip()
 
diff --git a/wafl/connectors/local/local_entailment_connector.py b/wafl/connectors/local/local_entailment_connector.py
index 1479fe08..083e2996 100644
--- a/wafl/connectors/local/local_entailment_connector.py
+++ b/wafl/connectors/local/local_entailment_connector.py
@@ -1,19 +1,32 @@
+import logging
+
 import torch
 
 from transformers import AutoTokenizer
 from transformers import AutoModelForSequenceClassification
 from typing import Dict
 
+_system_logger = logging.getLogger(__file__)
+
 device = "cuda" if torch.cuda.is_available() else "cpu"
 
+model = None
+tokenizer = None
+
 
 class LocalEntailmentConnector:
     def __init__(self, config):
         global model, tokenizer
-        model_name = config["local_model"]
-        model = AutoModelForSequenceClassification.from_pretrained(model_name)
-        model.to(device)
-        tokenizer = AutoTokenizer.from_pretrained(model_name)
+        if not model:
+            model_name = config["local_model"]
+            _system_logger.info(f"Loading model {model_name} locally.")
+            model = AutoModelForSequenceClassification.from_pretrained(model_name)
+            model.to(device)
+            _system_logger.info(f"The model is loaded.")
+
+        if not tokenizer:
+            tokenizer = AutoTokenizer.from_pretrained(model_name)
+
         self._cache = {}
 
     async def predict(self, premise: str, hypothesis: str) -> Dict[str, float]:
diff --git a/wafl/connectors/local/local_llm_connector.py b/wafl/connectors/local/local_llm_connector.py
index 819b6b25..e9ea9997 100644
--- a/wafl/connectors/local/local_llm_connector.py
+++ b/wafl/connectors/local/local_llm_connector.py
@@ -1,13 +1,16 @@
+import logging
 import time
 import re
 import torch
 
 from transformers import AutoTokenizer, AutoModelForCausalLM
 from transformers import StoppingCriteria
-from wafl.config import Configuration
 
-device = "cuda" if torch.cuda.is_available() else "cpu"
+_system_logger = logging.getLogger(__file__)
 
+device = "cuda" if torch.cuda.is_available() else "cpu"
+model = None
+tokenizer = None
 
 class LocalLLMConnector:
     _max_tries = 3
@@ -17,13 +20,18 @@ class LocalLLMConnector:
 
     def __init__(self, config):
         global model, tokenizer
-        model = AutoModelForCausalLM.from_pretrained(
-            config["local_model"],
-            init_device=device,
-            trust_remote_code=True,
-            torch_dtype=torch.half,
-        )
-        tokenizer = AutoTokenizer.from_pretrained(config["local_model"])
+        if not model:
+            _system_logger.info(f"Loading model {config['local_model']} locally.")
+            model = AutoModelForCausalLM.from_pretrained(
+                config["local_model"],
+                init_device=device,
+                trust_remote_code=True,
+                torch_dtype=torch.half,
+            )
+            _system_logger.info(f"The model is loaded.")
+
+        if not tokenizer:
+            tokenizer = AutoTokenizer.from_pretrained(config["local_model"])
 
         self._stop_at_eos = StopAtEOS(tokenizer)
 
diff --git a/wafl/connectors/local/local_sentence_embedder_connector.py b/wafl/connectors/local/local_sentence_embedder_connector.py
index 6b6b6878..67ec2adf 100644
--- a/wafl/connectors/local/local_sentence_embedder_connector.py
+++ b/wafl/connectors/local/local_sentence_embedder_connector.py
@@ -4,13 +4,18 @@
 
 _device = "cuda" if torch.cuda.is_available() else "cpu"
 
+models_dict = {}
 
 class LocalSentenceEmbedderConnector:
     _max_tries = 3
 
     def __init__(self, model_name):
-        self._model = SentenceTransformer(model_name, device=_device)
+        self._model_name = model_name
+
+        global models_dict
+        if model_name not in models_dict:
+            models_dict[model_name] = SentenceTransformer(model_name, device=_device)
 
     async def predict(self, text: str) -> Dict[str, List[float]]:
-        vector = self._model.encode(text, show_progress_bar=False)
+        vector = models_dict[self._model_name].encode(text, show_progress_bar=False)
         return {"embedding": vector}
diff --git a/wafl/data/task_creator.csv b/wafl/data/task_creator.csv
index 3a846fe2..192c49a6 100644
--- a/wafl/data/task_creator.csv
+++ b/wafl/data/task_creator.csv
@@ -8,7 +8,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task. 
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to eat at a restaurant
    food_type = what type of food do you want?
@@ -25,7 +25,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to go somewhere
    location = where do you want to go?
@@ -43,7 +43,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to know if it is going to rain
    weather_forecast = the user wants to know the weather today
@@ -59,6 +59,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed). 
 A Python function can be added with instructions in English within <...>.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to repeat the first thing that they said 
    first_sentence = What did the user say first?
@@ -73,7 +74,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed). 
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to multiply 2 and 3
    result = multiply(2, 3) <multiply two numbers>
@@ -88,7 +89,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>. 
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to list all the files in a folder
    folder_name = which folder do you want to list?
@@ -105,7 +106,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to get the nth fibonacci number
    index = what is the index of the fibonacci number you want?
@@ -122,7 +123,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to know where to buy legos
    road_to_lego_shop = the user wants to know the road to the nearest lego shop
@@ -139,7 +140,7 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to know if they need snow boots
    weather_forecast = the user says ""what is the weather""
@@ -156,12 +157,12 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
 the user wants to know how the third planet from the sun is called
    answer = how is the third planet from the sun called
    SAY The third planet from the sun is called {answer}<|EOS|>"
-"The intention of the user is the following: the user wants to know where to go hiking in Edinburg
+"The intention of the user is the following: the user wants to know where to go hiking in Edinburgh
 
 The system has rules that are triggered by the following sentences
 - The user wants to know the road to somewhere
@@ -172,9 +173,9 @@ The first line is the rule trigger.
 The following lines are the steps to accomplish the task.
 These lines cannot contain the trigger (no recursive tasks are allowed).
 A Python function can be added with instructions in English within <...>.
-The result of a query can be used within another query by using brakets {...}.
+The result of a query can be used within another query by using brackets {...}.
 Use the least steps:
-the user wants to know where to go hiking in Scotland
-   road_to_scotland_hike = the user wants to know the road to a good hiking location in Edinburg
-   result = Answer the following question given this road: {road_to_scotland_hike}. How to get to the hiking location in Edinburg?
+the user wants to know where to go hiking in Edinburgh
+   road_to_scotland_hike = the user wants to know the road to a good hiking location in Edinburgh
+   result = Answer the following question given this road: {road_to_scotland_hike}. How to get to the hiking location in Edinburgh?
    SAY {result}<|EOS|>"
diff --git a/wafl/policy/answerer_policy.py b/wafl/policy/answerer_policy.py
index e96970c2..63d80cac 100644
--- a/wafl/policy/answerer_policy.py
+++ b/wafl/policy/answerer_policy.py
@@ -5,10 +5,7 @@
 
 class AnswerPolicy:
     def __init__(self, config, interface, logger=None):
-        self._interface = interface
         self._logger = logger
-        self._connector = RemoteLLMAnswerPolicyConnector(config.get_value("llm_model"))
-        self._max_num_past_utterances = 3
 
     async def accept(self, result: str):
         return True

From 62ba628f8c256404d8ce89fb12ea71d1c2cb1f6f Mon Sep 17 00:00:00 2001
From: Alberto Cetoli <alberto.cetoli@gmail.com>
Date: Sat, 26 Aug 2023 17:15:40 +0100
Subject: [PATCH 29/29] Added files for sample project (to be instantiated with
 wafl init)

---
 setup.py                                      |  2 +-
 wafl/config.py                                | 10 +--
 wafl/templates/functions.py                   |  5 --
 wafl/templates/rules.wafl                     |  8 --
 .../sample_project/coding/functions.py        |  0
 .../sample_project/coding/rules.wafl          | 11 +++
 .../sample_project/facts/functions.py         |  0
 .../templates/sample_project/facts/rules.wafl |  6 ++
 wafl/templates/sample_project/functions.py    |  0
 .../sample_project/greetings/functions.py     |  0
 .../sample_project/greetings/rules.wafl       |  9 ++
 .../sample_project/interruptions/functions.py |  9 ++
 .../sample_project/interruptions/rules.wafl   | 33 ++++++++
 .../sample_project/reminders/functions.py     | 22 +++++
 .../interruptions/__wafl_functions.py         |  9 ++
 .../reminders/interruptions/functions.py      |  9 ++
 .../reminders/interruptions/rules.wafl        | 33 ++++++++
 .../sample_project/reminders/rules.wafl       | 16 ++++
 wafl/templates/sample_project/rules.wafl      |  9 ++
 .../sample_project/shopping-list/functions.py | 84 +++++++++++++++++++
 .../interruptions/__wafl_functions.py         |  9 ++
 .../shopping-list/interruptions/functions.py  |  9 ++
 .../shopping-list/interruptions/rules.wafl    | 32 +++++++
 .../sample_project/shopping-list/rules.wafl   | 55 ++++++++++++
 .../sample_project/time-queries/functions.py  | 17 ++++
 .../sample_project/time-queries/rules.wafl    |  8 ++
 .../sample_project/weather/functions.py       | 43 ++++++++++
 .../sample_project/weather/rules.wafl         | 13 +++
 .../writing/__wafl_functions.py               |  0
 .../sample_project/writing/functions.py       |  0
 .../sample_project/writing/rules.wafl         |  7 ++
 31 files changed, 447 insertions(+), 21 deletions(-)
 delete mode 100644 wafl/templates/functions.py
 delete mode 100644 wafl/templates/rules.wafl
 create mode 100644 wafl/templates/sample_project/coding/functions.py
 create mode 100644 wafl/templates/sample_project/coding/rules.wafl
 create mode 100644 wafl/templates/sample_project/facts/functions.py
 create mode 100644 wafl/templates/sample_project/facts/rules.wafl
 create mode 100644 wafl/templates/sample_project/functions.py
 create mode 100644 wafl/templates/sample_project/greetings/functions.py
 create mode 100644 wafl/templates/sample_project/greetings/rules.wafl
 create mode 100644 wafl/templates/sample_project/interruptions/functions.py
 create mode 100644 wafl/templates/sample_project/interruptions/rules.wafl
 create mode 100644 wafl/templates/sample_project/reminders/functions.py
 create mode 100644 wafl/templates/sample_project/reminders/interruptions/__wafl_functions.py
 create mode 100644 wafl/templates/sample_project/reminders/interruptions/functions.py
 create mode 100644 wafl/templates/sample_project/reminders/interruptions/rules.wafl
 create mode 100644 wafl/templates/sample_project/reminders/rules.wafl
 create mode 100644 wafl/templates/sample_project/rules.wafl
 create mode 100644 wafl/templates/sample_project/shopping-list/functions.py
 create mode 100644 wafl/templates/sample_project/shopping-list/interruptions/__wafl_functions.py
 create mode 100644 wafl/templates/sample_project/shopping-list/interruptions/functions.py
 create mode 100644 wafl/templates/sample_project/shopping-list/interruptions/rules.wafl
 create mode 100644 wafl/templates/sample_project/shopping-list/rules.wafl
 create mode 100644 wafl/templates/sample_project/time-queries/functions.py
 create mode 100644 wafl/templates/sample_project/time-queries/rules.wafl
 create mode 100644 wafl/templates/sample_project/weather/functions.py
 create mode 100644 wafl/templates/sample_project/weather/rules.wafl
 create mode 100644 wafl/templates/sample_project/writing/__wafl_functions.py
 create mode 100644 wafl/templates/sample_project/writing/functions.py
 create mode 100644 wafl/templates/sample_project/writing/rules.wafl

diff --git a/setup.py b/setup.py
index ff09e3f5..a56fe68e 100644
--- a/setup.py
+++ b/setup.py
@@ -37,7 +37,7 @@
         "wafl.simple_text_processing",
     ],
     package_data={
-        "wafl": ["templates/*", "sounds/*", "models/*", "frontend/*", "data/*.csv"],
+        "wafl": ["templates/*", "templates/**/*", "sounds/*", "models/*", "frontend/*", "data/*.csv"],
     },
     install_requires=[
         "flask[async]==2.0.1",
diff --git a/wafl/config.py b/wafl/config.py
index 2893abef..88212e56 100644
--- a/wafl/config.py
+++ b/wafl/config.py
@@ -1,24 +1,20 @@
 import json
 import os
+import shutil
 
 _path = os.path.dirname(__file__)
 
 
 def create_initial_files():
-    _rules_template = open(os.path.join(_path, "templates/rules.wafl"))
-    _functions_template = open(os.path.join(_path, "templates/functions.py"))
     _events_template = open(os.path.join(_path, "templates/events.py"))
     _config_template = open(os.path.join(_path, "templates/config.json"))
     _testcases_template = open(os.path.join(_path, "templates/testcases.txt"))
     _docker_start = open(os.path.join(_path, "templates/start_llm.sh"))
+    _sample_project_dir = os.path.join(_path, "templates/sample_project/")
 
     print("+ Initializing ... ", end="")
 
-    with open("rules.wafl", "w") as file:
-        file.write(_rules_template.read())
-
-    with open("functions.py", "w") as file:
-        file.write(_functions_template.read())
+    shutil.copytree(_sample_project_dir, "./", dirs_exist_ok=True)
 
     with open("config.json", "w") as file:
         file.write(_config_template.read())
diff --git a/wafl/templates/functions.py b/wafl/templates/functions.py
deleted file mode 100644
index ccc84aef..00000000
--- a/wafl/templates/functions.py
+++ /dev/null
@@ -1,5 +0,0 @@
-from wafl.exceptions import CloseConversation
-
-
-def close_conversation():
-    raise CloseConversation()
diff --git a/wafl/templates/rules.wafl b/wafl/templates/rules.wafl
deleted file mode 100644
index 82ab0af0..00000000
--- a/wafl/templates/rules.wafl
+++ /dev/null
@@ -1,8 +0,0 @@
-The user says "bring yourself online"
-  SAY Hello there!
-
-
-the user wishes good bye
-  SAY Good bye!
-  close_conversation()
-
diff --git a/wafl/templates/sample_project/coding/functions.py b/wafl/templates/sample_project/coding/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/coding/rules.wafl b/wafl/templates/sample_project/coding/rules.wafl
new file mode 100644
index 00000000..b4a936bc
--- /dev/null
+++ b/wafl/templates/sample_project/coding/rules.wafl
@@ -0,0 +1,11 @@
+This bot can answer coding questions.
+
+Create a function in Python
+  language = what language is the function in?
+  name = what is the name of the function?
+  goal = what is the goal of the function?
+  function = Write a {language} code called {name} that accomplishes the following: {goal}
+  SAY This is what I could come up with:
+  SAY <code>
+  SAY {function}
+  SAY </code>
diff --git a/wafl/templates/sample_project/facts/functions.py b/wafl/templates/sample_project/facts/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/facts/rules.wafl b/wafl/templates/sample_project/facts/rules.wafl
new file mode 100644
index 00000000..ce348911
--- /dev/null
+++ b/wafl/templates/sample_project/facts/rules.wafl
@@ -0,0 +1,6 @@
+# Simple initial facts
+
+This bot is doing well
+This bot is called Computer
+This bot is doing okay.
+This bot is here to answer the user unless asked to be silent.
diff --git a/wafl/templates/sample_project/functions.py b/wafl/templates/sample_project/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/greetings/functions.py b/wafl/templates/sample_project/greetings/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/greetings/rules.wafl b/wafl/templates/sample_project/greetings/rules.wafl
new file mode 100644
index 00000000..2ba9bdf2
--- /dev/null
+++ b/wafl/templates/sample_project/greetings/rules.wafl
@@ -0,0 +1,9 @@
+# Greetings commands
+"bring yourself online"
+  SAY Hello there!
+
+"Hello"
+  ! This bot has greeted the user
+  SAY Hello there!
+  REMEMBER This bot has greeted the user
+
diff --git a/wafl/templates/sample_project/interruptions/functions.py b/wafl/templates/sample_project/interruptions/functions.py
new file mode 100644
index 00000000..959fada6
--- /dev/null
+++ b/wafl/templates/sample_project/interruptions/functions.py
@@ -0,0 +1,9 @@
+from wafl.exceptions import CloseConversation, InterruptTask
+
+
+def close_conversation():
+    raise CloseConversation
+
+
+def close_task():
+    raise InterruptTask
diff --git a/wafl/templates/sample_project/interruptions/rules.wafl b/wafl/templates/sample_project/interruptions/rules.wafl
new file mode 100644
index 00000000..359d3737
--- /dev/null
+++ b/wafl/templates/sample_project/interruptions/rules.wafl
@@ -0,0 +1,33 @@
+# End the conversation
+
+_close
+  close_conversation()
+
+INTERRUPTION the user believes they don't need anything else
+  SAY ok
+  _close
+
+INTERRUPTION the user says "good bye"
+  SAY good bye!
+  _close
+
+INTERRUPTION the user says to shut up
+  SAY ok
+  _close
+
+INTERRUPTION the user asks this bot to be silent
+  _close
+
+INTERRUPTION the user says: "thank you"
+  _close
+
+INTERRUPTION the user says: "thank you this is all"
+  _close
+
+INTERRUPTION the user wants to stop
+  ! Do you want to continue?
+  close_task()
+
+INTERRUPTION "nevermind"
+  close_task()
+
diff --git a/wafl/templates/sample_project/reminders/functions.py b/wafl/templates/sample_project/reminders/functions.py
new file mode 100644
index 00000000..4ae8dfde
--- /dev/null
+++ b/wafl/templates/sample_project/reminders/functions.py
@@ -0,0 +1,22 @@
+from datetime import datetime, timedelta
+from word2number import w2n
+
+
+def get_integer_from_string(text):
+    words = text.split()
+    for word in words:
+        number = w2n.word_to_num(word)
+        if number is not None:
+            return number
+
+    return None
+
+
+def get_time_in_future(minutes_from_now):
+    num_minutes = get_integer_from_string(minutes_from_now)
+    if not num_minutes:
+        return False
+
+    now = datetime.now()
+    final_time = now + timedelta(minutes=num_minutes)
+    return final_time.strftime("%H, %M")
diff --git a/wafl/templates/sample_project/reminders/interruptions/__wafl_functions.py b/wafl/templates/sample_project/reminders/interruptions/__wafl_functions.py
new file mode 100644
index 00000000..4bfcd009
--- /dev/null
+++ b/wafl/templates/sample_project/reminders/interruptions/__wafl_functions.py
@@ -0,0 +1,9 @@
+from wafl.exceptions import CloseConversation, InterruptTask
+
+
+def close_conversation(inference, task_memory):
+    raise CloseConversation
+
+
+def close_task(inference, task_memory):
+    raise InterruptTask
diff --git a/wafl/templates/sample_project/reminders/interruptions/functions.py b/wafl/templates/sample_project/reminders/interruptions/functions.py
new file mode 100644
index 00000000..959fada6
--- /dev/null
+++ b/wafl/templates/sample_project/reminders/interruptions/functions.py
@@ -0,0 +1,9 @@
+from wafl.exceptions import CloseConversation, InterruptTask
+
+
+def close_conversation():
+    raise CloseConversation
+
+
+def close_task():
+    raise InterruptTask
diff --git a/wafl/templates/sample_project/reminders/interruptions/rules.wafl b/wafl/templates/sample_project/reminders/interruptions/rules.wafl
new file mode 100644
index 00000000..359d3737
--- /dev/null
+++ b/wafl/templates/sample_project/reminders/interruptions/rules.wafl
@@ -0,0 +1,33 @@
+# End the conversation
+
+_close
+  close_conversation()
+
+INTERRUPTION the user believes they don't need anything else
+  SAY ok
+  _close
+
+INTERRUPTION the user says "good bye"
+  SAY good bye!
+  _close
+
+INTERRUPTION the user says to shut up
+  SAY ok
+  _close
+
+INTERRUPTION the user asks this bot to be silent
+  _close
+
+INTERRUPTION the user says: "thank you"
+  _close
+
+INTERRUPTION the user says: "thank you this is all"
+  _close
+
+INTERRUPTION the user wants to stop
+  ! Do you want to continue?
+  close_task()
+
+INTERRUPTION "nevermind"
+  close_task()
+
diff --git a/wafl/templates/sample_project/reminders/rules.wafl b/wafl/templates/sample_project/reminders/rules.wafl
new file mode 100644
index 00000000..4a6524f1
--- /dev/null
+++ b/wafl/templates/sample_project/reminders/rules.wafl
@@ -0,0 +1,16 @@
+the user wants to set an alarm at a specific time
+  time = At what time?
+  ERASE MEMORY
+  sentence = what do you want to be reminded of?
+  REMEMBER the time is {time} :- SAY {sentence}
+  SAY An alarm was created for {time}
+  
+the user wants to set an alarm in minutes from now
+  minutes_from_now = how many minutes from now? do not use the word 'minute'
+  time = get_time_in_future(minutes_from_now)
+  ERASE MEMORY
+  sentence = what do you want to be reminded of?
+  REMEMBER the time is {time} :- SAY {sentence}
+  SAY An alarm was created in {minutes_from_now} minutes
+  SAY The alarm time is therefore {time}
+  SAY I will say the sentence {sentence}
diff --git a/wafl/templates/sample_project/rules.wafl b/wafl/templates/sample_project/rules.wafl
new file mode 100644
index 00000000..4dbb4eb5
--- /dev/null
+++ b/wafl/templates/sample_project/rules.wafl
@@ -0,0 +1,9 @@
+#using coding
+#using facts
+#using greetings
+#using time-queries
+#using shopping-list
+#using weather
+#using writing
+#using interruptions
+#using reminders
diff --git a/wafl/templates/sample_project/shopping-list/functions.py b/wafl/templates/sample_project/shopping-list/functions.py
new file mode 100644
index 00000000..e58c2e99
--- /dev/null
+++ b/wafl/templates/sample_project/shopping-list/functions.py
@@ -0,0 +1,84 @@
+import json
+
+from fuzzywuzzy import process
+
+
+def get_shopping_list_in_english():
+    shopping_list = json.load(open("shopping_list.json"))
+    if not shopping_list:
+        return "Nothing"
+
+    return ", ".join(shopping_list)
+
+
+def add_shopping_list(item):
+    if "shopping" in item.lower():
+        return False
+
+    if "add " in item.lower():
+        item = item.lower().replace("add ", "")
+
+    if not {
+        f"% The user adds {item} to a list :- the user adds something to a grocery list %"
+    }:
+        if not {f"% Do you really want to add {item}?%"}:
+            return False
+
+    shopping_list = json.load(open("shopping_list.json"))
+    if " and " in item:
+        items_to_add = item.split(" and ")
+        shopping_list.extend(items_to_add)
+
+    else:
+        shopping_list.append(item)
+
+    json.dump(shopping_list, open("shopping_list.json", "w"))
+    f"% SAY {item} has been added to the shopping list%"
+    return True
+
+
+def remove_from_shopping_list(item):
+    shopping_list = json.load(open("shopping_list.json"))
+    if not shopping_list:
+        "% SAY the shopping list is already empty.%"
+        return False
+
+    extracted, score = process.extract(item, shopping_list, limit=1)[0]
+    if score < 60:
+        f"% SAY I did not quite get the item to remove %"
+        return False
+
+    if not {f"% Do you want to remove {extracted} from the shopping list? %"}:
+        return False
+
+    shopping_list.remove(extracted)
+    json.dump(shopping_list, open("shopping_list.json", "w"))
+    return True
+
+
+def remove_first_item_from_shopping_list():
+    shopping_list = json.load(open("shopping_list.json"))
+    if not shopping_list:
+        "% SAY the shopping list is already empty.%"
+        return False
+
+    shopping_list.pop(0)
+    json.dump(shopping_list, open("shopping_list.json", "w"))
+    return True
+
+
+def remove_last_item_from_shopping_list():
+    shopping_list = json.load(open("shopping_list.json"))
+    if not shopping_list:
+        "% SAY the shopping list is already empty.%"
+        return False
+
+    shopping_list.pop(-1)
+    json.dump(shopping_list, open("shopping_list.json", "w"))
+    return True
+
+
+def reset_shopping_list():
+    shopping_list = []
+    json.dump(shopping_list, open("shopping_list.json", "w"))
+    return True
diff --git a/wafl/templates/sample_project/shopping-list/interruptions/__wafl_functions.py b/wafl/templates/sample_project/shopping-list/interruptions/__wafl_functions.py
new file mode 100644
index 00000000..5c0483d7
--- /dev/null
+++ b/wafl/templates/sample_project/shopping-list/interruptions/__wafl_functions.py
@@ -0,0 +1,9 @@
+from wafl.exceptions import CloseConversation, InterruptTask
+
+
+async def close_conversation(inference, policy, task_memory):
+    raise CloseConversation
+
+
+async def close_task(inference, policy, task_memory):
+    raise InterruptTask
diff --git a/wafl/templates/sample_project/shopping-list/interruptions/functions.py b/wafl/templates/sample_project/shopping-list/interruptions/functions.py
new file mode 100644
index 00000000..959fada6
--- /dev/null
+++ b/wafl/templates/sample_project/shopping-list/interruptions/functions.py
@@ -0,0 +1,9 @@
+from wafl.exceptions import CloseConversation, InterruptTask
+
+
+def close_conversation():
+    raise CloseConversation
+
+
+def close_task():
+    raise InterruptTask
diff --git a/wafl/templates/sample_project/shopping-list/interruptions/rules.wafl b/wafl/templates/sample_project/shopping-list/interruptions/rules.wafl
new file mode 100644
index 00000000..e9309e99
--- /dev/null
+++ b/wafl/templates/sample_project/shopping-list/interruptions/rules.wafl
@@ -0,0 +1,32 @@
+# End the conversation
+
+_close
+  close_conversation()
+
+INTERRUPTION the user believes they don't need anything else
+  SAY ok
+  _close
+
+INTERRUPTION the user says "good bye"
+  SAY good bye!
+  _close
+
+INTERRUPTION the user says to shut up
+  SAY ok
+  _close
+
+INTERRUPTION the user asks this bot to be silent
+  _close
+
+INTERRUPTION the user says: "thank you"
+  _close
+
+INTERRUPTION the user says: "thank you this is all"
+  _close
+
+INTERRUPTION the user wants to stop
+  ! Do you want to continue?
+  close_task()
+
+INTERRUPTION "nevermind"
+  close_task()
diff --git a/wafl/templates/sample_project/shopping-list/rules.wafl b/wafl/templates/sample_project/shopping-list/rules.wafl
new file mode 100644
index 00000000..20bb84b1
--- /dev/null
+++ b/wafl/templates/sample_project/shopping-list/rules.wafl
@@ -0,0 +1,55 @@
+#using interruptions
+
+# Shopping list
+
+There is only one list, the shopping list
+
+
+item = what does the user want to add to the shopping list?
+  add_shopping_list(item)
+
+item = what does the user want to remove from the shopping list?
+  remove_from_shopping_list(item)
+
+"remove or delete an item from the shopping list"
+  item = What do you want to remove?
+  remove_from_shopping_list(item)
+  SAY item removed
+
+the user wants to delete the shopping list
+  Do you want to delete the current shopping list
+  reset_shopping_list()
+  SAY The shopping list has been deleted
+
+the user wants to know what is in the shopping list
+  items = get_shopping_list_in_english()
+  SAY The shopping list contains: {items}
+
+the user wants to add something
+  item = what does the user want to add?
+  list_name = which list?
+  the user wants to add {item} to {list_name}
+
+the user wants to remove something
+  item = what does the user want to remove?
+  list_name = which list?
+  the user wants to remove {item} from {list_name}
+
+"What should I buy"
+  the user wants to know what is in the shopping list
+
+the user wants to remove the first item in the shopping list
+  remove_first_item_from_shopping_list()
+  SAY item removed
+
+the user wants to remove the first item
+  list_name = which list?
+  the user wants to remove the first item in {list_name}
+
+the user wants to remove the last item in the shopping list
+  remove_last_item_from_shopping_list()
+  SAY item removed
+
+the user wants to remove the last item
+  list_name = which list?
+  the user wants to remove the last item in {list_name}
diff --git a/wafl/templates/sample_project/time-queries/functions.py b/wafl/templates/sample_project/time-queries/functions.py
new file mode 100644
index 00000000..fe58699c
--- /dev/null
+++ b/wafl/templates/sample_project/time-queries/functions.py
@@ -0,0 +1,17 @@
+from datetime import datetime, timedelta
+
+
+def get_date():
+    now = datetime.now()
+    return now.strftime("%A %d %B %Y")
+
+
+def get_time():
+    now = datetime.now()
+    minutes = int(now.strftime("%M"))
+    hour = int(now.strftime("%H"))
+    if minutes <= 30:
+        return f"{minutes} past {hour}"
+
+    else:
+        return f"{60 - minutes} to {hour + 1}"
diff --git a/wafl/templates/sample_project/time-queries/rules.wafl b/wafl/templates/sample_project/time-queries/rules.wafl
new file mode 100644
index 00000000..b1b1167a
--- /dev/null
+++ b/wafl/templates/sample_project/time-queries/rules.wafl
@@ -0,0 +1,8 @@
+# Time commands
+"what time is it now"
+ time = get_time()
+ SAY the time is {time}
+
+"What day is it today"
+  date = get_date()
+  SAY Today is {date}
diff --git a/wafl/templates/sample_project/weather/functions.py b/wafl/templates/sample_project/weather/functions.py
new file mode 100644
index 00000000..2af23a30
--- /dev/null
+++ b/wafl/templates/sample_project/weather/functions.py
@@ -0,0 +1,43 @@
+import json
+import requests
+
+from datetime import datetime, timedelta
+
+# These are the coordinate of central London. Please change at your convenience
+latitude = "51.5074"
+longitude = "0.1272"
+
+
+def check_today_weather():
+    today = datetime.now().strftime("%Y-%m-%d")
+    check_weather_lat_long(latitude, longitude, today)
+
+
+def check_tomorrow_weather():
+    today = datetime.now()
+    tomorrow = (today + timedelta(days=1)).strftime("%Y-%m-%d")
+    check_weather_lat_long(latitude, longitude, tomorrow)
+
+
+def check_weather_lat_long(latitude, longitude, day):
+    secrets = json.load(open("secrets.json"))
+    result = requests.get(
+        f"https://rgw.5878-e94b1c46.eu-gb.apiconnect.appdomain.cloud/metoffice/production/v0/forecasts/point/daily?excludeParameterMetadata=true&includeLocationName=true&latitude={latitude}&longitude={longitude}",
+        headers={
+            "X-IBM-Client-Id": secrets["key"],
+            "X-IBM-Client-Secret": secrets["secret"],
+        },
+    )
+    data = result.json()
+    if "features" not in data:
+        "% SAY There is a connection error to the weather API. Please try later. %"
+        return False
+
+    for item in data["features"][0]["properties"]["timeSeries"]:
+        if day in item["time"]:
+            f"% SAY The temperature should be between {int(item['dayLowerBoundMaxTemp'])} and {int(item['dayUpperBoundMaxTemp'])}. %"
+            if item["dayProbabilityOfPrecipitation"] != 0:
+                f"% SAY The probability of rain is {item['dayProbabilityOfPrecipitation']} percent. %"
+
+            if item["dayProbabilityOfSnow"] != 0:
+                f"% SAY The probability of snow is {item['dayProbabilityOfSnow']} percent. %"
diff --git a/wafl/templates/sample_project/weather/rules.wafl b/wafl/templates/sample_project/weather/rules.wafl
new file mode 100644
index 00000000..7fe2847f
--- /dev/null
+++ b/wafl/templates/sample_project/weather/rules.wafl
@@ -0,0 +1,13 @@
+# Weather
+
+"How is the weather"
+  check_today_weather()
+
+"How is the weather today"
+  check_today_weather()
+
+"What is the weather forecast"
+  check_today_weather()
+
+"How is the weather tomorrow"
+  check_tomorrow_weather()
diff --git a/wafl/templates/sample_project/writing/__wafl_functions.py b/wafl/templates/sample_project/writing/__wafl_functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/writing/functions.py b/wafl/templates/sample_project/writing/functions.py
new file mode 100644
index 00000000..e69de29b
diff --git a/wafl/templates/sample_project/writing/rules.wafl b/wafl/templates/sample_project/writing/rules.wafl
new file mode 100644
index 00000000..763f7dc2
--- /dev/null
+++ b/wafl/templates/sample_project/writing/rules.wafl
@@ -0,0 +1,7 @@
+This bot can answer coding questions.
+
+Write a paragraph
+  goal = what do you want to write about?
+  paragraph = Write a paragraph that accomplishes the following: {goal}
+  SAY This is what I could come up with:
+  SAY {paragraph}