chore: establish Sovereign AI reference

2026-09-29 22:38:37 +03:00
commit ce1b22f100
147 changed files with 7394 additions and 0 deletions
@@ -0,0 +1,24 @@
+# Sovereign AI Client
+
+واجهة Flutter عربية متصلة بواجهة SovereignAI المحلية.
+
+## تشغيل الويب على جهاز التطوير
+
+1. شغّل Ollama والنموذج المحلي.
+2. شغّل FastAPI من المجلد الرئيسي للمشروع عبر `start-api.ps1`.
+3. من هذا المجلد شغّل:
+
+```powershell
+flutter pub get
+flutter run -d web-server --web-hostname 127.0.0.1 --web-port 5300
+```
+
+4. افتح الرابط الذي يطبعه Flutter، غالبًا `http://127.0.0.1:5300`.
+
+بعد بناء نسخة الويب للإنتاج، يمكن تشغيلها بخادم محلي عبر `.\start-web.ps1` وفتح `http://127.0.0.1:5301`.
+
+عنوان الـAPI الافتراضي هو `http://127.0.0.1:8000`. غيّره من زر الإعدادات إذا كانت الـAPI على عنوان آخر. على الهاتف، `127.0.0.1` يشير إلى الهاتف نفسه، لذلك استخدم عنوان الكمبيوتر على الشبكة المحلية بعد إعداد الخادم للسماح بالاتصال الآمن.
+
+## المنصات
+
+تحتوي شجرة المشروع على أهداف الويب وWindows وLinux وAndroid وiOS وmacOS. أنشأنا نسخة الويب أولًا. يحتاج كل هدف إلى أدوات بناء منصته؛ iOS يحتاج macOS، وWindows يحتاج Visual Studio مع أدوات C++، وAndroid يحتاج Android SDK command-line tools وقبول التراخيص.