Update app.py

app.py

@@ -1,54 +1,82 @@
+# app.py
 
-# AI Agent Framework Imports
+# --------------------------------------------
+# Importing necessary parts of our AI framework.
+# These help us create our "agent" (our helpful assistant) and define "tools" (small functions that do specific tasks).
 from smolagents import CodeAgent, HfApiModel, tool
 
-# Standard Library Imports
+# --------------------------------------------
+# Importing a library to work with YAML files.
+# YAML files are used to store settings and instructions in a simple text format.
 import yaml
 
-# Final Answer and UI Handling
+# --------------------------------------------
+# Importing our FinalAnswerTool and GradioUI.
+# FinalAnswerTool helps produce the final output that the user sees.
+# GradioUI sets up a simple webpage so users can talk to our agent.
 from tools.final_answer import FinalAnswerTool
 from Gradio_UI import GradioUI
 
-# --------------------------------------------
-# Tool: simplify_text
+# ------------------------------------------------------------------------------------
+# Here we define a tool called simplify_text.
+# A "tool" is a small piece of code that performs one job.
+# In this case, the job is to take technical text and make it look simpler.
 @tool
 def simplify_text(text: str) -> str:
-    """Simplifies a technical sentence or paragraph into plain language.
-    
+    """
+    Simplifies a technical sentence or paragraph into plain language.
+
     Args:
         text: A technical sentence or paragraph.
     
     Returns:
         A simplified version of the text.
     """
+    # This simple version just adds "Simplified:" before the original text.
+    # Later, you can make this more advanced by changing the wording.
     return "Simplified: " + text
 
-# --------------------------------------------
-# Configure the AI Model.
-# If the primary model is overloaded, you may later switch the model_id to an alternative endpoint.
+# ------------------------------------------------------------------------------------
+# Now we set up the AI model.
+# Think of the model as the "brain" of our agent that understands questions and comes up with answers.
+# We use a model hosted at a specific web address.
 model = HfApiModel(
-    max_tokens=2096,
-    temperature=0.5,
+    max_tokens=2096,  # This sets a limit on how long the model's answer can be.
+    temperature=0.5,  # This controls the creativity of the answer (0.5 is moderate).
+    # We are using an alternative endpoint here. If the original model is overloaded,
+    # you can use this endpoint instead.
     model_id='https://pflgm2locj2t89co.us-east-1.aws.endpoints.huggingface.cloud',
+    # If you ever want to switch back to the original model, you could use:
+    # model_id='Qwen/Qwen2.5-Coder-32B-Instruct',
     custom_role_conversions=None
 )
 
-# Load prompt templates from a YAML configuration file.
+# ------------------------------------------------------------------------------------
+# Next, we load some prompt templates from a file called "prompts.yaml".
+# Prompt templates act like a script that tells the model how to behave.
 with open("prompts.yaml", 'r') as stream:
     prompt_templates = yaml.safe_load(stream)
 
-# Create the AI agent with the defined tools.
+# ------------------------------------------------------------------------------------
+# Here we create our AI agent.
+# The agent is like your digital helper that uses the model (its brain) and the tools (its abilities) to answer questions.
+# We give it two tools:
+#   - FinalAnswerTool: This tool helps package the final answer.
+#   - simplify_text: Our custom tool that makes technical language simpler.
 agent = CodeAgent(
     model=model,
     tools=[
         FinalAnswerTool(),
         simplify_text
     ],
-    max_steps=6,
-    verbosity_level=1,
+    max_steps=6,             # This sets a limit on how many steps the agent can take to come up with an answer.
+    verbosity_level=1,       # This controls how detailed the agent's inner thoughts are (for debugging or learning).
     prompt_templates=prompt_templates
 )
 
-# Launch the interactive UI using Gradio.
+# ------------------------------------------------------------------------------------
+# Finally, we start the user interface so that people can interact with the agent.
+# Gradio makes a simple webpage where you can type questions and see answers.
+# The following line tells Gradio to listen on all network addresses (0.0.0.0) at port 7860.
 if __name__ == "__main__":
     GradioUI(agent).launch(server_name="0.0.0.0", server_port=7860)