Aurelio ٹیوٹوریل: نجی AI سے چلنے والی دولت کے انتظام کی ایپ مقامی طور پر چلائیں

اوریلیو کیا ہے؟

اوریلیو ایک خود میزبان دولت کے انتظام اور مالی منصوبہ بندی کی ایپلیکیشن ہے۔ یہ آپ کے اپنے کمپیوٹر پر چلتی ہے، آپ کے مالی ریکارڈ مقامی طور پر محفوظ رکھتی ہے، اور پورٹ فولیو، نقد بہاؤ، اہداف، منصوبوں، گھروں اور قرضوں کے لیے ڈیش بورڈ فراہم کرتی ہے۔

اختیاری AI مشیر آپ کو اپنے ریکارڈز کے بارے میں سوالات پوچھنے، ویب پر تلاش کرنے، اور کارڈز کی صورت میں مجوزہ تبدیلیاں حاصل کرنے دیتا ہے، جنہیں آپ منظور یا مسترد کر سکتے ہیں۔ AI درخواستیں آپ کے اپنے OpenRouter اکاؤنٹ اور API کلید استعمال کرتی ہیں۔

اوریلیو آپ کے کمپیوٹر پر ذاتی استعمال کے لیے تیار کیا گیا ہے۔ آپ کے ریکارڈز مقامی طور پر backend/data.db میں محفوظ ہوتے ہیں۔

اہم خصوصیات

• دولت کا سراغ: بینک، بروکرز، نقد رقم، اور تاریخ کے ساتھ ایسے حالات منظم کریں جو آپ کی ملکیت کی تفصیل بیان کرتے ہیں۔
• پورٹ فولیو کا تجزیہ: مارکیٹ کی قیمتوں کے مطابق پوزیشنز دیکھیں، جن میں لاگت، منافع اور منافعِ حصص شامل ہیں۔
• فنڈ کی اندرونی تفصیل: فنڈ کی ہولڈنگز کا ملک، شعبے، کمپنی اور کرنسی کے لحاظ سے جائزہ لیں۔
• منصوبے، گھر اور قرضے: باقاعدہ سرمایہ کاری، حقیقی اثاثے اور ان کی مالی اعانت کرنے والے قرضوں کا سراغ رکھیں۔
• نقد بہاؤ اور اہداف: آمدنی، اخراجات، بچت کی شرح اور ہر ہدف کے لیے مطلوبہ منافع کا جائزہ لیں۔
• اوریلیو سے پوچھیں: ایسے AI مشیر سے گفتگو کریں جو آپ کے ریکارڈز استعمال کر سکتا ہے، ویب پر تلاش کر سکتا ہے، اور آپ کی منظوری کے لیے تبدیلیاں تجویز کرتا ہے۔
• تجزیہ: ایک تجزیہ کار اور ایک رازدار کے نقطۂ نظر کا موازنہ کریں، جس کے بعد اس بات کا خلاصہ دیا جاتا ہے کہ پہلے کیا جانچنا چاہیے۔

ایپلیکیشن کے بنیادی تصورات کے لیے اوریلیو کیسے سوچتا ہے پڑھیں۔

ضروریات

اوریلیو انسٹال کرنے سے پہلے یقینی بنائیں کہ آپ کے پاس درج ذیل ٹولز موجود ہیں:

• Git
• Node.js 22 یا اس کے بعد کا ورژن
• uv

شامل کردہ اسٹارٹ اپ اسکرپٹ پہلی بار چلنے پر مطلوبہ انحصارات کو پروجیکٹ فولڈر کے اندر انسٹال کر دیتا ہے۔

ڈیمو انسٹال کریں اور آزمائیں

شروع کرنے کا محفوظ ترین طریقہ اوریلیو کے بنائے ہوئے گھرانے کے ساتھ ہے۔ اس سے آپ اپنی مالی معلومات درج کیے بغیر انٹرفیس دریافت کر سکتے ہیں۔

macOS اور Linux

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.sh --demo

Windows PowerShell

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.ps1 -Demo

اگر PowerShell اطلاع دے کہ اسکرپٹس چلانا غیر فعال ہے تو اسکرپٹ کو execution-policy override کے ساتھ چلائیں:

