chore: reorganize imports and improve function documentation in main.py

Author: Explorergt92

automotive_ai/main.py

@@ -3,37 +3,36 @@
 """
 
 import os
+
 import serial
+from azure.identity import DefaultAzureCredential, get_bearer_token_provider
+from dotenv import load_dotenv
+from openai import AzureOpenAI, OpenAI
 
-from _utils._commands import voice_commands
-from automotive_ai._api._openai._gpt_chat import (
-    chat_gpt,
-    load_conversation_history,
-    save_conversation_history,
-    summarize_conversation_history_direct,
-    extract_vin,
-)
 from automotive_ai._api._msal._graph_api import (
     create_new_appointment,
     get_emails,
     get_next_appointment,
     send_email_with_attachments,
 )
-from automotive_ai._utils._commands import ELM327_COMMANDS
-from _utils._serial_commands import (
-    send_command,
+from automotive_ai._api._nhtsa._vin_decoder import decode_vin
+from automotive_ai._api._openai._gpt_chat import (
+    chat_gpt,
+    extract_vin,
+    load_conversation_history,
+    save_conversation_history,
+    summarize_conversation_history_direct,
+)
+from automotive_ai._audio._audio_output import tts_output
+from automotive_ai._utils._commands import ELM327_COMMANDS, voice_commands
+from automotive_ai._utils._serial_commands import (
+    parse_vin_response,
     process_data,
+    send_command,
     send_diagnostic_report,
-    parse_vin_response,
 )
-from automotive_ai._api._nhtsa._vin_decoder import decode_vin
-from automotive_ai._voice._voice_recognition import recognize_speech, recognize_command
-from _audio._audio_output import tts_output
-from openai import OpenAI, AzureOpenAI
-from azure.identity import DefaultAzureCredential, get_bearer_token_provider
-from dotenv import load_dotenv
+from automotive_ai._voice._voice_recognition import recognize_command, recognize_speech
 
-# Load variables from .env file
 load_dotenv()
 
 openai_client = None
@@ -59,7 +58,7 @@ def configure_openai():
     Configures the OpenAI client based on environment variables.
 
     This function sets up the OpenAI client using different configurations depending on
-    the environment variables provided. It supports Azure OpenAI endpoints, and OpenAI API keys.
+    the environment variables provided. It supports Azure OpenAI, and OpenAI endpoints.
 
     Raises:
         ValueError: If required environment variables for Azure OpenAI are missing or
@@ -68,7 +67,7 @@ def configure_openai():
     Environment Variables:
         AZURE_OPENAI_ENDPOINT: The Azure endpoint for OpenAI.
         AZURE_OPENAI_API_KEY: The API key for Azure OpenAI.
-        AZURE_OPENAI_CHATGPT_DEPLOYMENT_NAME: The deployment name for Azure OpenAI ChatGPT.
+        AZURE_OPENAI_CHATGPT_DEPLOYMENT_NAME: Deployment name for Azure OpenAI ChatGPT.
         AZURE_OPENAI_API_VERSION: The API version for Azure OpenAI.
         OPENAICOM_API_KEY: The API key for OpenAI.
         OPENAICOM_MODEL: The model name for OpenAI (default is "gpt-4o-mini").
@@ -91,7 +90,7 @@ def configure_openai():
                 "AZURE_OPENAI_CHATGPT_DEPLOYMENT_NAME is required for Azure OpenAI"
             )
         openai_client = AzureOpenAI(
-            api_version=os.getenv("AZURE_OPENAI_API_VERSION") or "2024-10-21",
+            api_version=os.getenv("OPENAI_API_VERSION") or "2024-10-21",
             azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT"),
             **client_args,
         )
@@ -146,7 +145,7 @@ def main_conversation(args, user_object_id=None, use_elm327=False):
 
     while True:
         if not standby_mode:
-            print("\nPlease say a command:")
+            print("\nSpeech Recognition Active:")
         text = recognize_speech()
         if text:
             lower_text = text.lower()
@@ -288,7 +287,8 @@ def main_conversation(args, user_object_id=None, use_elm327=False):
                     print(f"{next_appointment}")
 
                 elif cmd == "create_appointment":
-                    create_new_appointment(recognize_speech)
+                    appointment_input = recognize_speech()
+                    create_new_appointment(appointment_input, tts_output)
                     print("New appointment created.")
 
                 elif cmd == "check_outlook_email":