Python'u Çevrimdışı Kurma

Bu kılavuz, internet erişimi olmayan bir mindzieStudio Enterprise Sunucusuna Python nasıl kurulacağını gösterir. İnternet erişimi olan bir bilgisayarda her şeyi indirirsiniz, bir klasörü sunucuya kopyalarsınız ve o klasörden kurulumu yaparsınız. Sunucudaki hiçbir adım internet bağlantısı gerektirmez.

Yaklaşık 30 dakika, artı sonunda bir sunucu yeniden başlatması planlayın.

Python'a Ne Zaman İhtiyacınız Var

Python sadece şu özellikler için gereklidir:

Bu özellikleri kullanmıyorsanız, Python yüklemeniz gerekmez.

Genel Bakış

Gerekenler

• Python yüklü, internet erişimi olan bir bilgisayar. Windows, macOS veya Linux çalıştırabilir, Python'un herhangi güncel bir sürümünü kullanabilir. Sadece dosyaları indirmek için kullanılır.
• Bir klasörü sunucuya kopyalamak için bir yol; USB sürücü, dosya paylaşımı veya kurumunuzun onaylı dosya aktarım yöntemi olabilir.
• mindzieStudio sunucusunda yönetici erişimi.
• Sunucuda en az 500 MB boş disk alanı.

Bir Python Sürümü Seçin

Python 3.13 (64-bit) kullanın. Bu kılavuzdaki tüm örneklerde Python 3.13 kullanılmıştır.

Bölüm 1: İnternet Erişimi Olan Bilgisayarda

Adım 1: Çevrimdışı Klasörü Oluşturun

python-offline adında bir klasör oluşturun ve içinde packages adlı bir klasör açın. PowerShell'de:

New-Item -ItemType Directory -Force -Path C:\python-offline\packages

İndirdiğiniz her şey bu klasörün içine konacak.

Adım 2: Python Yükleyicisini İndirin

1. Windows için Python Sürümleri sayfasına gidin
2. En yeni Python 3.13 sürümünü bulun
3. Windows installer (64-bit) seçeneğine tıklayın. Dosya adı python-3.13.15-amd64.exe gibi olur
4. Dosyayı C:\python-offline klasörüne kaydedin

Adım 3: İhtiyacınız Olan Paketleri Listeleyin

C:\python-offline içine requirements.txt adlı bir metin dosyası oluşturun ve her satıra bir paket adı yazın.

Her zaman pandas ve numpy paketlerini ekleyin. Her Python zenginleştirme ve Python Script eylemi bunlara ihtiyaç duyar. Scriptleriniz web servisleri veya şirket API'lerini çağırıyorsa requests paketini ekleyin.

pandas
numpy
requests

Sonra scriptlerinizin kullandığı diğer paketleri de ekleyin. Python kodunuzdaki import satırlarına bakın. Bazı paketlerin kurulum adı, import edilen adından farklıdır:

python -m pip freeze > requirements.txt

Adım 4: Paketleri İndirin

PowerShell'i açın ve şu komutu çalıştırın:

cd C:\python-offline
python -m pip download -r requirements.txt -d packages --only-binary=:all: --platform win_amd64 --python-version 3.13

Her seçeneğin amacı:

Bu seçenekler sayesinde indirme yaptığınız bilgisayar Windows çalıştırmak zorunda değil ve Python sürümü sunucu ile aynı olmak zorunda değil.

Komut Successfully downloaded ve paket isimlerini göstererek tamamlanır. packages klasöründe pandas-3.0.5-cp313-cp313-win_amd64.whl gibi .whl dosyaları olmalıdır. cp313 Python 3.13 için olduklarını belirtir.

Adım 5: Klasörü Sunucuya Kopyalayın

Tüm python-offline klasörünü sunucuya kopyalayın. Bu kılavuzda C:\python-offline olarak varsayılmıştır.

Klasör yapısı şöyle görünür:

C:\python-offline\
    python-3.13.15-amd64.exe
    requirements.txt
    packages\
        numpy-2.5.3-cp313-cp313-win_amd64.whl
        pandas-3.0.5-cp313-cp313-win_amd64.whl
        requests-2.34.2-py3-none-any.whl
        ... ve diğer .whl dosyaları

