Python Offline Installeren

Deze gids laat zien hoe je Python installeert op een mindzieStudio Enterprise-server die geen internettoegang heeft. Je downloadt alles op een computer met internettoegang, kopieert één map naar de server en installeert vanaf die map. Geen van de stappen op de server vereist een internetverbinding.

Reken op ongeveer 30 minuten, plus één serverherstart aan het einde.

Wanneer je Python nodig hebt

Python is alleen vereist voor deze functies:

Functie	Wat het doet
Python verrijking	Aangepaste datatransformaties geschreven in Python
Python Script actie	Geautomatiseerde integraties, exports en notificaties geschreven in Python
AI Case Prediction verrijking	Traind een voorspellingsmodel op je cases en voegt de voorspellingen toe aan je data

Als je deze functies niet gebruikt, hoef je Python niet te installeren.

Overzicht

Op een computer met internettoegang	Op de mindzieStudio server
1. Maak de offline map aan	6. Installeer Python voor alle gebruikers
2. Download de Python installer	7. Controleer de Python installatie
3. Maak een lijst van benodigde pakketten	8. Installeer de pakketten vanuit de map
4. Download de pakketten	9. Herstart de server
5. Kopieer de map naar de server	10. Controleer Python in mindzieStudio

Wat je nodig hebt

Een computer met internettoegang waarop Python is geïnstalleerd. Dit kan Windows, macOS of Linux zijn, en elke recente Python-versie. De computer wordt alleen gebruikt om bestanden te downloaden.
Een manier om een map naar de server te kopiëren, zoals een USB-stick, een bestandsdeling of de goedgekeurde bestandsoverdrachtsmethode van je organisatie.
Administratorrechten op de mindzieStudio-server.
Minimaal 500 MB vrije schijfruimte op de server.

Kies een Python-versie

Gebruik Python 3.13 (64-bit). Deze gids gebruikt Python 3.13 in elk voorbeeld.

Gebruik Doorlopend Dezelfde Python-versie

Python-pakketten zijn gebouwd voor één specifieke Python-versie. De pakketten die je downloadt in stap 4 moeten overeenkomen met de Python-versie die je installeert op de server in stap 6. Als je een andere versie kiest, pas dan 3.13 in het commando van stap 4 aan zodat het overeenkomt.

Deel 1: Op de computer met internettoegang

Stap 1: Maak de offline map aan

Maak een map met de naam python-offline en een packages-map erin. In PowerShell:

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

Alles wat je downloadt gaat in deze ene map.

Stap 2: Download de Python installer

Ga naar de Python Releases for Windows pagina
Zoek de nieuwste Python 3.13 release
Klik op Windows installer (64-bit). Het bestand heet ongeveer python-3.13.15-amd64.exe
Sla het bestand op in C:\python-offline

Download de Windows Installer (64-bit)

Gebruik niet de Python install manager of het Windows embeddable package. De installatiemanager downloadt Python tijdens de installatie, wat mislukt op een server zonder internet. Het embeddable package bevat geen pip, wat nodig is om pakketten te installeren.

Stap 3: Maak een lijst van benodigde pakketten

Maak een tekstbestand requirements.txt aan in C:\python-offline, met één pakketnaam per regel.

Voeg altijd pandas en numpy toe. Iedere Python verrijking en Python Script actie heeft deze nodig. Voeg requests toe als je scripts webservices of eigen bedrijfs-API’s aanroepen.

pandas
numpy
requests

Voeg dan een regel toe voor elk ander pakket dat je scripts gebruiken. Kijk naar de import-regels in je Python-code. Sommige pakketten hebben een andere installatienaam dan de importnaam:

Je code zegt	Voeg deze regel toe aan requirements.txt
`import openpyxl`	`openpyxl`
`import sklearn`	`scikit-learn`
`import dateutil`	`python-dateutil`
`import yaml`	`PyYAML`
`import pyodbc`	`pyodbc`
`import sqlalchemy`	`sqlalchemy`

Scripts werken al op een andere machine?

Als je Python-scripts al correct draaien op een andere server of pc, kopieer dan de exacte pakketversies in plaats van de lijst met de hand te maken. Op die machine, voer uit:

python -m pip freeze > requirements.txt

Gebruik dat requirements.txt bestand. Het bevat iedere geïnstalleerde pakketversie precies, zodat de offline server dezelfde versies krijgt waarmee je scripts getest zijn.

