README.md

metadata

title: ORU IT Helpdesk Assistant
emoji: 🏛️
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: apache-2.0
tags:
  - education
  - university
  - helpdesk
  - bedrock
  - knowledge-base
short_description: AI-powered IT helpdesk for Oral Roberts University

ORU IT Helpdesk Assistant

A powerful AI-powered helpdesk assistant for Oral Roberts University's Information Technology department. Built with Amazon Bedrock Knowledge Bases and S3 Vectors for cost-effective, scalable support.

🎓 About

This application provides instant, accurate answers to common IT questions for ORU students, faculty, and staff. It leverages:

• Amazon Bedrock Knowledge Bases for intelligent document retrieval
• S3 Vectors for cost-effective vector storage (up to 90% cost savings)
• Amazon Nova Pro for natural language generation
• Gradio for a professional, user-friendly interface

🏛️ Features

• ORU-branded interface with official university colors
• Dual search modes: AI-generated responses or source retrieval
• Common question shortcuts for frequently asked IT questions
• Real-time status indicators and error handling
• Mobile-responsive design for campus-wide access

⚙️ Configuration

This application requires AWS credentials and a configured Bedrock Knowledge Base.

Required Environment Variables

• KNOWLEDGE_BASE_ID: Your Amazon Bedrock Knowledge Base ID
• AWS_REGION: AWS region (e.g., us-east-1)
• AWS_ACCESS_KEY_ID: AWS access key
• AWS_SECRET_ACCESS_KEY: AWS secret key

Setup Instructions

1. Configure your Amazon Bedrock Knowledge Base with ORU IT documentation
2. Upload your IT knowledge base content to S3
3. Set up the required environment variables in Hugging Face Spaces
4. Test with sample queries

🔒 Security

• All AWS credentials are stored as secure environment variables
• No sensitive information is logged or exposed
• Designed for internal university use

📞 Support

For technical support or questions about this application, contact the ORU IT department.

---

Powered by: Amazon Bedrock • S3 Vectors • Gradio • Hugging Face Spaces