feat: add LangChain bots

Author: solygambas

Diff for: 12-langchain-bots/README.md

@@ -0,0 +1,44 @@
+# LangChain Bots
+
+Two automated AI tools to generate emails and search Wikipedia with LangChain.
+
+## Setup
+
+You need to create a virtual env and install the packages listed in `requirements.txt`.
+
+Follow these steps: [How to Work with Python Virtual Environments, Jupyter Notebooks and VS Code](https://python.plainenglish.io/how-to-work-with-python-virtual-environments-jupyter-notebooks-and-vs-code-536fac3d93a1).
+
+You need to create a `.env` file with your `OPENAI_API_KEY`.
+
+Make sure you have installed `langchain` and `wikipedia`.
+
+## Usage
+
+### Email Generator
+
+To run the tool:
+
+```
+cd 12-langchain-bots
+python3 email_generator.py
+```
+
+Provide the content, the customer name and your name.
+
+### Wikipedia Search Tool
+
+To run the tool:
+
+```
+cd 12-langchain-bots
+python3 wikipedia_search.py
+```
+
+Describe what you need to find.
+
+## Features
+
+- [generating emails](email_generator.py).
+- [searching on Wikipedia](wikipedia_search.py).
+
+Based on [ChatGPT - The Complete Guide to ChatGPT & OpenAI APIs](https://www.udemy.com/course/chatgpt-bard-bing-complete-guide-to-chatgpt-openai-apis/) by Maximilian Schwarzmüller (2023).

Diff for: 12-langchain-bots/email_generator.py

@@ -0,0 +1,37 @@
+from langchain.llms import OpenAI
+from langchain.prompts import PromptTemplate
+from dotenv import dotenv_values
+
+config = dotenv_values(".env")
+
+llm = OpenAI(openai_api_key=config["OPENAI_API_KEY"], temperature=0.0)
+
+prompt = PromptTemplate(
+    input_variables=["content", "customer_name", "agent_name"],
+    template="""
+    You are an AI assistant that's optimized to write concise, friendly & professional emails to customers.
+
+    Write an email to a customer with the name {customer_name} that contains the following, optimized content: {content}
+
+    The email signature should contain the name of the customer agent who wrote the email: {agent_name}
+    """,
+)
+
+content = input("Email content: ")
+# sorry about the broken cup, we can replace it or provide a refund
+customer = input("Customer name: ")
+agent = input("Agent name: ")
+
+response = llm(prompt.format(content=content, customer_name=customer, agent_name=agent))
+
+print(response)
+
+# Dear Gianluca,
+
+# We apologize for the broken cup you received. We would be happy to replace it or provide a refund. Please let us know which option you would prefer.
+
+# Thank you for your patience and understanding.
+
+# Sincerely,
+# Mario
+# Customer Agent

Diff for: 12-langchain-bots/wikipedia_search.py

@@ -0,0 +1,38 @@
+from langchain.llms import OpenAI
+from langchain.agents import load_tools, initialize_agent, AgentType
+from dotenv import dotenv_values
+
+config = dotenv_values(".env")
+
+llm = OpenAI(openai_api_key=config["OPENAI_API_KEY"], temperature=0.0)
+
+tools = load_tools(["wikipedia", "llm-math"], llm=llm)
+# https://python.langchain.com/docs/modules/agents/tools/
+
+agent = initialize_agent(
+    tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION, verbose=True
+)
+
+prompt = input("The Wikipedia research task: ")
+
+agent.run(prompt)
+
+# The Wikipedia research task: How old is President Biden?
+
+
+# > Entering new  chain...
+#  I need to find out the age of President Biden.
+# Action: Wikipedia
+# Action Input: Joe Biden
+# Observation: Page: Joe Biden
+# Summary: Joseph Robinette Biden Jr. ( (listen) BY-dən; born November 20, 1942) is an American politician who is the 46th and current president of the United States. A member of the Democratic Party, he previously served as the 47th vice president from 2009 to 2017 under President Barack Obama and represented Delaware in the United States Senate from 1973 to 2009.
+# Born in Scranton, Pennsylvania, Biden moved with his family to Delaware in 1953. He studied at the University of Delaware before earning his law degree from Syracuse University. He was elected to the New Castle County Council in 1970 and became the sixth-youngest senator in U.S. history after he was elected in 1972, at age 29. Biden was the chair or ranking member of the Senate Foreign Relations Committee for 12 years. He chaired the Senate Judiciary Committee from 1987 to 1995; drafted and led the effort to pass the Violent Crime Control and Law Enforcement Act and the Violence Against Women Act; and oversaw six U.S. Supreme Court confirmation hearings, including the contentious hearings for Robert Bork and Clarence Thomas. Biden ran unsuccessfully for the Democratic presidential nomination in 1988 and 2008. Barack Obama chose him as his running mate in the 2008 and 2012 presidential elections. Biden was a close counselor to Obama during his two terms as vice president. He also oversaw infrastructure spending to counteract the Great Recession and had a principal role in designing the withdrawal of United States troops from Iraq. In the 2020 presidential election, Biden and his running mate, Kamala Harris, defeated incumbents Donald Trump and Mike Pence.
+# On January 20, 2021, at the age of 78, Biden became the oldest president in U.S. history, the first to have a female vice president, and the first from Delaware. Biden restored America's membership in the Paris Agreement, and signed a $1.9 trillion economic stimulus package in response to the recession caused by the COVID-19 pandemic, a bipartisan bill investing in infrastructure, and the CHIPS and Science Act. Aspects of Biden's Build Back Better Plan were scaled back and presented in the Inflation Reduction Act that was passed by Congress and signed into law by Biden in 2022. The economy during Biden's presidency has been marked by GDP growth and job creation amid significantly elevated inflation. He appointed Ketanji Brown Jackson to the Supreme Court. In 2023, Biden and congressional Republicans prevented a default by negotiating a deal to raise the debt ceiling. In foreign policy, Biden oversaw the withdrawal of U.S. troops from Afghanistan that ended the war in Afghanistan, during which the Afghan government collapsed and the Taliban seized control. He has responded to the Russian invasion of Ukraine by imposing sanctions on Russia and authorizing foreign aid and weapons shipments to Ukraine. On April 25, 2023, Biden announced his intention to run for a second term as president in 2024.
+
+# Page: Family of Joe Biden
+# Summary: Joe Biden, the 46th and current president of the United States, has family members who are prominent in law, education, activism and politics. Biden's immediate family became the first family of the United States on his inauguration on January 20, 2021. His immediate family circle was also the second family of the United States from 2009 to 2017, when Biden was vice president.  Biden's family is mostly descended from the British Isles, with most of their ancestors coming from Ireland and England, and a smaller number descending from the France.Of Joe Biden's sixteen great-great grandparents, ten were born in Ireland. He is descended from the Blewitts of County Mayo and the Finnegans of County Louth. One of Biden's great-great-great grandfathers was born in Sussex, England, and emigrated to Maryland in the United States by 1820.
+
+# Page: Presidency of Joe Biden
+# Summary: Joe Biden's tenure as the 46th president of the United States began with his inauguration on January 20, 2021. Bi
+# Thought: I now know the final answer
+# Final Answer: Joe Biden is 78 years old.

Diff for: README.md

@@ -1,6 +1,6 @@
 # OpenAI Projects
 
-11 projects using ChatGPT API, Whisper, Embeddings, and DALL-E with Python.
+12 projects using ChatGPT API, Whisper, Embeddings, and DALL-E with Python.
 
 | #   | Project                                                                           | Description                                                                                  |
 | --- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
@@ -15,6 +15,7 @@
 | 09  | [**Choose Your Own Adventure App**](09-choose-your-own-adventure)                 | A gamebook app with DALL-E, Stable Diffusion, and GPT-4.                                     |
 | 10  | [**Whisper Transcription Tool**](10-whisper-transcription-tool)                   | A tool to convert spoken audio into accurate transcriptions and translations, using Whisper. |
 | 11  | [**Auto-GPT Bots**](11-auto-gpt-bots)                                             | Two AI assistants to scrape emails and teach code with Auto-GPT.                             |
+| 12  | [**LangChain Bots**](12-langchain-bots)                                           | Two automated AI tools to generate emails and search Wikipedia with LangChain.               |
 
 ## Setup