Converted find/get/random snpipets to drop-in funcs, added get_prompt() + openai examples ↞ [auto-sync from https://github.com/KudoAI/ai-personas/tree/main/python]

Author: kudo-sync-bot

ai-personas/docs/README.md

@@ -34,49 +34,52 @@ _Note: Most type checkers will falsely warn_ `ai_personas` _is not subscriptable
 
 ## Examples
 
-##### Search by keyword:
+##### Find personas by keyword:
 
 ```py
-keyword = 'coach'
+def find_personas(keyword):
+    return [
+        persona for persona, data in ai_personas.items()
+            if keyword.lower() in data['prompt'].lower()
+    ]
+
+print(find_personas('coach'))
+# => ['Interview Preparation Coach', 'Life Coach', ...]
+```
 
-for persona, data in ai_personas.items():
-    if keyword.lower() in data['prompt'].lower():
-        print(persona)
-# =>
-# ...
-# Interview Preparation Coach
-# Life Coach
-# Master Skills & Experience Summary Generator
-# Motivational Coach
-# Multilingual Writing Improvement Assistant
-# Pre-Interview Intelligence Dossier
-# ...
+##### Get prompt for a persona:
+
+```py
+def get_prompt(persona):
+    return ai_personas[persona]['prompt']
+
+print(get_prompt('Food Critic'))
+# => I want you to act as a food critic. I will tell you about a restaurant...
 ```
 
-##### Get 6 random personas:
+##### Get random personas:
 
 ```py
-import random
+def random_persona(qty=1):
+    import random
+    random_personas = random.sample(list(ai_personas), qty)
+    return random_personas[0] if qty == 1 else random_personas
 
-for persona in random.sample(list(ai_personas), 6):
-    print(persona)
+print(random_persona())
+# => e.g. Reverse Prompt Engineer
 
-# e.g. =>
-# Internet Trend & Slang Intelligence
-# Tic-Tac-Toe Game
-# Reverse Prompt Engineer
-# Study planner
-# Develop a Media Center Plan for Hajj
-# China Business Law Assistant
+print(random_persona(10))
+# => e.g. ['Internet Trend & Slang Intelligence', 'Tic-Tac-Toe Game', ...]
 ```
 
 ##### Get random prompt:
 
 ```py
-import random
+def random_prompt():
+    import random
+    return random.choice(list(ai_personas.values()))['prompt']
 
-rand_persona = random.choice(list(ai_personas.values()))
-print(rand_persona['prompt'])
+print(random_prompt())
 
 # e.g. =>
 #
@@ -153,6 +156,29 @@ messages = [
 ]
 ```
 
+##### Use persona w/ an LLM:
+
+```py
+import ai_personas
+from openai import OpenAI
+
+client = OpenAI()
+
+persona_prompt = ai_personas['Linux Terminal']['prompt']
+
+response = client.chat.completions.create(
+    model='gpt-5.4',
+    messages=[
+        {'role': 'system', 'content': persona_prompt},
+        {'role': 'user', 'content': 'ls -la'} # list files
+    ]
+)
+
+print(response.choices[0].message.content)
+```
+
+##### 
+
 ## License
 
 - Data: [CC0 1.0 Universal](https://github.com/KudoAI/ai-personas/blob/main/python/docs/licenses/LICENSE-DATA.md)