powershell -ExecutionPolicy Bypass -File .\start.ps1 -Demo

پہلی بار اسٹارٹ ہونے کے بعد اوریلیو http://localhost:8000 پر کھلتا ہے۔ ڈیمو گھرانہ ایک الگ فائل میں رکھا جاتا ہے، اس لیے آپ اپنے ڈیٹا کو متاثر کیے بغیر اسے دریافت کر سکتے ہیں۔

پورٹ فولیو اور ریکارڈز دریافت کریں

پورٹ فولیو کا منظر مارکیٹ کی قیمتوں کے مطابق پوزیشنز دکھاتا ہے، ساتھ ہی ان کی لاگت، منافع اور منافعِ حصص بھی دکھاتا ہے۔

اندرونی تفصیل کا منظر اس بارے میں مزید معلومات فراہم کرتا ہے کہ فنڈز میں کیا شامل ہے۔ آپ ملک، شعبے، کمپنی اور کرنسی کے لحاظ سے سرمایہ کاری کا جائزہ لے سکتے ہیں۔

ریکارڈز میں انفرادی اکاؤنٹس کے لیے تاریخ کے ساتھ حالات شامل ہو سکتے ہیں۔ اس سے یہ ظاہر کرنا ممکن ہوتا ہے کہ کسی مخصوص وقت پر آپ کے پاس کیا موجود تھا۔

اپنے ڈیٹا کے ساتھ اوریلیو استعمال کریں

ڈیمو سے اطمینان ہو جانے کے بعد ایپلیکیشن کو روکیں اور اسے ڈیمو آپشن کے بغیر شروع کریں۔

macOS اور Linux

./start.sh

Windows PowerShell

./start.ps1

آپ کے ریکارڈز backend/data.db میں محفوظ ہوتے ہیں۔ جب کسی اپ ڈیٹ سے ڈیٹا بیس کا فارمیٹ تبدیل ہونے کی توقع ہو تو تبدیلی نافذ کرنے سے پہلے اوریلیو ڈیٹا بیس کے ساتھ ہی ایک نقل محفوظ کرتا ہے۔

چونکہ یہ ایپلیکیشن مالی معلومات سنبھالتی ہے، اس لیے اس کمپیوٹر اور فولڈر کی حفاظت کریں جہاں اوریلیو چلتا ہے۔ README مقامی اسٹوریج کی وضاحت کرتا ہے، لیکن یہ ہوسٹڈ ہم وقت کاری یا بیک اپ سروس فراہم نہیں کرتا۔

اختیاری AI مشیر فعال کریں

AI کی فعالیت اختیاری ہے۔ آپ کسی AI فراہم کنندہ کو ترتیب دیے بغیر مقامی مالی انتظام کی خصوصیات استعمال کر سکتے ہیں۔

1. OpenRouter پر اکاؤنٹ بنائیں اور کریڈٹ شامل کریں۔
2. OpenRouter Keys پر API کلید بنائیں۔
3. ریپوزٹری کے روٹ سے backend/.env.example کو backend/.env میں نقل کریں۔
4. backend/.env میں OPENROUTER_API_KEY کی قدر مقرر کریں۔

OPENROUTER_API_KEY=your_openrouter_key

ماحولیاتی فائل تبدیل کرنے کے بعد اوریلیو کو دوبارہ شروع کریں تاکہ ایپلیکیشن نئی ترتیب پڑھ سکے۔

ڈیفالٹ ماڈل Claude Opus 5.5 ہے، اور آپ چیٹ میں کوئی دوسرا ماڈل منتخب کر سکتے ہیں۔ README میں اکتوبر 2026 میں ناپی گئی مثالی لاگتیں درج ہیں: ایک مرحلے میں جواب دیے گئے پہلے سوال کے لیے تقریباً $0.11، ایک مرحلے میں جواب دیے گئے فالو اَپ کے لیے $0.017، ایک ویب سرچ کے ساتھ مشورے کے لیے $0.16، اور تجزیے کے لیے $0.33 سے $0.51۔ اصل لاگت مختلف ہو سکتی ہے، اس لیے اپنا OpenRouter اکاؤنٹ اور منتخب کردہ ماڈل چیک کریں۔

سوالات پوچھیں اور تجویز کردہ تبدیلیوں کا جائزہ لیں

