Skip to content

Ru-1234/Ustaad-Hub

 
 

Repository files navigation

🔧 Ustaad Hub

Connecting users with verified local service providers — plumbers, electricians, carpenters, and more — via voice commands, GPS tracking, and secure booking.

Platform Database Status License


The Problem

Ever had a pipe burst at midnight and had no idea who to call? Or spent hours scrolling through random Facebook groups looking for a reliable electrician?

Finding trustworthy local service workers is frustrating, time-consuming, and often unreliable.

Ustaad Hub changes that.


What is Ustaad Hub?

Ustaad Hub is a platform that bridges the gap between customers and skilled local service workers. Whether you need a plumber, electrician, carpenter, or handyman — find, book, and connect with verified professionals near you in minutes.

Built with accessibility in mind, Ustaad Hub is especially designed to empower users who face barriers to traditional service discovery — including those who prefer voice interaction over typing.


Features

Feature Description
Service Categories Electrician, Plumber, Carpenter, Handyman
OTP Verification Secure email-based user registration
Calendar Booking Schedule services at your convenience
GPS Tracking Real-time location tracking for users and workers
Ratings & Reviews Two-way rating system for trust and transparency
Voice Agent Find services using voice commands — no typing needed
Worker Dashboard Earnings tracking and booking management for workers
Secure Payments Cashless, safe transactions built in

🎙️ Voice Agent — The Star Feature

"Find me a plumber near me." — and you're done.

The built-in voice agent lets users interact with the platform entirely through speech. This is particularly powerful for:

  • People in emergencies who can't type
  • Users with low digital literacy
  • Busy users who need quick access

Tech Stack

Layer Technology
Frontend .NET MAUI (XAML)
Backend C# / .NET 10
Database SQLite (sqlite-net-pcl)
Maps Google Maps Embed API
Email Gmail SMTP (System.Net.Mail)
Voice LiveKit + Deepgram STT/TTS + Groq LLM
Bridge FastAPI (Python)

📂 Project Structure

UstaadHub/
│
├── Models/
│   ├── Booking.cs
│   ├── Message.cs
│   ├── Review.cs
│   ├── User.cs
│   └── Worker.cs
│
├── Views/
│   ├── BookingPage.xaml
│   ├── ChatPage.xaml
|   ├── CustomerProfilePage.xaml
|   ├── CustomerRatingPage.xaml
│   ├── LoginPage.xaml
│   ├── MapPage.xaml
│   ├── MyBookingsPage.xaml
|   ├── NotificationSettingsPage.xaml
│   ├── OtpVerificationPage.xaml
│   ├── RatingPage.xaml
│   ├── RegisterPage.xaml
│   ├── ServicesPage.xaml
│   ├── TrackingPage.xaml
│   ├── VoiceChatSheet.xaml
│   ├── WorkerDashboardPage.xaml
|   ├── WorkerEarningsPage.xaml
│   ├── WorkerListPage.xaml
│   ├── WorkerProfilePage.xaml
│   ├── WorkerReviewsPage.xaml
│   ├── WorkerManageBookingsPage.xaml
│   └── WorkerSettingsPage.xaml
│
├── Services/
│   ├── BridgeService.cs
│   ├── DatabaseService.cs
│   └── EmailService.cs
│
├── Resources/
│   ├── AppIcon/
│   ├── Fonts/
│   ├── Images/
│   ├── Raw/
│   ├── Splash/
│   └── Styles/
│
├── Platforms/
│   ├── Android/
│   ├── iOS/
│   ├── MacCatalyst/
│   └── Windows/
│
├── App.xaml
├── App.xaml.cs
├── MauiProgram.cs
├── UstaadHub.csproj
├── UstaadHub.slnx
└── LICENSE

Development Roadmap

Iteration 1 — Core Functionality

  • User registration & login (OTP-based)
  • Service categories listing
  • Database setup & backend connectivity

Iteration 2 — Booking & Map Integration

  • Google Maps integration
  • Calendar-based booking system
  • Backend logic for booking confirmation

Iteration 3 — Ratings, Dashboard & Voice

  • Rating & review system
  • Worker dashboard (earnings + schedule)
  • Voice agent integration & testing

▶️ How to Run

Step 1 — Run the .NET MAUI App

  1. Open Microsoft Visual Studio 2022
  2. Open UstaadHub.csproj
  3. Build Solution (Ctrl + Shift + B)
  4. Run on Windows or Android

Step 2 — Run Bridge Server

cd ustaad-bridge
pip install websockets
pip install "uvicorn[standard]"
pip install aiofiles
.\venv\Scripts\activate
uvicorn main:app --host 127.0.0.1 --port 8000 --reload

Step 3 — Run Voice Agent

cd ustaad-agent
pip install livekit-agents==1.3.12 livekit==1.0.23 livekit-plugins-deepgram==1.3.12 livekit-plugins-silero==1.3.12 livekit-plugins-noise-cancellation==0.2.5 livekit-plugins-groq==1.3.12 livekit-plugins-openai==1.3.12 livekit-plugins-bey fastapi uvicorn groq requests python-dotenv aiohttp
.\venv\Scripts\Activate.ps1
python agent.py dev

🎙️ Voice Agent Repo: https://github.com/CoderMalaika-dotcom/-AI-Voice-Receptionist-with-LiveKit.git


Scope Limitations

  • Large-scale construction projects
  • Material or goods delivery
  • Legal or consultancy services
  • Multi-city deployment (single area initially)

Team

Name Student ID
Maham Anjum 24I-0053
Romaisa 24I-0061
Malaika 24I-2025

Department of Computer Science National University of Computer and Emerging Sciences, Islamabad 🇵🇰


📄 License

Academic project — FAST-NUCES


Made with ❤️ to solve real problems, for real people.

About

Ustaad Hub — Connecting users with verified local service providers (plumbers, electricians, carpenters) via voice commands, GPS tracking, and secure booking.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C# 100.0%