- ๐ค Wasta AI โ Kuwait Government Services Automation Agent
๐ค Wasta AI โ Kuwait Government Services Automation Agent
You don't need wasta anymore. You have the agent.
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