Install dependencies

🏠 Overview ✨ Features 🎥 Demo 🛠️ Tech 🚀 Start 📦 Deploy

🌟 Overview

🎯 What is this?

An intelligent legal assistant built with cutting-edge AI technology to help Pakistani citizens understand their court cases better. Powered by Google Gemini 2.0, this system analyzes case details and provides:

📊 Outcome Predictions based on Pakistani law
💰 Cost Estimations in PKR
⏱️ Timeline Forecasts for case resolution
⚖️ Risk Assessment with confidence scores
🎙️ Voice Input in native Urdu language

Mission: Democratize legal intelligence for Pakistani citizens using AI technology.

Impact: Making justice system more accessible and transparent for everyone.

✨ Features

🎙️ Voice Assistant

Native Urdu Speech

Authentic Pakistani accent (Kore voice)
Real-time speech recognition
10-question guided interview
Auto case detail extraction

🤖 AI Analysis

Gemini 2.0 Powered

Advanced language model
Pakistani law precedents
Risk & confidence scoring
Multi-factor evaluation

🌐 Bilingual

English + Urdu

Real-time translation
Proper Urdu script (اردو)
Seamless language switching
Native font rendering

⚖️ Predictions

Smart Outcomes

Win/Lose probability
Settlement likelihood
Case urgency level
Evidence strength analysis

💰 Cost Estimates

Realistic PKR Forecasts

Court fees breakdown
Lawyer charges estimate
Total cost projection
Timeline-based calculation

🔐 Privacy

Secure & Private

No data storage
Client-side processing
Secure API calls
Your data, your control

🛠️ Tech Stack

Frontend Excellence

Next.js 16
_{App Router + Turbopack}

TypeScript 5
_{Type Safety}

Tailwind CSS 4
_{Modern Styling}

React 19
_{UI Library}

AI & Voice Technology

Gemini 2.0 Flash
_{AI Analysis Engine}

Gemini Live API
_{Kore Voice (Urdu)}

WebSocket + Web Audio
_{Real-time Communication}

Deployment & Tools

Vercel
_{Serverless Deploy}

Git
_{Version Control}

ESLint
_{Code Quality}

npm
_{Package Manager}

🚀 Getting Started

📋 Prerequisites

✅ Node.js 18+ (Download from nodejs.org)
✅ npm or yarn package manager
✅ Google Gemini API Key (Free at aistudio.google.com/app/apikey)
✅ Git installed

⚡ Quick Installation

1️⃣ Clone Repository

git clone https://github.com/Ahmed-KHI/pakistan-court-case-predictor.git
cd pakistan-court-case-predictor

2️⃣ Install Dependencies

npm install

3️⃣ Setup Environment

# Copy .env.example to .env.local
cp .env.example .env.local

# Edit .env.local and add your Gemini API key
NEXT_PUBLIC_GEMINI_API_KEY=your_api_key_here

4️⃣ Run Development Server

npm run dev

5️⃣ Open Browser

🌐 http://localhost:3000

🏗️ Build for Production

# Create optimized production build
npm run build

# Start production server
npm start

Install dependencies

npm install

Setup environment

cp .env.example .env.local

Add your Gemini API key to .env.local

Run development server

npm run dev


Open [http://localhost:3000](http://localhost:3000) in your browser.



---

## 🎯 Usage Guide

<table>
<tr>
<td width="50%">

### 🎙️ Voice Mode (Urdu)

1. **Click** "Start Voice Conversation" 🎙️
2. **Grant** microphone permission
3. **Hear** greeting in Urdu: "السلام علیکم"
4. **Answer** 10 questions naturally:
   - آپ کا نام؟ (Your name?)
   - عمر؟ (Age?)
   - کیس کی قسم؟ (Case type?)
   - تفصیل؟ (Description?)
   - And more...
5. **Receive** instant AI prediction

**Benefits:**
- ✅ Natural conversation flow
- ✅ Authentic Pakistani accent
- ✅ No typing required
- ✅ Perfect for illiterate users

</td>
<td width="50%">

### ⌨️ Manual Mode (Text)

1. **Fill** case details form:
   - Name, Age, Location
   - Case Type (Criminal/Civil/Property)
   - Description, Evidence
   - Financial Status
2. **Click** "Analyze Case" 📊
3. **View** comprehensive results:
   - Outcome prediction
   - Cost estimation
   - Timeline forecast
   - Risk assessment
4. **Toggle** Urdu translation 🌐

**Benefits:**
- ✅ Detailed input control
- ✅ Review before submission
- ✅ Edit anytime
- ✅ Bilingual support

</td>
</tr>
</table>

---

## 🛠️ Tech Stack

| Category | Technologies |
|----------|-------------|
| **Framework** | Next.js 16, React 19, TypeScript 5 |
| **Styling** | Tailwind CSS 4 |
| **AI/ML** | Google Gemini 2.0 Flash Exp |
| **Voice** | Gemini Live WebSocket API (Kore voice) |
| **Speech** | Web Speech API (ur-PK) |
| **Deployment** | Vercel |

---

## 🌐 Deployment

### Deploy to Vercel

<div align="center">

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/Ahmed-KHI/pakistan-court-case-predictor&env=NEXT_PUBLIC_GEMINI_API_KEY)