Sürüm numaralarınız farklı olabilir.

Bölüm 2: mindzieStudio Sunucusunda

Adım 6: Python'u Tüm Kullanıcılar için Kurun

mindzieStudio kendi Windows hesabı altında çalışır, sizin hesabınız altında değil. Yalnızca tüm kullanıcılar için kurulu ve sistem PATH'ine ekli Python'u kullanabilir.

Python'u yükleyici penceresi veya tek satırlık PowerShell komutuyla kurabilirsiniz.

Seçenek A: Yükleyici penceresi

1. python-3.13.15-amd64.exe dosyasına sağ tıklayın ve Yönetici olarak çalıştır seçin
2. İlk ekranda Add python.exe to PATH kutusunu işaretleyin, sonra Customize installation tıklayın
3. Optional Features ekranında pip işaretli olduğundan emin olun, sonra Next tıklayın
4. Advanced Options ekranında:
   • Install Python 3.13 for all users kutusunu işaretleyin. Yükleme konumu C:\Program Files\Python313 olur
   • Add Python to environment variables kutusunun işaretli olduğundan emin olun
   • Download ile başlayan seçeneklerin hiçbirini işaretlemeyin. Bu seçenekler internet bağlantısı gerektirir
5. Install tıklayın, kurulumu bitince Close tıklayın

Seçenek B: PowerShell komutu

PowerShell'i Yönetici olarak açın ve aşağıdaki komutu çalıştırın. Dosya adı indirdiğiniz yükleyici adıyla değiştirilmelidir.

Start-Process -FilePath "C:\python-offline\python-3.13.15-amd64.exe" -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0" -Wait

InstallAllUsers=1 Python'u tüm kullanıcılar için kurar. PrependPath=1 Python'u sistem PATH'ine ekler. Komut pencere göstermez ve kurulum bitince döner.

Adım 7: Python Kurulumunu Kontrol Edin

Açık PowerShell pencerelerini kapatın. Yeni bir PowerShell penceresini Yönetici olarak açın. Güncellenen PATH değişkenini alması için yeni pencere gereklidir.

Şu komutları çalıştırın:

python --version
where.exe python

Beklenen çıktı:

Python 3.13.15
C:\Program Files\Python313\python.exe

Adım 8: Klasörden Paketleri Kurun

Aynı Yönetici PowerShell penceresinde şu komutu çalıştırın:

python -m pip install --no-index --find-links C:\python-offline\packages -r C:\python-offline\requirements.txt

--no-index pip'e internete gitmemesini söyler. --find-links pip'e paketleri packages klasöründen kurmasını söyler.

Komut Successfully installed ve paket isimlerini göstererek biter.

Paketlerin yüklendiğini doğrulayın:

python -c "import pandas, numpy; print('pandas', pandas.__version__, 'numpy', numpy.__version__)"

Beklenen çıktı (sürüm numaralarınız farklı olabilir):

pandas 3.0.5 numpy 2.5.3

Adım 9: Sunucuyu Yeniden Başlatın

Windows sunucusunu yeniden başlatın.

mindzieStudio açılırken Python'u kontrol eder ve güncellenmiş sistem PATH'ini görmelidir. Yeniden başlatmak bunun en güvenilir yoludur. mindzieStudio uygulama havuzunun yeniden başlatılması yeterli değildir.

Adım 10: mindzieStudio'da Python'u Kontrol Edin

Enterprise Configuration aracını kontrol edin

1. Sunucuda Enterprise Configuration aracını açın
2. Server Setup sekmesine gidin
3. Python bölümünde Status sizin Python sürümünüzle beraber Installed olarak görünür. Örneğin Installed (3.13.15)

Bir test zenginleştirmesi çalıştırın

1. mindzieStudio'da bir proje açın, bir zenginleştirme defterine gidin
2. Bir Python zenginleştirme bloğu ekleyin
3. Python Image ayarının LOCAL olarak ayarlı olduğundan emin olun
4. Aşağıdaki kodu girin. Kurduğunuz diğer paketler için de import satırları ekleyin:

import pandas
import numpy

