๐Ÿค Wasta AI โ€” Kuwait Government Services Automation Agent

You don't need wasta anymore. You have the agent.

License: MIT Python Playwright Languages GCC By AgenThink


Overview

Kuwait's government services โ€” company registration, residence permits, Civil ID renewal โ€” are among the most time-consuming bureaucratic processes in the Gulf. PRO agents charge KD 50โ€“500 per transaction to navigate processes that should take hours, not weeks.

Wasta AI is an open-source browser automation agent that navigates Kuwait government portals, fills forms, uploads documents, books appointments, and generates complete submission packages โ€” automatically.

No government API required. No middleman needed. Three languages. Three agents. One platform.


โœจ Three Automation Agents

1. ๐Ÿชช Iqama Renewal Agent

Automates Kuwait residence permit renewal via PACI portal.

  • Validates all user data before starting
  • Navigates paci.gov.kw automatically
  • Fills and submits renewal form
  • Books earliest available appointment
  • Generates complete document checklist
  • Includes Indian Embassy emergency contacts for Malayalam community

2. ๐Ÿชช Civil ID Renewal Agent

Automates Kuwait Civil ID renewal โ€” fastest path via PACI App or portal.

  • Supports: standard renewal, replacement (lost/damaged), correction
  • Online and app-guided modes
  • Home delivery option (KD 2 extra)
  • 3โ€“7 business day processing

3. ๐Ÿข Company Registration Agent

Full Kuwait company registration automation via MOCI eServices.

  • Supports: WLL, SPC, KSCC, Branch of Foreign Company
  • Step 1: Name reservation (MOCI portal automation)
  • Step 2: Articles of Association generation (ready to notarize)
  • Step 3: Commercial registration package with exact documents
  • Step 4: Chamber of Commerce requirements
  • Validates shareholder structure and expat ownership rules

๐Ÿš€ Quickstart

Installation

git clone https://github.com/agenthinkai/wasta-ai.git
cd wasta-ai

pip install -r requirements.txt
playwright install chromium

Run the Demo

python wasta_ai.py

This runs all three agents with sample data and shows you exactly what each produces.

Iqama Renewal

import asyncio
from wasta_ai import WastaAI

wasta = WastaAI()

user_data = {
    "civil_id": "123456789012",
    "passport_number": "N1234567",
    "passport_expiry": "2027-06-15",
    "full_name_english": "Raju Varghese",
    "full_name_arabic": "ุฑุงุฌูˆ ูุงุฑุบูŠุฒ",
    "nationality": "Indian",
    "date_of_birth": "1985-03-20",
    "employer_name": "Al Salam Trading WLL",
    "employer_civil_id": "123456789013",
    "mobile_number": "+96590000001",
    "email": "raju@email.com",
    "documents": {
        "passport": "docs/passport.pdf",
        "current_iqama": "docs/iqama.pdf",
        "medical_certificate": "docs/medical.pdf",
        "employer_letter": "docs/employer_letter.pdf",
        "passport_photo": "docs/photo.jpg",
    }
}

result = asyncio.run(wasta.run("iqama_renewal", user_data))
print(result)

Civil ID Renewal

civil_id_data = {
    "civil_id": "123456789012",
    "full_name_english": "Raju Varghese",
    "mobile_number": "+96590000001",
    "email": "raju@email.com",
    "renewal_type": "renewal",       # renewal / replacement / correction
    "delivery": "home",              # home / pickup
    "delivery_address": "Block 5, Street 10, Salmiya, Kuwait",
}

result = asyncio.run(wasta.run("civil_id_renewal", civil_id_data))

Company Registration

