التوثيقDocs / المتطلبات والتثبيتRequirements & install
المتطلبات والتثبيتRequirements & install
ما تحتاجه، وكيف تثبّت KaldrivoAI وتشغّله لأول مرة.What you need, and how to install and first run KaldrivoAI.
المتطلباتRequirements
- ويندوز ١٠ أو ١١.
- ميكروفون (ميكروفون اللابتوب المدمج يكفي).
- اتصال بالإنترنت للتعرّف على الكلام.
اختياري:
- مفتاح Gemini مجاني من Google للمزايا الذكية.
- كاميرا (أو جوالك ككاميرا) للماوس باليد.
- جوال أندرويد ١١ أو أحدث للتحكم بالجوال.
- تلفاز يدعم العرض اللاسلكي.
- Windows 10 or 11.
- A microphone (the laptop’s built-in mic is fine).
- An internet connection for speech recognition.
Optional:
- A free Google Gemini key for the smart features.
- A camera (or your phone as a camera) for the hand mouse.
- An Android 11+ phone for phone control.
- A TV that supports wireless display.
التثبيتInstall
تحميل لويندوز (v1.6.4 · 92 MB)Download for Windows (v1.6.4 · 92 MB)
- حمّل KaldrivoAI_Setup.exe من زر «تحميل لويندوز» أعلاه (يفتح Google Drive، اضغط «تنزيل»).
- شغّل ملف التثبيت KaldrivoAI_Setup.exe. لا يحتاج صلاحيات المسؤول؛ يُثبَّت لحسابك في
%LOCALAPPDATA%\Programs\KaldrivoAI. - إذا ظهرت رسالة «Windows protected your PC» اضغط More info ثم Run anyway. هذا متوقع لأن النسخة التجريبية غير موقّعة رقمياً بعد.
- اختر إن أردت: أيقونة على سطح المكتب، و«شغّل KaldrivoAI تلقائياً مع بداية الويندوز» (غير مفعّل افتراضياً).
- عند أول تشغيل، إذا سألك جدار حماية ويندوز، فعّل الشبكات الخاصة (Private) واضغط السماح (Allow). هذا ما يسمح لصفحة الجوال بالعمل على شبكة الواي فاي في بيتك.
- اسمح بالميكروفون: الإعدادات ← الخصوصية والأمان ← الميكروفون ← فعّل «السماح لتطبيقات سطح المكتب بالوصول إلى الميكروفون».
- Download KaldrivoAI_Setup.exe with the “Download for Windows” button above (it opens Google Drive; click Download).
- Run the installer, KaldrivoAI_Setup.exe. No admin rights needed; it installs for your account into
%LOCALAPPDATA%\Programs\KaldrivoAI. - If you see “Windows protected your PC”, click More info, then Run anyway. That’s expected: the beta isn’t code-signed yet.
- Choose if you like: a desktop icon, and “Start KaldrivoAI when Windows starts” (off by default).
- On first start, if Windows Firewall asks, tick Private networks and click Allow. That lets the phone page work on your home Wi-Fi.
- Allow the microphone: Settings → Privacy & security → Microphone → turn on “Let desktop apps access your microphone”.
أول تشغيلFirst run
- عند أول تشغيل بدون مفتاح، تظهر نافذة صغيرة تطلب مفتاح Gemini. الصق مفتاحك واختر لهجتك (اختياري) واضغط حفظ، أو أغلقها وأضف المفتاح لاحقاً. كيف تحصل على المفتاح
- يظهر الشريط أعلى الشاشة وأيقونة KaldrivoAI بجانب الساعة.
- صفّق مرتين، أو اضغط Ctrl+Alt+K، أو قل «استيقظ»، ثم قل: «افتح اليوتيوب».
في قائمة ابدأ ستجد اختصارات: KaldrivoAI، ومفتاح جيميناي، وكاميرا الجوال، وربط الجوال، ودليل الاستخدام.
- On the first start without a key, a small window asks for a Gemini key. Paste your key, pick your dialect (optional) and click Save — or close it and add the key later. How to get the key
- The bar appears at the top of the screen and the KaldrivoAI icon sits next to the clock.
- Clap twice, press Ctrl+Alt+K, or say “wake up”, then say: “open YouTube”.
The Start menu has shortcuts for KaldrivoAI, «مفتاح جيميناي» (Gemini key), «كاميرا الجوال» (phone camera), «ربط الجوال» (phone setup) and the user guide.
أيقونة البرنامج بجانب الساعةThe tray icon
اضغط بالزر الأيمن على أيقونة KaldrivoAI: استمع الآن · اربط الجوال · حرّك الشريط · رجّع الشريط فوق · الماوس بالإصبع · كاميرة الجوال · ربط الجوال · معاينة الكاميرا · وضع العرض · شغّل مع الويندوز · الرد بالصوت · الإعدادات config.json · السجل · خروج.
Right-click the KaldrivoAI icon: Listen now · Phone QR · Move bar · Reset bar · Hand mouse · Phone camera · Phone control · Camera preview · Demo mode · Start with Windows · Voice replies · config.json · Log · Quit.
التشغيل مع ويندوزStart with Windows
لا يشتغل مع ويندوز إلا إذا اخترت ذلك: إما خيار المثبّت، أو من أيقونة البرنامج ← «شغّل مع الويندوز». يعمل عندها مخفياً بدون نافذة سوداء. ألغِ التحديد لإيقافه.
It only starts with Windows if you choose to: either the installer option, or the tray icon → “Start with Windows”. It then starts hidden, with no console window. Untick it to stop.
الإزالةUninstall
من إعدادات ويندوز ← التطبيقات، أو من قائمة ابدأ ← إلغاء تثبيت KaldrivoAI. الإزالة توقف التشغيل التلقائي، وتُبقي ملف الإعدادات config.json حتى تحتفظ بإعداداتك إذا أعدت التثبيت.
From Windows Settings → Apps, or Start menu → Uninstall KaldrivoAI. Uninstalling turns start-with-Windows off and keeps your config.json, so a reinstall keeps your settings.