شرح Aurelio: شغّل تطبيق خاص لتدبير الثروة بالذكاء الاصطناعي محلياً

شنو هو Aurelio؟

Aurelio هو تطبيق مستضاف عندك لتدبير الثروة والتخطيط المالي. كيخدم فالحاسوب ديالك، كيخلي السجلات المالية ديالك محفوظة محلياً، وكيعطيك لوحات قيادة للمحافظ، والتدفقات النقدية، والأهداف، والخطط، والمنازل، والديون.

المستشار الاختياري بالذكاء الاصطناعي كيخليك تطرح أسئلة على السجلات ديالك، وتقلب فالويب، وتوصل بتغييرات مقترحة على شكل بطاقات تقدر توافق عليها ولا ترفضها. طلبات الذكاء الاصطناعي كتستعمل حسابك ومفتاح API ديالك فـ OpenRouter.

Aurelio مصمم للاستعمال الشخصي فالحاسوب ديالك. السجلات ديالك كتتخزن محلياً فـ backend/data.db.

المزايا الرئيسية

• تتبع الثروة: دبّر البنوك، والوسطاء، والسيولة، والوضعيات المؤرخة اللي كتوصف شنو كتملك.
• تحليل المحفظة: شوف المراكز اللي متسعّرة حسب السوق، بما فيها التكلفة، والأرباح، والأرباح الموزعة.
• تحليل مكونات الصناديق: فحص ممتلكات الصناديق حسب البلد، والقطاع، والشركة، والعملة.
• الخطط، والمنازل، والديون: تتبع الاستثمارات المتكررة، والأصول الحقيقية، والقروض اللي كتمولها.
• التدفقات النقدية والأهداف: راجع المداخيل، والمصاريف، ونسبة الادخار، والعائد اللي كيحتاجو كل هدف.
• سول Aurelio: دردش مع مستشار بالذكاء الاصطناعي كيستعمل السجلات ديالك، ويقدر يقلب فالويب، وكيقترح تغييرات باش توافق عليها.
• التحليل: قارن بين وجهة نظر محلل ووجهة نظر شخص مقرّب، ومن بعد كتحصل على خلاصة ديال شنو خاصك تفحص أولاً.

باش تعرف المفاهيم اللي ورا التطبيق، قرا كيفاش كيفكّر Aurelio.

المتطلبات

قبل ما تثبّت Aurelio، تأكد باللي عندك الأدوات التالية:

• Git
• Node.js 22 ولا أحدث
• uv

سكريبت التشغيل المرفق كيثبّت التبعيات اللي محتاجها داخل مجلد المشروع فالتشغيل الأول.

ثبّت وجرب النسخة التجريبية

أحسن طريقة باش تبدا هي تستعمل الأسرة الوهمية ديال Aurelio. هاد الشي كيخليك تستكشف الواجهة بلا ما تدخل المعلومات المالية ديالك.

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 باللي تشغيل السكريبتات معطّل، شغّل السكريبت مع تجاوز سياسة التنفيذ:

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

من بعد التشغيل الأول، Aurelio كيفتح فـ http://localhost:8000. الأسرة التجريبية محفوظة فملف مستقل، وبهذا تقدر تستكشفها بلا ما تأثر على البيانات ديالك.

استكشف المحفظة والسجلات

عرض المحفظة كيبين المراكز المتسعّرة حسب السوق، مع التكلفة، والأرباح، والأرباح الموزعة ديالها.

عرض مكونات الصناديق كيعطي تفاصيل أكثر على شنو كتمتلك الصناديق. تقدر تفحص الانكشاف حسب البلد، والقطاع، والشركة، والعملة.

السجلات تقدر تتضمن وضعيات مؤرخة للحسابات الفردية. هاد الشي كيخليك تمثل شنو كنت كتملك فواحد الوقت محدد.

استعمل Aurelio بالبيانات ديالك

منين تولّي مرتاح مع النسخة التجريبية، وقف التطبيق وشغّلو بلا خيار النسخة التجريبية.

macOS وLinux

./start.sh

Windows PowerShell

./start.ps1

السجلات ديالك كتتخزن فـ backend/data.db. منين كيكون متوقع تحديث يبدّل صيغة قاعدة البيانات، Aurelio كيحفظ نسخة حدّ قاعدة البيانات قبل ما يطبّق التغيير.

حيت هاد التطبيق كيتعامل مع معلومات مالية، حمي الحاسوب والمجلد اللي كيخدم فيه Aurelio. ملف README كيوصف التخزين المحلي، ولكن ما كيوفرش خدمة مزامنة مستضافة ولا خدمة نسخ احتياطي.

فعّل المستشار الاختياري بالذكاء الاصطناعي

وظائف الذكاء الاصطناعي اختيارية. تقدر تستعمل مزايا التدبير المالي المحلي بلا ما تهيّأ مزود ديال الذكاء الاصطناعي.

1. صايب حساب فـ OpenRouter وزيد فيه الرصيد.
2. صايب مفتاح API فـ مفاتيح OpenRouter.
3. من جذر المستودع، نسخ backend/.env.example إلى backend/.env.
4. عيّن قيمة OPENROUTER_API_KEY فـ backend/.env.

OPENROUTER_API_KEY=your_openrouter_key

عاود شغّل Aurelio من بعد ما تبدّل ملف البيئة باش يقدر التطبيق يقرا الإعدادات الجديدة.

الموديل الافتراضي هو 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 قبل ما تدخل السجلات الشخصية ديالك.
• خلي الذكاء الاصطناعي اختياري: هيّأ OpenRouter غير إلا بغيتي الشات، أو الأجوبة بمساعدة الويب، أو التحليل.
• راجع كل اقتراح: أكد ولا ارفض بطاقات الشات بعناية قبل ما تبدل السجلات ديالك.
• راقب تكاليف الموديل: الموديل المختار ونوع الطلب كيأثرو على الاستعمال ديال OpenRouter.
• حافظ على قاعدة البيانات ديالك: تتبّع backend/data.db والنسخ اللي كينشئها Aurelio أثناء تحديثات الصيغة.
• استعمل دليل التفكير: قرا شرح المشروع لكيفاش كيخدم التحليل باش تفهم طريقة العمل المقصودة.

الخلاصة

Aurelio كيجمع بين حفظ السجلات المالية محلياً والمساعدة الاختيارية بالذكاء الاصطناعي. كلون المستودع، شغّل الأسرة التجريبية المخترعة، تفقد واجهات المحفظة والعرض الشامل، ومن بعد شغّل التطبيق بلا وضعية العرض على البيانات ديالك. إلى بغيتي إرشاد حواري، زِد مفتاح OpenRouter وراجع كل تغيير مقترح قبل ما تقبلو. Aurelio منشور برخصة MIT.