company_data = {
    "company_type": "WLL",
    "name_arabic_1": "ุดุฑูƒุฉ ุงู„ู†ุฎุจุฉ ู„ู„ุชู‚ู†ูŠุฉ",
    "name_arabic_2": "ุดุฑูƒุฉ ุงู„ุชู‚ู†ูŠุฉ ุงู„ู…ุชู‚ุฏู…ุฉ",
    "name_arabic_3": "ุดุฑูƒุฉ ุงู„ุงุจุชูƒุงุฑ ุงู„ุฑู‚ู…ูŠ",
    "business_activity": "Information Technology, AI Solutions",
    "share_capital": "5000",
    "registered_address": "Block 1, Sharq, Kuwait City",
    "contact_mobile": "+96590000002",
    "contact_email": "info@company.kw",
    "shareholders": [
        {
            "full_name_english": "Ahmed Al Kuwait",
            "full_name_arabic": "ุฃุญู…ุฏ ุงู„ูƒูˆูŠุชูŠ",
            "civil_id": "281030112345",
            "nationality": "Kuwaiti",
            "share_percentage": "51",
        },
        {
            "full_name_english": "John Smith",
            "full_name_arabic": "ุฌูˆู† ุณู…ูŠุซ",
            "civil_id": "N1234567",
            "nationality": "British",
            "share_percentage": "49",
        },
    ],
}

result = asyncio.run(wasta.run("company_registration", company_data))

๐Ÿ—๏ธ How It Works

Browser Automation, Not API Access

Kuwait government portals are public websites. Wasta AI uses Playwright to operate them like a human โ€” navigating pages, filling forms, uploading documents, and extracting confirmations โ€” but faster and without errors.

User provides data
      โ†“
Agent validates (catches errors before wasting time)
      โ†“
Playwright opens government portal
      โ†“
Agent fills all form fields automatically
      โ†“
Agent uploads documents
      โ†“
Agent books appointment
      โ†“
Agent extracts confirmation number
      โ†“
Complete package returned to user

Graceful Degradation

If the portal is down, has changed its structure, or Playwright is unavailable, agents automatically fall back to a detailed step-by-step guided mode โ€” so users always get actionable output.


๐ŸŒ Three Languages

Language Audience Status
English Expat professionals, investors โœ… Live
Arabic (Gulf dialect) Kuwaiti nationals, GCC entrepreneurs โœ… Live
Malayalam Kerala community (700,000+ in Kuwait) โœ… Live

๐ŸŒ Web Interface

A full web interface is available in wasta-ai-arabic.html, wasta-ai.html, and wasta-ai-malayalam.html โ€” standalone HTML files that can be deployed anywhere without a backend.


๐Ÿ“Š Estimated Savings vs PRO Agent

Service PRO Agent Cost Wasta AI Cost Time Saved
Iqama Renewal KD 50โ€“150 Free 3โ€“5 hours
Civil ID Renewal KD 20โ€“50 Free 2โ€“3 hours
Company Registration KD 300โ€“600 Free 2โ€“3 weeks

๐Ÿค Contributing

This project serves Kuwait's 700,000+ Malayalam-speaking community, GCC entrepreneurs, and expat professionals who navigate complex government processes daily.

Priority contributions:

  • Saudi Arabia MISA company registration agent
  • UAE MOHRE work permit agent
  • Bahrain LMRA automation
  • Arabic OCR for document validation
  • WhatsApp bot integration
git checkout -b feature/saudi-company-registration
# See CONTRIBUTING.md

โš ๏ธ Important Notes

  • This tool automates public government portals โ€” it does not hack or bypass any system
  • Always verify submission confirmations directly on official portals
  • Government portal structures change โ€” report issues via GitHub Issues
  • For complex cases, consult a licensed PRO agent or lawyer

๐Ÿ“„ License

MIT License โ€” free to use, modify, and distribute.


๐Ÿ‡ฐ๐Ÿ‡ผ Built in Kuwait. For Kuwait. Open to the Gulf.

"700,000 Malayalis in Kuwait. Thousands of entrepreneurs registering companies. All navigating the same processes, paying the same middlemen. Wasta AI ends that."

AgenThink | ADGM Registered | Kuwait City agenthinkai.com | GitHub

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. ๐Ÿ™‹ Ask for provider support