add Guidance prompt design tutorials

onlyphantom · onlyphantom · commit fec67ee10530 · 2023-06-24T12:07:59.000+07:00
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,5 @@
 .env
 notes.md
 academy/
-*_x.py
+*_x.py
+.vscode/
diff --git a/12_guidance_roles.py b/12_guidance_roles.py
@@ -0,0 +1,38 @@
+from dotenv import load_dotenv
+import guidance
+
+load_dotenv()
+
+chat = guidance.llms.OpenAI("gpt-3.5-turbo")
+guidance.llm = chat
+
+program = guidance(
+    """
+    {{#system}}You are a CS Professor teaching {{os}} systems administration to your students.{{/system}}
+
+    {{#user~}}
+    What are some of the most common commands used in the {{os}} operating system? Provide a one-liner description.
+    List the commands and their descriptions one per line. Number them starting from 1.
+    {{~/user}}
+
+    {{#assistant~}}
+    {{gen 'commands' max_tokens=100}}
+    {{~/assistant}}    
+
+    {{#user~}}
+    Which among these commands are beginners most likely to get wrong? Explain why the command might be confusing. Show example code to illustrate your point.
+    {{~/user}}
+
+    {{#assistant~}}
+    {{gen 'confusing_commands' max_tokens=100}}
+    {{~/assistant}}
+    """,
+    llm=chat,
+)
+
+
+result = program(os="Linux")
+
+print(result["commands"])
+print("===")
+print(result)
diff --git a/12_guidance_syntax.py b/12_guidance_syntax.py
@@ -0,0 +1,62 @@
+import random
+from dotenv import load_dotenv
+import guidance
+
+load_dotenv()
+
+# set the default language model that execute guidance programs
+guidance.llm = guidance.llms.OpenAI("text-davinci-003")
+# guidance.llm = guidance.llms.Transformers(
+#     "stabilityai/stablelm-base-alpha-3b", device="cpu"
+# )
+
+
+program = guidance(
+    """What are the top ten most common commands used in the {{os}} operating system? Provide 
+    a one-liner description for each command.
+    {{#block hidden=True}}
+    A few example commands would be: 
+    [1]: pwd prints the current working directory
+    [2]: mv moves the file and can be used to rename a file 
+    {{gen 'example' n=2 stop='"' max_tokens=20 temperature=0.8}}
+    {{/block}}
+
+    Here are the common commands: 
+    {{#geneach 'commands' num_iterations=10}}
+    [{{@index}}]: "{{gen 'this' stop='"'}}", Description: "{{gen 'description' stop='"'}}" 
+    {{/geneach}}
+
+    {{select 'flavor' options=quizflavor}}
+    Explain the following commands for 🥇 {{randomPts}} points:
+    {{#each (pickthree commands)}}
+    {{@index+1}}. "{{this}}" 
+    {{/each}}
+
+    Use the commands you listed above as input, generate a valid JSON object that maps each command to its description.
+    "{
+        "{{os}}": [
+            {{#geneach 'commands' num_iterations=1}}{{#unless @first}},{{/unless}}
+                "{{gen 'this'}}"
+            {{/geneach}}
+    """
+)
+
+quizflavor = [
+    "Quiz of the day!",
+    "Test your knowledge!",
+    "Here is a quiz!",
+    "You think you know Unix?",
+]
+
+result = program(
+    os="Linux",
+    pickthree=lambda x: list(set(x))[:3],
+    randomPts=random.randint(1, 5),
+    quizflavor=quizflavor,
+)
+
+print(result["example"])
+print("===")
+print(result["commands"])
+print("===")
+print(result)
diff --git a/README.md b/README.md
@@ -4,7 +4,7 @@ A set of instructional materials, code samples and Python scripts featuring LLMs
 <!-- <img src="assets/youtube.png" width="50%" alt="LangChain youtube tutorials" /> -->
 ![LangChain youtube tutorials](assets/llmseries.png)
 
-Learn LangChain from my YouTube channel (~7 hours of LLM hands-on building tutorials); Each lesson is accompanied by the corresponding code in this repo and is designed to be self-contained -- while still focused on some key concepts in LLM (large language model) development and tooling. 
+Learn LangChain from my YouTube channel (~8 hours of LLM hands-on building tutorials); Each lesson is accompanied by the corresponding code in this repo and is designed to be self-contained -- while still focused on some key concepts in LLM (large language model) development and tooling. 
 
 Feel free to pick and choose your starting point based on your learning goals:
 
@@ -21,6 +21,7 @@ Feel free to pick and choose your starting point based on your learning goals:
 | 9 | Building a queryable journal 💬 w/ OpenAI, markdown & LlamaIndex 🦙 | [Tutorial Video](https://youtu.be/OzDhJOR5IfQ) | 40:29 |
 | 10 | Making a Sci-Fi game w/ Cohere LLM + Stability.ai: Generative AI tutorial | [Tutorial Video](https://youtu.be/uR93yTNGtP4) | 1:02:20 |
 | 11 | GPT builds entire party invitation app from prompt (ft. SMOL Developer) | [Tutorial Video](https://www.youtube.com/watch?v=Ll_VIsIjuFg) | 41:33 | 
+| 12 | A language for LLM prompt design: Guidance | [Tutorial Video](https://youtu.be/k4Ejc3bLQiU) | 43:15 | 
 
 
 The full lesson playlist can be found [here](https://www.youtube.com/playlist?list=PLXsFtK46HZxUQERRbOmuGoqbMD-KWLkOS).
