unai/README.md

UTAS Oman University Portal

A modern, bilingual (Arabic/English) university portal for the University of Tasmania's campus in Muscat, Sultanate of Oman. Features an AI-powered chatbot using OpenRouter API for intelligent student assistance.

🌟 Features

🤖 AI-Powered Chatbot

• Real AI: Uses OpenRouter API with Meta LLaMA model or Ollama local models
• Bilingual Support: Automatically detects and responds in Arabic or English
• UTAS Oman Context: Specialized knowledge about campus, programs, and admissions
• Personalized Responses: Tailors answers based on user authentication and role
• No Mock Data: All responses generated by real AI

🎓 Academic Programs

• Comprehensive undergraduate and postgraduate program listings
• UTAS Oman-specific courses aligned with Oman Vision 2040
• Detailed program information, requirements, and career outcomes
• Search and filtering capabilities

🌐 Bilingual Interface

• Arabic and English language support
• Cultural appropriateness for Omani students
• RTL (Right-to-Left) text support for Arabic

📱 Modern Design

• Responsive design for all devices
• Clean, professional interface
• UTAS Oman branding and colors
• Accessibility features

🚀 Getting Started

Prerequisites

• Node.js 18+
• OpenRouter API key

Installation

1. Clone the repository

   git clone <repository-url>
   cd university-portal
   

2. Install dependencies

   npm install
   

3. Set up environment variables

   cp .env.example .env.local
   

   Add your OpenRouter API key to .env.local:

   OPENROUTER_API_KEY=your_openrouter_api_key_here
   

4. Run the development server

   npm run dev
   

5. Open your browser Navigate to http://localhost:3000

🤖 Chatbot Setup

Configuration

1. Create a .env.local file in the project root with the following variables:

   # OpenRouter API Key (for LLM access)
   OPENROUTER_API_KEY=sk-your-key-here
   
   # Ollama configuration (for local model fallback)
   OLLAMA_URL=http://localhost:11434
   MODEL_COMMAND_R7B=command-r7b-arabic
   

2. To use the Ollama fallback:

   • Install Ollama from https://ollama.ai/
   • Pull the Arabic-capable model: ollama pull command-r7b-arabic
   • Start the Ollama server locally: ollama serve

3. The chatbot automatically:

   • Tries OpenRouter first if API key is available
   • Falls back to Ollama if OpenRouter key is missing
   • Detects language (Arabic/English) and responds accordingly
   • Personalizes responses based on user authentication status

Testing the Chatbot

Run the built-in chatbot tests:

npm run test:chat

Or run the integration tests:

npm run test

Personalization Features

The chatbot provides different responses based on authentication:

• Anonymous Users: Public information only (courses, admissions, etc.)
• Authenticated Students: Personalized responses with student profile data
• Faculty/Staff: More detailed institutional information
• Administrators: Full access to university systems information

🛠️ Technology Stack

• Framework: Next.js 14+ with React 19
• Styling: Tailwind CSS
• TypeScript: Full type safety
• AI Integration: OpenRouter API
• Database: Prisma (for future enhancements)

🎯 AI Chatbot Features

The AI chatbot is the centerpiece of this portal:

• Language Detection: Automatically detects Arabic or English input
• Contextual Responses: Uses UTAS Oman knowledge base for relevant information
• OpenRouter Integration: Powered by Meta LLaMA 3.1 8B model
• Conversation Memory: Maintains conversation history for context
• Error Handling: Graceful fallbacks when API is unavailable

Testing the Chatbot

Try these sample queries:

English:

• "Tell me about MBA programs"
• "What are the admission requirements?"
• "How can I apply for scholarships?"

Arabic:

• "أخبرني عن برامج الماجستير"
• "ما هي متطلبات القبول؟"
• "كيف يمكنني التقدم للحصول على منح دراسية؟"

🏫 About UTAS Oman

This portal represents the University of Tasmania's campus in Muscat, Sultanate of Oman:

• Location: Knowledge Oasis Muscat
• Programs: Aligned with Oman Vision 2040
• Quality: Australian education standards
• Local Relevance: Designed for Omani students and industry needs

📞 Contact Information

• Phone: +968 2414 3555
• Email: admissions@utas.edu.om
• Address: Knowledge Oasis Muscat, Sultanate of Oman

🤝 Contributing

This is a demo project showcasing AI-enhanced university portal capabilities. For improvements or suggestions, please open an issue.

📄 License

This project is for demonstration purposes.

---

Built with ❤️ for UTAS Oman students and the future of education in Oman.