इस प्रोजेक्ट के बारे में

Allos एक स्व-होस्टेड स्वास्थ्य रिकॉर्ड, ट्रैकर और कोचिंग एप्लिकेशन है जो व्यक्तियों, घरानों और देखभालकर्ताओं के लिए निर्दिष्ट है। इसका नाम अलोस्टेसिस से आया है, जो बदलाव के माध्यम से स्थिरता बनाए रखने के शरीर का तरीका है। परियोजना का उद्देश्य व्यक्तिगत स्वास्थ्य सूचना को तीसरे पक्ष की सेवाओं में बिखरे बजाय एक निजी टाइमलाइन में एकत्र करना है। डेटा ऑपरेटर के अपनी SQLite डेटाबेस में संग्रहीत होता है, अधिकांश विश्लेषण बंडल किए गए डेटासेट के खिलाफ स्थानीय रूप से चलते हैं, और AI सुविधाएँ वैकल्पिक हैं। ट्रैकिंग का दायरा ऐप दैनिक स्वास्थ्य (लक्षण, मूड, नींद, राइताल, शरीर माप, पोषण, स्वास्थ्य अभ्यास), प्रशिक्षण (शक्ति, कार्डियो, खेल, रूटीन, लक्ष्य, पुनर्प्राप्ति संदर्भ), चिकित्सा इतिहास (स्थितियाँ, एलर्जी, प्रक्रियाएँ, टीकाकरण, अपॉइंटमेंट, देखभाल योजनाएँ, परिवार इतिहास), प्रयोगशाला और दस्तावेज़ (बायोमार्कर, संदर्भ सीमाएँ, स्कैन, PDF, रिकॉर्ड आयात), और दवा और सप्लीमेंट (शेड्यूल, खुराक इतिहास, रिफिल, अनुपालन, स्थानीय रूप से जाँचे गए इंटरैक्शन चेतावनियाँ) कवर करता है। घराने का समर्थन अलग-अलग प्रोफाइल, देखभालकर्ता पहुंच, केवल-पठन अनुदान और क्रॉस-प्रोफाइल दृश्य शामिल करता है, और प्रत्येक प्रोफाइल के लिए लॉगिन की आवश्यकता नहीं होती। डेटा Health Connect, Strava, Oura, Fitbit निर्यात, Withings, कैलेंडर फ़ीड और MyChart जैसे FHIR/CCD-आधारित आयात के माध्यम से आ सकता है। रमाइंडर्स Telegram, Web Push, Home Assistant या ईमेल के माध्यम से भेजे जा सकते हैं, और सब कुछ JSON, CSV, FHIR के रूप में निर्यात किया जा सकता है या अपलोड फ़ाइल के रूप में अपलोड किया जा सकता है। डिज़ाइन सिद्धांत README पाँच सिद्धांत सूचीबद्ध करता है: डिफ़ॉल्ट रूप से स्थानीय, बाहरी सेवाओं के लिए opted-in; स्वास्थ्य को स्कोरिंग के बजाय स्टीयरिंग के रूप में प्रस्तुत करें, ताकि कच्चे सिग्नल्स दिखाए जाएँ बजाय एक निर्मित स्वस्थ स्कोर के; निष्कर्ष जानकारीपूर्ण हों और स्रोतों का उल्लेख करें बजाय आदेशात्मक; शांत टोन जब तक सुरक्षा महत्वपूर्ण न हो, दवा सुरक्षा रमाइंडर्स अन्य अवलोकनों की तुलना में अधिक सावधानी से संभालें; और उपयोगकर्ता नियंत्रण, जिसका अर्थ है कि मैन्युअल सुधार सिंक के बाद भी टिकते हैं, प्राथमिकताएँ उपयोगकर्ता-स्वामित्व वाली रहती हैं और डेटा निर्यात किया जा सकता है। तैनाती Docker Compose अनुशंसित मार्ग है। यह वेब ऐप plus एक छोटा शेड्यूलर सेवा सूचनाओं और बैकअप के लिए शुरू करता है। ऑपरेटर रिपॉजिटरी को क्लोन करते हैं, .env.example को .env में कॉपी करते हैं, और कम से कम एक एडमिन पासवर्ड और एक एब्सोल्यूट DATA_DIR चेकआउट के बाहर सेट करते हैं (डिफ़ॉल्ट ./data है)। पहला एडमिन पासवर्ड केवल तब लागू होता है जब पहला लॉगिन बनाया जाता है। स्टैक को docker compose up -d --pull always के साथ शुरू किया जाता है और पोर्ट 3000 पर पहुँचा जाता है। अपडेट GitHub Container Registry से प्रकाशित इमेज खींचते हैं; एक विशिष्ट बिल्ड IMAGE चर द्वारा पिನ್ किया जा सकता है। डेटाबेस माइग्रेशन स्टार्टअप पर स्वचालित रूप से चलते हैं, और डेटाबेस को data/backups/pre-migration में पहले कॉपी किया जाता है, जिसके बाद कंटेनर उस कॉपी नहीं बन सकता यदि वह कंटेनर शुरू होने से इनकार करता है। सोर्स से चलाने के लिए Node.js 24 (.nvmrc में पिन्ड) की आवश्यकता होती है, npm और better-sqlite3 के लिए नेटिव बिल्ड पूर्व-अवस्थाएँ; npm ci और npm run dev काफी हैं, SQLite डेटाबेस data/allos.db पर बनाया जाता है। एक सीड कमांड कुछ सप्ताहों के संश्लेषित नमूना डेटा को लोड कर सकती है, जिसे README वास्तविक रिकॉर्ड वाले उदाहरण पर चलाने से चेतावनी देता है। लोग और पहुंच एडमिनिस्ट्रेटर Settings, People & access के अंतर्गत उन लोगों के लिए प्रोफाइल बनाते हैं जिन्हें ट्रैक किया जाता है, लॉगिन बनाते हैं, और चुने गए प्रोफाइल के लिए read/write या read-only पहुंच देने वाले अनुदान देते हैं। एडमिनिस्ट्रेटर सभी प्रोफाइल तक पहुँच सकते हैं, इसलिए उनके वहाँ प्रवेश द्वारा चुने जाते हैं कि किन प्रोफाइल के रमाइंडर्स उन्हें पहुँचें; सूचनाएँ प्रत्येक प्रोफाइल के लिए opted-in हैं। डेटा, बैकअप और गोपनीयता DATA_DIR के अंतर्गत स्थिर अवस्था में allos.db, अपलोड किए गए चिकित्सा फ़ाइल, लॉग और सत्यापित बैकअप plus प्री-माइग्रेशन कॉपी शामिल हैं। बिल्ट-इन नाइटली स्नैपशॉट लाइव डेटाबेस के साथ एक वॉल्यूम साझा करता है, इसलिए README BACKUP_DEST_DIR को दूसरे माउंटेड स्थान के रूप में कॉन्फ़िगर करने और Settings से सत्यापित करने की सलाह देता है। स्नैपशॉट अपलोडेड फ़ाइल शामिल नहीं करते हैं, जिनका ऑफ-वॉल्यूम बैकअप सुविधा अलग से अनुकरण करती है। वैकल्पिक सेवाओं को केवल उस सुविधा के लिए आवश्यक डेटा प्राप्त होता है जो सक्रिय है: एक Anthropic-कम्पेटिबल एंडपॉइंट कॉन्फ़िगर किया जा सकता है (AI_BASE_URL के माध्यम से स्व-होस्टेड सहित), और SMTP लॉगिन आमंत्रण, पासवर्ड रीसेट और opted-in सूचना ईमेल प्रदान करता है जो डिफ़ॉल्ट रूप से सामग्री-मुक्त है ताकि कोई स्वास्थ्य विवरण इनबॉक्स तक न पहुँचे। तकनीक और लाइसेंस स्टैक Next.js 16 App Router और Server Actions के साथ, React 19, TypeScript, better-sqlite3 के माध्यम से SQLite, Tailwind CSS और Recharts, वैकल्पिक Anthropic-कम्पेटिबल AI के साथ है। विकास जाँच में formatting, lint, typecheck, यूनिट टेस्ट, अलग SQLite इंटीग्रेशन टेस्ट, अलग-अलग सीड डेटाबेस के खिलाफ Playwright end-to-end टेस्ट, और एक उत्पादन बिल्ड शामिल है; योगदानकर्ताओं को architecture, data scoping, migration और testing सम्मेलनों के लिए AGENTS.md की ओर इशारा किया जाता है। Allos GNU Affero General Public License v3.0 (AGPL-3.0-only) के तहत लाइसेंस प्राप्त है।