منصوبے کے بارے میں

Civitas ایک اوپن ڈیٹا AI/ML پلیٹ فارم ہے جو امریکی حکومت کے سرکاری ذرائع سے ڈیٹا جمع کر کے سینیٹرز، ایوان نمائندگان کے اراکین، صدور، اور سپریم کورٹ کے ججوں کے لیے متحد شفافیت اسکور کارڈز بناتا ہے۔ اس میں ایک Action Center بھی شامل ہے جو خبروں کے تجزیے سے رجحان ساز شہری مسائل سامنے لاتا ہے، جاری قومی خدشات کو خودکار طور پر قابلِ نگرانی مانیٹرز کے طور پر شناخت کرتا ہے، اور سال بھر کا جائزہ ٹائم لائن بناتا ہے۔ ووٹنگ ریکارڈز، مہم کی مالیات، ایوان کی تقریریں، عدالتی رائے، اور بیان کردہ پالیسیاں embedding-based classification، content-based party alignment، اور deterministic scoring کے ذریعے تجزیہ کی جاتی ہیں — یہ سب Raspberry Pi 5 پر مقامی طور پر چلتا ہے، کلاؤڈ AI سروسز کو کوئی بیرونی API کال نہیں کی جاتی۔ ## Architecture یہ نظام ایک راتانہ بیچ پائپ لائن کے گرد بنایا گیا ہے جو متعدد حکومتی APIs (Congress.gov، FEC، GovInfo، Senate.gov، Oyez، BLS/BEA، وغیرہ) سے ڈیٹا حاصل کرتا ہے، اسے تبدیل کرتا ہے، embeddings اور deterministic scoring کے ذریعے تجزیہ کرتا ہے، اور نتائج کو SQLite ڈیٹا بیسز میں محفوظ کرتا ہے۔ ایک FastAPI بیک اینڈ ڈیٹا کو Next.js فرنٹ اینڈ تک پہنچاتا ہے۔ LLM (LFM2.5-1.2B-Instruct) قدرتی زبان کی ترکیب درکار کاموں کے لیے llama.cpp کے ذریعے مقامی طور پر چلتا ہے، جیسے Action Center کے مسائل کی تیاری اور جج پروفائل خلاصے۔ ## Key Features - **Transparency Scorecards**: ووٹنگ ریکارڈز، مہم کی مالیات، ایوان کی تقریروں، اور دیگر ڈیٹا کی بنیاد پر سینیٹرز، نمائندگان، صدور، اور ججوں کے اسکور۔ - **Action Center**: خبروں کے تجزیے سے رجحان ساز شہری مسائل سامنے لاتا ہے، قومی خدشات کو خودکار طور پر قابلِ نگرانی مانیٹرز کے طور پر شناخت کرتا ہے، اور سال بھر کا جائزہ ٹائم لائن بناتا ہے۔ - **Hybrid Search**: Explore انڈیکس embedding-based semantic search کو FTS5 keyword search اور citation-graph PageRank کے ساتھ ملاتا ہے۔ - **Fully Local**: تمام ماڈلز، ڈیٹا بیسز، اور سروسز ڈیوائس پر چلتے ہیں (Raspberry Pi 5، 16GB RAM)۔ کوئی کلاؤڈ GPU نہیں، کوئی تھرڈ پارٹی AI APIs نہیں۔ - **Deterministic Scoring**: Phase 3 کا تجزیہ مکمل طور پر deterministic ہے، کوئی LLM کال نہیں، embedding-based classification اور kNN استعمال کرتا ہے۔ - **Caching Architecture**: تین آزاد کیشنگ سسٹمز (ApiCache، AnalysisCache، LearnedClassification) ری پلے، کارکردگی، اور آڈٹ ٹریلز کے لیے۔ ## Pipeline Phases راتانہ پائپ لائن ہر سینیٹر اور ایوان نمائندگان کے رکن کو سات مراحل سے گزارتی ہے: FETCH، TRANSFORM، ANALYZE، EXPLORE، JUSTICES، PRESIDENTS، اور FINALIZE۔ یہ پانچ پائپ لائنوں کی زنجیر کے طور پر چلتی ہے (Senate، Supplementary، House، Stock trades، Election) جہاں ہر کڑی صرف اسی صورت شروع ہوتی ہے جب پچھلی مکمل ہو چکی ہو۔ ## Classification Strategy درجہ بند حکمت عملی کے ذریعے درجہ بندی کے فیصلے کیے جاتے ہیں: exact matches، sentence-transformer embeddings، kNN، اور آخر میں قدرتی زبان کی ترکیب درکار کاموں کے لیے LLM۔ نظام وضاحت اور دوبارہ پیداواری صلاحیت پر زور دیتا ہے، تمام ماڈل وزن پن کیے گئے ہیں۔ ## Hardware Raspberry Pi 5 (16 GB RAM)، NVMe SSD۔ تمام ماڈلز، ڈیٹا بیسز، اور سروسز ڈیوائس پر چلتے ہیں۔