DORA - Urdu Voice Scheduler 🎙️📅

Schedule events using Urdu voice commands and Google Calendar integration

Features • Demo • Getting Started • Usage • Contributing • Roadmap

🌟 Overview

DORA is a modern web application that enables users to schedule calendar events using Urdu voice commands, providing a seamless integration with Google Calendar. The application leverages cutting-edge technologies to deliver a responsive and intuitive user experience.

✨ Features

• 🗣️ Urdu Voice Scheduling - Record voice commands in Urdu to create events
• 📆 Google Calendar Integration - View, create, update, and delete calendar events
• 🔐 Secure Authentication - Google OAuth via NextAuth.js
• 📱 Responsive Design - Optimized for all devices
• 🐞 Debug Tools - Real-time debugging information

🔧 Tech Stack

Frontend	Backend	APIs	Authentication
Next.js	Node.js	Google Calendar	NextAuth.js
React	API Routes	OpenAI Whisper	Google OAuth
Tailwind CSS		Web Speech API
Radix UI

🚀 Live Demo

Try out DORA at: https://dora-urdu-voice-scheduler.vercel.app/

📋 Getting Started

Prerequisites

• Node.js (v16+)
• pnpm package manager
• Google Cloud Project with Calendar API enabled
• OpenAI API Key for Whisper transcription

Installation

1. Clone the repository

   git clone https://github.com/abdullaharif381/dora-a3
   cd dora-a3

2. Install dependencies

   pnpm install

3. Configure environment variables

   Create a .env.local file in the root directory:

   GOOGLE_CLIENT_ID=your-google-client-id
   GOOGLE_CLIENT_SECRET=your-google-client-secret
   OPENAI_API_KEY=your-openai-api-key
   NEXTAUTH_SECRET=your-nextauth-secret
   NEXTAUTH_URL=http://localhost:3000
   

Development

# Start development server
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

Access the application at http://localhost:3000

🔍 Usage

1. Sign in with your Google account
2. Record Voice - Click the "Record" button and speak in Urdu
3. Manage Events - Create, view, update or delete events
4. Review - Check the debug section for processing information

Voice Command Flow

graph LR
    A[Record Voice] --> B[Transcribe with Whisper API]
    B --> C[Process Command]
    C --> D[Create Google Calendar Event]
    D --> E[Confirm to User]

Loading

💡 Core Functionality

• Voice Processing - Records Urdu speech and transcribes it via OpenAI Whisper API
• Natural Language Understanding - Extracts event details from transcribed text
• Calendar Management - Creates, updates, and deletes events in Google Calendar
• Authentication - Secures user data with Google OAuth

👥 Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to your branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please ensure your code follows the project's coding standards and includes tests where applicable.

🗺️ Roadmap

• 🤖 Chatbot Interface - Interactive scheduling experience
• 👥 Multi-User Support - Independent calendar management for teams
• 🔊 Enhanced Voice Recognition - Improved Urdu language processing
• 📱 Mobile App - Native iOS and Android applications
• 🌙 Dark Mode - Enhanced visual experience
• 🌐 Multi-Language Support - Extend beyond Urdu
• 📊 Analytics Dashboard - Insights into scheduled events
• 📴 Offline Support - Function without internet connection
• 🔄 Event Collaboration - Share and collaborate on events

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• Next.js - React framework
• Tailwind CSS - Utility-first CSS framework
• Radix UI - Unstyled, accessible components
• Google Calendar API - Calendar integration
• OpenAI Whisper - Speech recognition
• Web Speech API - Voice recording

Contributors

• Ibtehaj Ali
• Tahmooras Khan
• Kabir ud Din Shahab

---

_{Built with ❤️ by Abdullah Arif}