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

ہاؤزر ایک خود میزبان، کمرہ پر مبنی ہوم اسسٹنٹ ڈیش بورڈ ہے جو وال پینلز، ٹیبلٹس اور فونز کے لیے ڈیزائن کیا گیا ہے۔ یہ خاندان کے اراکین کے لیے پرسکون روزمرہ انٹرفیس کے طور پر خود کو پیش کرتا ہے، جبکہ ہوم اسسٹنٹ آپریٹر اور ایڈمن انٹرفیس رہتا ہے۔ یہ پروجیکٹ اپنے پبلک ٹیکنیکل بیٹا (AGPL لائسنس یافتہ شوقیہ پروجیکٹ) کے پہلے مرحلے میں ہے اور اسے Docker Compose کے ذریعے یا ہوم اسسٹنٹ ایپ کے طور پر انسٹال کیا جا سکتا ہے۔ اہم خصوصیات میں شامل ہیں: - **کمرے**: موسمیات، روشنیاں، منظر نامے، موجودگی اور کھڑکی کی حالت، ہر ایک تین روشنی کی حالتوں میں ظاہر ہوتا ہے جو اصل روشنیوں کی پیروی کرتا ہے۔ - **کمرے کی تصاویر**: ایک وزرڈ فون کی تصویر سے حسب ضرورت عکاسی تیار کرتا ہے، OpenAI (ادائیگی شدہ، اختیاری)، Cloudflare Workers AI (مفت ٹائر)، یا دستی ڈرائنگ کا استعمال کرتے ہوئے۔ - **ہوم اسسٹنٹ انٹیگریشن**: آفیشل کلائنٹ کے ذریعے ویب ساکٹ، ریکونسائلیشن کے ساتھ پرامن کمانڈز، دوبارہ کنکشن ہینڈلنگ، اور `sun.sun` سے دن/رات تھیمنگ۔ - **میڈیا**: Jellyfin لائبریری، شیلفز، تفصیلی منظر، HLS پلے بیک ریزیوم کے ساتھ؛ HA میڈیا پلیئرز کے ذریعے کمرے کی آڈیو۔ - **توانائی**: حقیقی پاور سینسرز سے لائیو لوڈ اور روزانہ کھپت، ایماندار خالی حالات کے ساتھ۔ - **روزمرہ**: کیلنڈر، نوٹس، یاد دہانیاں، شاپنگ لسٹ، لانڈری کی اطلاعات۔ - **دستاویزات**: PIN کے ذریعے محفوظ Paperless-ngx تلاش، پیش نظارہ، ڈاؤن لوڈ اور اختیاری ساتھی سرور کے ذریعے درآمد۔ - **ڈیوائسز**: UI کے اندر سے انٹیٹیٹیز شامل کریں، چھپائیں، نام تبدیل کریں، کمرے میں تفویض کریں اور دوبارہ ترتیب دیں۔ - **ترمیم اور استعمال کے طریقے**: ایک سوئچ کنفیگریشن کو آپریشن سے الگ کرتا ہے؛ استعمال کا طریقہ کنفیگریشن کے دروازے بند کرتا ہے، اختیاری طور پر PIN کے پیچھے آئیڈل ٹائم آؤٹ کے ساتھ۔ - **اسٹینڈ بائی**: گھڑی، ہفتے کی پٹی، نوٹس اور شاپنگ لسٹ کے ساتھ پرسکون لاک اسکرین؛ اختیاری طور پر OpenStreetMap ڈیٹا سے رینڈر کردہ آپ کے اپنے شہر کی ہلکی سڑک کا نقشہ۔ - **دو شیل**: لینڈ سکیپ وال پینل اور ایک ہاتھ سے چلنے والا فون لے آؤٹ جو ایک ہی ڈیزائن سسٹم کا اشتراک کرتا ہے۔ - **ہوٹل موڈ**: چھٹی کے اپارٹمنٹس کے لیے اختیاری مہمان سطح، ہوم اسسٹنٹ کیلنڈر سے قیام، ڈیفالٹ ڈینی ڈیوائس ریلیز، PIN کے ذریعے محفوظ ایڈمن سیشن اور مہمان چیک آؤٹ۔ آرکیٹیکچر: ایپ Svelte 5 + Vite ہے جس میں UI اور بیک اینڈز کے درمیان چار پرتوں والا اڈاپٹر ہے (انٹیٹیٹی اسٹور، پینڈنگ انٹینٹس اوورلے، کمانڈ کیو، بدلنے کے قابل بیک اینڈ)۔ یہ ہوم اسسٹنٹ کے لیے دو ٹرانسپورٹ سپورٹ کرتا ہے: ہوم اسسٹنٹ ایپ کے طور پر (سوپروائزر کے ذریعے سرور صرف کنکشن) یا Docker Compose کے ساتھ (براؤزر براہ راست کنکشن کرتا ہے)۔ سرور میں توثیق شدہ گھر کی ترتیب، کمرے کی تصویر اسٹور، اسٹینڈ بائی نقشہ رینڈرر، مرکزی طور پر محفوظ کردہ یاد دہانیاں، اختیاری Notion شاپنگ سورس اور PIN کے ذریعے محفوظ Paperless-ngx پلگین ہوتا ہے۔ انٹیگریشن کریڈینشل سرور کی طرف رہتے ہیں۔ انسٹالیشن: دو معاون راستے — ہوم اسسٹنٹ ایپ کے طور پر (HA OS/سوپروائزر کے لیے) یا Docker Compose کے ساتھ (HA کنٹینر، پلین ڈوکر ہوسٹس، NAS کے لیے)۔ دونوں ایک گائیڈڈ سیٹ اپ وزرڈ میں ختم ہوتے ہیں جس میں زبان کا انتخاب، ہوم اسسٹنٹ کنکشن، ایریا ڈسکوری، کمرے کا جائزہ، Jellyfin کو فعال کرنا، اور ایٹمک کنفیگریشن ایکٹیویشن شامل ہیں۔ ریلیز امیج `ghcr.io/ralleur/hauser:v0.37.2` (موجودہ) ہے۔ ایک جامع ڈیمو حقیقی انٹرفیس کو نقلی ڈیوائسز کے خلاف چلاتا ہے بغیر کسی وزیٹر کے HA سے کنکشن کیے۔ دستاویزات میں ویکی، ڈیزائن سسٹم دستاویزات، انٹریکشن کنٹریکٹ، پرفارمنس بجٹ، انسٹالیشن کنٹریکٹ، کنفیگریشن ریفرنس، اور ڈیو پائلٹ گائیڈ شامل ہیں۔ یہ پروجیکٹ پرفارمنس بجٹ (16 ms ٹچ سے فیڈ بیک کے نیچے، صرف ٹرانسفارم/اوپیسٹی) پر زور دیتا ہے، ریکونسائلیشن کے ساتھ پرامن UI، اور تمام سطحوں پر متحد ڈیزائن سسٹم۔