feat: Allow result to be downloaded as Excel file

-Updated gradio version in requirements.txt from 4.31.5 to 5.12.0 to fix
compatibilty issue with python 3.13. audioop-lts module was added to
gradio in 5.4.0 to compensate for removal of audioop module in Python
3.13+. See https://github.com/gradio-app/gradio/pull/9757.
-Added newlines to ends of .txt files and app.py
-Modified Gradio interface in app.py to give an additional file as
output. File is created by converting the original output DataFrame
using df.to_excel.
-Added dotenv package for easier local testing with .env file.
-Added .gitignore to ignore venv folder and .env file when pushing to
origin.
-Amend: added dotenv 1.0.1 to requirements.txt.
-Amend 2: Non-urgent issue requiring fix: output.xlsx is created in
local directory when testing locally. Will be good to cleanup when local
testing server is shut down.
-Amend 3: Added output.xlsx to .gitignore.

.gitignore

@@ -0,0 +1,3 @@
+venv
+.env
+output.xlsx

app.py

@@ -5,6 +5,10 @@ import pandas as pd # For easier data handling
 from openai import OpenAI # For sending the quotes to OpenAI for tagging
 import openpyxl # Requirement for reading Excel files into pandas Dataframes
 import json # For conversion of OpenAI responses into json/dictionary objects so the contents can be extracted
+from dotenv import load_dotenv # For loading environment variables in local environment
+
+# Load environment variables from local .env file if it exists; otherwise this does nothing
+load_dotenv()
 
 # Import prompt for requesting the tags from OpenAI
 with open("prompt.txt", "r") as prompt_file:
@@ -97,7 +101,10 @@ def process_quotes(quotes_file_path: str, quotes_col_name: str, tags_string: str
     quotes_df['Tags'] = quotes_data.apply(tag_quote, args=(tags_list,))
 
     # Return only the quotes column and the new tags column
-    return quotes_df[[quotes_col_name, 'Tags']]
+    output_df = quotes_df[[quotes_col_name, 'Tags']]
+    output_file_path = "output.xlsx"
+    output_df.to_excel(output_file_path, index=False)
+    return output_df, output_file_path
     
 # Define user interface structure
 demo = gr.Interface(
@@ -107,7 +114,10 @@ demo = gr.Interface(
         gr.Textbox(label="Name of quotes column"),
         gr.Textbox(label = "List of tags separated by commas") 
     ],
-    outputs=gr.Dataframe(headers=["Quote", "Tags"], column_widths=["70%", "30%"], scale=2),
+    outputs=[
+        gr.Dataframe(headers=["Quote", "Tags"], column_widths=["70%", "30%"], scale=2),
+        gr.File(label="Output data in file format")
+    ],
     title="Automated Research Code Tagger",
     description=INSTRUCTIONS 
     )

prompt.txt

@@ -14,4 +14,4 @@ Tag list:
 Respond in the following format:
 {{
   "tags":[<tagName1>, <tagName2>]
-}}
+}}

requirements.txt

@@ -1,3 +1,4 @@
-gradio==4.31.5
+gradio==5.12.0
 openai==1.59.3
-openpyxl==3.1.5
+openpyxl==3.1.5
+dotenv==1.0.1

user_instructions.txt

@@ -12,4 +12,4 @@ You may then copy them into an Excel file for further processing. Please allow 5
 
 Please bear in mind that the tags are AI generated so check your results to ensure they make sense before using them. 
 I will not be responsible for mistakes made by the AI, but I can try to fix them if you alert me.
--Kenneth
+-Kenneth