API کلید کی ترتیب مکمل ہونے کے بعد، اپنے ریکارڈز کی بنیاد پر سوالات پوچھنے کے لیے چیٹ استعمال کریں۔ جب کسی درخواست کے لیے بیرونی معلومات درکار ہوں تو Aurelio ویب پر بھی سرچ کر سکتا ہے۔

جب اسسٹنٹ کسی تبدیلی کی تجویز دے، تو اسے نافذ کرنے سے پہلے اس کا جائزہ لیں۔ ایپلی کیشن اس تجویز کو ایک کارڈ کے طور پر پیش کرتی ہے جسے آپ منظور یا مسترد کر سکتے ہیں، بجائے اس کے کہ آپ کے ریکارڈز میں خاموشی سے ترمیم کر دی جائے۔

مالیاتی ڈیٹا کے لیے تصدیق کا یہ مرحلہ خاص طور پر اہم ہے: قبول کرنے سے پہلے تصدیق کریں کہ تجویز کردہ اکاؤنٹ، تاریخ، رقم یا دیگر تفصیلات آپ کے ارادے کے مطابق ہیں۔

ترقی اور ٹیسٹنگ

اگر آپ خود Aurelio پر کام کرنا چاہتے ہیں تو اس منصوبے میں بیک اینڈ اور فرنٹ اینڈ کے لیے الگ الگ ورک فلو شامل ہیں۔

بیک اینڈ ٹیسٹ چلائیں

backend/ ڈائریکٹری سے یہ کمانڈ چلائیں:

uv run pytest

فرنٹ اینڈ ٹیسٹ چلائیں

frontend/ ڈائریکٹری سے یہ کمانڈ چلائیں:

npm test

ہاٹ ری لوڈ فعال کریں

بیک اینڈ ہاٹ ری لوڈ کے لیے backend/ کے اندر یہ کمانڈ چلائیں:

uv run uvicorn app.main:app --port 8000

فرنٹ اینڈ ڈیولپمنٹ سرور کے لیے frontend/ کے اندر یہ کمانڈ چلائیں:

npm run dev

عملی تجاویز

• ڈیمو موڈ سے شروع کریں: ذاتی ریکارڈز درج کرنے سے پہلے --demo یا -Demo استعمال کریں۔
• AI کو اختیاری رکھیں: OpenRouter صرف اسی صورت میں ترتیب دیں جب آپ چیٹ، ویب سے معاونت یافتہ جوابات یا تجزیہ چاہتے ہوں۔
• ہر تجویز کا جائزہ لیں: اپنے ریکارڈز میں تبدیلی کرنے سے پہلے چیٹ کارڈز کو احتیاط سے منظور یا مسترد کریں۔
• ماڈل کی لاگت پر نظر رکھیں: منتخب کردہ ماڈل اور درخواست کی قسم OpenRouter کے استعمال کو متاثر کرتے ہیں۔
• اپنا ڈیٹا بیس محفوظ رکھیں: backend/data.db اور فارمیٹ اپ ڈیٹس کے دوران Aurelio کی بنائی ہوئی نقول کا ریکارڈ رکھیں۔
• استدلال کی رہنما دستاویز استعمال کریں: یہ سمجھنے کے لیے کہ مطلوبہ ورک فلو کیا ہے، منصوبے میں تجزیے کے طریقۂ کار کی وضاحت پڑھیں۔

نتیجہ

Aurelio مقامی مالیاتی ریکارڈ رکھنے کو اختیاری AI معاونت کے ساتھ یکجا کرتا ہے۔ ریپوزٹری کلون کریں، فرضی ڈیمو گھرانہ شروع کریں، پورٹ فولیو اور تفصیلی جائزہ ویوز دیکھیں، پھر اپنے ڈیٹا کے لیے ایپلی کیشن کو ڈیمو موڈ کے بغیر چلائیں۔ اگر آپ گفتگو کے ذریعے رہنمائی چاہتے ہیں تو OpenRouter کلید شامل کریں اور ہر تجویز کردہ تبدیلی کو قبول کرنے سے پہلے اس کا جائزہ لیں۔ Aurelio کو MIT License کے تحت جاری کیا گیا ہے۔