5. Zenginleştirmeyi hesaplayın. Python hatası olmadan tamamlanmalıdır.

Sonradan Paket Ekleme

İlk kurulumdan sonra paket eklemek için şu adımları tekrar edin, sadece yeni paket ile:

1. İnternet erişimi olan bilgisayarda requirements.txt dosyasına paketi ekleyin ve 4. Adım komutunu aynı --python-version ile tekrar çalıştırın
2. Güncellenmiş packages klasörü ve requirements.txt dosyasını sunucuya kopyalayın
3. Sunucuda Yönetici PowerShell penceresinde 8. Adım komutunu tekrar çalıştırın

Paket ekledikten sonra sunucuyu yeniden başlatmanıza gerek yoktur.

Sorun Giderme

"Python executable 'python' was not found"

Belirti: Python zenginleştirmesi veya Python Script eylemi şu hatayı verir:

Python executable 'python' was not found. Please ensure Python is installed and added to your system PATH environment variable.

Çözüm:

1. 7. Adımı tekrar edin. where.exe python C:\Program Files\Python313\python.exe adresini göstermelidir
2. Python sadece sizin hesabınız için kurulmuşsa, tüm kullanıcılar için yeniden kurun (Adım 6)
3. Sunucuyu yeniden başlatın (Adım 9)

"ModuleNotFoundError: No module named ..."

Belirti: ModuleNotFoundError: No module named 'openpyxl' (ya da başka bir paket adı) hatası alınıyor.

Çözüm:

1. Yönetici PowerShell'de python -m pip show openpyxl (paket adını Adım 3'ten alın) komutunu çalıştırın
2. Pip Package(s) not found bildiriyorsa paket kurulu değil demektir. İndirin (Adım 4), sunucuya kopyalayın ve kurun (Adım 8)
3. Location satırı C:\Users\ altındaki bir klasörü gösteriyorsa paket yönetici hakları olmadan kurulmuş demektir. python -m pip uninstall openpyxl çalıştırın, sonra Adım 8'i tekrar Yönetici olarak yapın

İndirme sırasında "No matching distribution found"

Belirti: Adım 4 komutu şu hatayı verir: ERROR: No matching distribution found for ve ardından bir paket adı.

Çözüm:

• Yazım hatası kontrol edin. Paket adını kullanın, import adını değil (Adım 3 tablosuna bakın)
• Satırda sürüm numarası varsa, o sürüm sizin Python versiyonunuza uygun olmayabilir. Sürüm numarasını kaldırın veya daha yeni bir sürüm seçin
• Eğer requirements.txt pip freeze ile oluşturulduysa, içinde @ file: içeren satırları silin. O paketler yerelden kurulmuş ve indirilemez.

Sunucuda "Could not find a version that satisfies the requirement"

Belirti: Adım 8 komutu şu hatayı verir: Could not find a version that satisfies the requirement ve ardından paket adı.

Çözüm:

• packages klasörü o paketi içermiyor veya dosyalar farklı Python sürümü için indirilmiş
• Sunucudaki python --version ile dosya isimlerindeki cp bölümünü karşılaştırın. Python 3.13 için dosyaların cp313 içermesi gerekir (py3-none-any.whl dosyaları tüm sürümlerde çalışır)
• İnternet erişimi olan bilgisayarda sunucu sürümüyle aynı olan --python-version kullanarak tekrar indirin ve packages klasörünü tekrar kopyalayın

Python Image "Python not configured" gösteriyor

Belirti: Python zenginleştirmesi, Python Script eylemi veya AI Case Prediction zenginleştirmesi Python Image ayarında Python not configured gösteriyor.

Çözüm: Python kurulmadan önce oluşturulmuş zenginleştirme ve eylemler bu değeri tutar. Python Image ayarını LOCAL olarak değiştirin ve tekrar hesaplayın.

İlgili Dokümantasyon

• Python Kurulumu - İnternet erişimi olan bir sunucuya Python kurulumu
• Python Zenginleştirme - Python ile özel veri dönüşümleri
• Python Script Eylemi - Otomatik Python script yürütme
• AI Case Prediction - Makine öğrenmeli tahminler
• Teknik Gereksinimler - Sunucu gereksinimleri