Stap 4: Download de pakketten

Open PowerShell en voer uit:

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

Betekenis van iedere optie:

Optie	Doel
`-r requirements.txt`	Downloadt ieder pakket uit je lijst plus al hun afhankelijkheden
`-d packages`	Slaat de bestanden op in de `packages`-map
`--platform win_amd64`	Downloadt de 64-bit Windows-versie van elk pakket
`--python-version 3.13`	Downloadt pakketten gebouwd voor Python 3.13. Pas aan bij een andere versie
`--only-binary=:all:`	Downloadt alleen kant-en-klare pakketten, zodat niets op de server hoeft te worden gecompileerd

Door deze opties hoeft de computer waarop je downloadt niet Windows te draaien of dezelfde Python-versie als de server te hebben.

Het commando eindigt met Successfully downloaded en de pakketnamen. De packages-map bevat nu .whl-bestanden zoals pandas-3.0.5-cp313-cp313-win_amd64.whl. Het cp313-gedeelte geeft aan dat het voor Python 3.13 is gebouwd.

Stap 5: Kopieer de map naar de server

Kopieer de hele python-offline map naar de server. Deze gids gaat ervan uit dat je hem kopieert naar C:\python-offline op de server.

De mapstructuur zou er zo uit moeten zien:

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
        ... en meer .whl bestanden

Je versienummers kunnen afwijken.

Deel 2: Op de mindzieStudio server

Stap 6: Installeer Python voor alle gebruikers

mindzieStudio draait onder een eigen Windows-account, niet onder jouw gebruikersaccount. Het kan alleen Python gebruiken die is geïnstalleerd voor alle gebruikers en toegevoegd aan de systeem-PATH.

Installeer Python via het installatiescherm of met één PowerShell-commando.

Optie A: Installatiescherm

Klik met de rechtermuisknop op python-3.13.15-amd64.exe en kies Als administrator uitvoeren
Vink op het eerste scherm Add python.exe to PATH aan, klik dan op Customize installation
Op het scherm Optional Features, zorg dat pip is aangevinkt, en klik op Next
Op het scherm Advanced Options:
- Vink Install Python 3.13 for all users aan. De installatiemap verandert naar C:\Program Files\Python313
- Controleer dat Add Python to environment variables is aangevinkt
- Laat alle opties die met Download beginnen uitgevinkt. Die vereisen internet
Klik op Install en daarna op Close als de installatie klaar is

Optie B: PowerShell-commando

Open PowerShell als Administrator en voer het volgende commando uit. Vervang de bestandsnaam door de naam van de installer die je hebt gedownload.

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

InstallAllUsers=1 installeert Python voor alle gebruikers. PrependPath=1 voegt Python toe aan de systeem-PATH. Het commando opent geen venster en keert terug zodra de installatie is voltooid.

Stap 7: Controleer de Python installatie

Sluit openstaande PowerShell-vensters. Open een nieuw PowerShell-venster als Administrator (een nieuw venster is nodig om de aangepaste PATH op te pikken).

Voer uit:

python --version
where.exe python

Verwachte output:

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

Python Moet in Program Files Staan

De eerste regel van where.exe python moet wijzen naar C:\Program Files\Python313\python.exe. Als het wijst naar een map onder C:\Users\, dan is Python alleen voor jouw account geïnstalleerd en kan mindzieStudio het niet gebruiken. Verwijder die installatie via Instellingen > Apps, herhaal stap 6 en zorg dat Install Python 3.13 for all users is aangevinkt.

Stap 8: Installeer de pakketten vanuit de map

Voer in hetzelfde Administrator PowerShell-venster uit:

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

--no-index vertelt pip niet naar internet te gaan. --find-links wijst pip naar je packages-map.

Het commando eindigt met Successfully installed gevolgd door de pakketnamen.

Voer Dit Commando Uit Als Administrator

Als PowerShell niet als Administrator draait, toont pip de melding Defaulting to user installation because normal site-packages is not writeable en installeert de pakketten in je persoonlijke profiel, waar mindzieStudio ze niet kan gebruiken. Zie je deze melding, open PowerShell dan als Administrator en voer het commando opnieuw uit.

Controleer dat de pakketten laden:

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

Verwachte output (versienummers kunnen afwijken):

pandas 3.0.5 numpy 2.5.3

Stap 9: Herstart de server

Herstart de Windows-server.

mindzieStudio controleert op Python bij het opstarten en moet de geüpdatete systeem-PATH zien. De server herstarten is de betrouwbare manier om dit zeker te stellen. Alleen het recyclen van de mindzieStudio application pool is niet genoeg.

Stap 10: Controleer Python in mindzieStudio

Controleer in de Enterprise Configuration tool

Open de Enterprise Configuration tool op de server
Ga naar het tabblad Server Setup
In de sectie Python toont Status Installed met je Python-versie, bijvoorbeeld Installed (3.13.15)

Voer een testverrijking uit

Open een project in mindzieStudio en ga naar een verrijkingsnotebook
Voeg een Python verrijkingsblok toe
Controleer dat Python Image is ingesteld op LOCAL
Voer deze code in. Voeg een import-regel toe voor elk ander pakket dat je installeerde:

import pandas
import numpy

Bereken de verrijking. Deze voltooit zonder Python-fout.

Pakketten later toevoegen

Om een pakket toe te voegen na de eerste installatie, herhaal je dezelfde stappen met alleen het nieuwe pakket:

Op de computer met internettoegang, voeg het pakket toe aan requirements.txt en voer het commando uit stap 4 opnieuw uit, met dezelfde --python-version
Kopieer de bijgewerkte packages-map en requirements.txt naar de server
Voer op de server stap 8 opnieuw uit in een Administrator PowerShell-venster

Herstarten van de server is niet nodig na het toevoegen van pakketten.

Problemen oplossen

"Python executable 'python' was not found"

Symptoom: Een Python verrijking of Python Script actie faalt met:

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

Oplossing:

Herhaal stap 7. where.exe python moet wijzen naar C:\Program Files\Python313\python.exe
Als Python alleen voor jouw account is geïnstalleerd, installeer het opnieuw voor alle gebruikers (stap 6)
Herstart de server (stap 9)

"ModuleNotFoundError: No module named ..."

Symptoom: Een Python verrijking of Python Script actie faalt met ModuleNotFoundError: No module named 'openpyxl' (of een andere pakketnaam).

Oplossing:

In een Administrator PowerShell-venster, voer uit python -m pip show openpyxl (gebruik de pakketnaam uit stap 3)
Als pip meldt Package(s) not found, is het pakket niet geïnstalleerd. Download het (stap 4), kopieer naar de server en installeer (stap 8)
Als de regel Location wijst naar een map onder C:\Users\, is het pakket zonder administratorrechten geïnstalleerd. Voer uit python -m pip uninstall openpyxl, herhaal stap 8 als Administrator

"No matching distribution found" bij downloaden

Symptoom: Het commando van stap 4 faalt met ERROR: No matching distribution found for gevolgd door een pakketnaam.

Oplossing:

Controleer de spelling. Gebruik de pakketnaam, niet de importnaam (zie tabel in stap 3)
Als er in de regel een versienummer staat, is die versie mogelijk niet beschikbaar voor jouw Python-versie. Verwijder dat versienummer of kies een nieuwere versie
Als je requirements.txt van pip freeze komt, verwijder dan alle regels die @ file: bevatten. Die pakketten zijn van een lokaal bestand geïnstalleerd en kunnen niet gedownload worden

"Could not find a version that satisfies the requirement" op de server

Symptoom: Het commando van stap 8 faalt met Could not find a version that satisfies the requirement gevolgd door een pakketnaam.

Oplossing:

De packages-map bevat dat pakket niet, of de bestanden zijn gedownload voor een andere Python-versie
Vergelijk python --version op de server met het cp-gedeelte in bestandsnamen. Voor Python 3.13 moeten de bestanden cp313 bevatten (bestanden die eindigen op py3-none-any.whl werken met elke versie)
Download opnieuw op de computer met internettoegang, met --python-version passend bij server, en kopieer de packages-map opnieuw

Python Image toont "Python not configured"

Symptoom: Een Python verrijking, Python Script actie of AI Case Prediction verrijking toont Python not configured bij de instelling Python Image.

Oplossing: Verrijkingen en acties die gemaakt zijn vóór installatie van Python behouden deze waarde. Verander Python Image naar LOCAL en bereken opnieuw.

Gerelateerde documentatie

Python installeren - Python installeren op een server met internettoegang
Python verrijking - Aangepaste datatransformaties met Python
Python Script actie - Geautomatiseerde uitvoering van Python-scripts
AI Case Prediction - Voorspellingen met machine learning
Technische vereisten - Serververeisten