</div>

**Manual Steps:**
1. Push code to GitHub
2. Import project in [Vercel](https://vercel.com/new)
3. Add environment variable: `NEXT_PUBLIC_GEMINI_API_KEY`
4. Deploy 🚀

### Build for Production

```bash
npm run build
npm start

📁 Project Structure

pakistan-court-case-predictor/
│
├── 📂 app/
│   ├── 📂 api/
│   │   ├── 📄 predict/route.ts      # AI case analysis endpoint
│   │   ├── 📄 translate/route.ts    # Urdu translation endpoint
│   │   └── 📄 voice/route.ts        # Voice processing endpoint
│   ├── 📄 layout.tsx                # Root layout with metadata
│   ├── 📄 page.tsx                  # Home page component
│   └── 📄 globals.css               # Global styles
│
├── 📂 components/
│   ├── 📄 ConversationalVoice.tsx   # Voice assistant with Gemini Live
│   ├── 📄 PredictionDisplay.tsx     # AI prediction results UI
│   └── 📂 ui/
│       ├── 📄 card.tsx              # Card components
│       ├── 📄 button.tsx            # Button components
│       └── 📄 badge.tsx             # Badge components
│
├── 📂 lib/
│   ├── 📄 gemini.ts                 # Gemini API client
│   ├── 📄 utils.ts                  # Utility functions
│   └── 📂 legal-data/
│       └── 📄 pakistan-laws.ts      # Pakistani law database
│
├── 📂 docs/
│   └── 📄 index.html                # GitHub Pages site
│
├── 📄 .env.local                    # Environment variables (create this)
├── 📄 .env.example                  # Environment template
├── 📄 vercel.json                   # Vercel deployment config
├── 📄 README.md                     # This file
└── 📄 LICENSE                       # MIT License

🤝 Contributing

We Welcome Contributions! 🌟

How to Contribute:

🍴 Fork the repository
🌿 Create feature branch: git checkout -b feature/AmazingFeature
💾 Commit changes: git commit -m 'Add: AmazingFeature'
📤 Push to branch: git push origin feature/AmazingFeature
🔃 Open Pull Request

Contribution Ideas:

🐛 Bug fixes and improvements
✨ New features (e.g., more case types, additional languages)
📚 Documentation improvements
🎨 UI/UX enhancements
🧪 Test coverage

� License

This project is free and open-source software licensed under the MIT License.
See the LICENSE file for full details.

👨‍💻 Developer

Muhammad Ahmed

Full Stack Developer | AI Enthusiast | Pakistan 🇵🇰

🙏 Acknowledgments

Special Thanks To:

🏛️ Governor House Karachi IT Initiative
For providing the platform and inspiration

🤖 Google Gemini Team
For the powerful AI technology

🇵🇰 Pakistan Tech Community
For continuous support and feedback

⚖️ Legal Experts
For guidance on Pakistani law implementation

📊 Repository Stats

🎯 Roadmap

⚠️ Disclaimer

Important: This tool provides AI-generated predictions for educational purposes only. It should NOT be considered as professional legal advice. Always consult with a qualified lawyer for actual legal matters. The predictions are based on AI analysis and may not reflect actual court outcomes.

💚 Support This Project

If you find this project helpful, please consider:

⭐ Starring this repository
🍴 Forking to contribute
🐛 Reporting issues
📢 Sharing with others
☕ Supporting development

Muhammad Ahmed (Ahmed-KHI)

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
app		app
components		components
docs		docs
lib		lib
public		public
types		types
.gitignore		.gitignore
DEPLOYMENT.md		DEPLOYMENT.md
LICENSE		LICENSE
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vercel.json		vercel.json

License

Ahmed-KHI/pakistan-court-case-predictor

Folders and files

Latest commit

History

Repository files navigation

🌟 Overview

🎯 What is this?

✨ Features

🎙️ Voice Assistant

🤖 AI Analysis

🌐 Bilingual

⚖️ Predictions

💰 Cost Estimates

🔐 Privacy

🛠️ Tech Stack

Frontend Excellence

AI & Voice Technology

Deployment & Tools

🚀 Getting Started

1️⃣ Clone Repository

2️⃣ Install Dependencies

3️⃣ Setup Environment

4️⃣ Run Development Server

5️⃣ Open Browser

Install dependencies

Setup environment

Add your Gemini API key to .env.local

Run development server

📁 Project Structure

🤝 Contributing

We Welcome Contributions! 🌟

� License

👨‍💻 Developer

Muhammad Ahmed

🙏 Acknowledgments

📊 Repository Stats

🎯 Roadmap

⚠️ Disclaimer

💚 Support This Project

Made in Pakistan 🇵🇰 | Powered by AI 🤖 | Built for Justice ⚖️

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages