انتقل إلى المحتوى

التثبيت

ما تحتاجه

  • Python 3.12 أو أحدث (download)

  • uv — مدير حزم Python سريع. ثبّت بـ:

    curl -LsSf https://astral.sh/uv/install.sh | sh

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  • مفتاح API لـ LLM — أي من:

    • Google Gemini (مستوى مجاني متاح — موصى به للبدء)
    • أي نقطة نهاية متوافقة مع OpenAI (OpenAI، Anthropic عبر proxy، Ollama / LM Studio محلي، إلخ)

اختياري، لكنه يفتح المزيد من الميزات

الأداة يستخدمها متى تحتاجها
FFmpeg (download) الترجمة، الصوت، الدبلجة، Live أي سير عمل صوتي/مرئي
LibreOffice (download) تنسيقات Office على Linux/macOS ترجمة .doc / .xls / .ppt القديمة، أو أي ملف Office عند عدم تثبيت MS Office
Tesseract (install guide) محرك OCR (الافتراضي) صفحة استخراج النص، ترجمة PDF الممسوحة، ترجمة الصور المضمنة
MS Office + pywin32 Office على Windows أعلى دقة لترجمة Office على Windows

يمكنك تثبيت AI Translate دون أي من هذه — الميزات التي تحتاجها ستخبرك بذلك قبل أن تفشل.

قم بإعداده

git clone https://github.com/cadic2603/ai-translate.git
cd ai-translate
uv sync

يقوم ذلك بتثبيت كل ما هو ضروري لتشغيل تطبيق سطح المكتب وCLI وخادم MCP.

شغّله

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # نقل stdio (لـ Claude Desktop / Code)

أضف مفتاح API الخاص بك

في أول مرة تفتح فيها تطبيق سطح المكتب:

  1. انقر الإعدادات في الشريط الجانبي
  2. افتح علامة التبويب LLM
  3. الصق مفتاح API الخاص بـ Google Gemini (أو قم بتكوين مزود مخصص متوافق مع OpenAI). يمكن لمستخدمي المؤسسات تبديل Gemini إلى وضع Vertex AI بدلاً من ذلك — وجّهه إلى مشروع GCP ومنطقة، اختياريًا قدّم مسار JSON لحساب الخدمة؛ راجع مزودو LLM للتفاصيل.
  4. اختر نموذجًا افتراضيًا — أي متغير Flash حالي (مثل gemini-2.5-flash) هو نقطة بداية مجانية متينة. متغيرات Pro تعطي جودة أفضل بتكلفة أعلى.
  5. أغلق الإعدادات — انتهيت

تُخزن المفاتيح في OS keychain الخاص بك (macOS Keychain، Windows Credential Manager، GNOME / KDE Secret Service على Linux)، وليس في نص عادي على القرص.

تثبيت بدون واجهة / خادم

إذا لم تتمكن من تشغيل تطبيق سطح المكتب لإعداد المفاتيح، راجع مزودو LLM لأوامر CLI keychain.

التالي: جرّبه

الترجمة الأولى في 5 دقائق →