INSTALLATION.md

Installation Instructions for Omdurman National Bank Chatbot

This document provides instructions for installing and running the improved Omdurman National Bank chatbot.

Prerequisites

• Python 3.6 or higher
• pip (Python package installer)

Installation Steps

1. Create a virtual environment (recommended):

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

2. Install Gradio with minimal dependencies:

   pip install gradio --no-deps
   

3. Install required dependencies:

   pip install gradio-client
   

4. For full functionality (if disk space allows):

   pip install numpy pandas
   

Running the Chatbot

Basic Version

To run the basic version of the chatbot:

python3 final_chatbot.py

This will start the chatbot with core functionality. The chatbot will automatically detect if the customer service enhancements module is available and adapt accordingly.

Testing Locally

Once the chatbot is running, you can access it at:

• http://localhost:7860

The chatbot will also generate a public link that you can use to access it from any device.

Troubleshooting

Disk Space Issues

If you encounter disk space issues during installation, you can try:

1. Using the --no-deps flag with pip to avoid installing unnecessary dependencies:

   pip install gradio --no-deps
   

2. Installing only the essential dependencies:

   pip install gradio-client
   

3. Using a smaller version of the chatbot by removing the customer service enhancements:

   # Run without importing customer_service_enhancements.py
   

Missing Modules

If you encounter "ModuleNotFoundError" messages:

1. Install the specific missing module:

   pip install [module_name]
   

2. If the error is related to gradio-client:

   pip install gradio-client
   

File Structure

• final_chatbot.py: The main chatbot implementation with all features
• customer_service_enhancements.py: Additional customer service features (optional)
• original_chatbot.py: The original chatbot implementation for reference
• README.md: Overview of the chatbot features and implementation
• INSTALLATION.md: This installation guide

Contact

For any issues or questions, please contact the Omdurman National Bank IT support team.