AI Engineering Academy · Les

Uw Python-omgeving instellen

U installeert de OpenAI Python SDK, maakt een virtuele omgeving aan, slaat uw API-sleutel veilig op met omgevingsvariabelen en controleert met een health check of alles werkt.

Les 1 van 413 stappen

Uw Python-omgeving instellen is een gratis AI Engineering Academy-les op CoddyKit. Dit is les 1 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject AI Engineering Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus AI Engineering Academy bevat in totaal 4 lessen.

Waarom virtuele omgevingen belangrijk zijn

AI-projecten halen veel pakketten binnen, die kunnen botsen over versies. Een virtuele omgeving geeft elk project zijn eigen geïsoleerde Python, zodat niets botst. De code maakt er een aan.

# Create and activate a virtual environment
# Run these commands in your terminal

python3 -m venv .venv          # create environment in .venv/ folder
source .venv/bin/activate      # activate on macOS/Linux
# .venv\Scripts\activate       # activate on Windows

python --version               # verify you are using the right Python

De OpenAI Python SDK installeren

Met de officiële OpenAI Python SDK praat je met de API — de SDK verwerkt authenticatie, nieuwe pogingen en het parseren. Installeer deze in je actieve omgeving, zoals de code laat zien.

# Install the OpenAI SDK
pip install openai

# For production projects, pin the version:
pip install 'openai>=1.30.0,<2.0.0'

# Save your dependencies to requirements.txt:
pip freeze > requirements.txt

# Install from requirements.txt on a new machine:
pip install -r requirements.txt

Je API-sleutel ophalen en opslaan

Je API-sleutel is geheim — zet deze nooit in code. Sla de sleutel op in een .env-bestand, voeg dat bestand toe aan .gitignore en laad de sleutel als een omgevingsvariabele. De code laat het patroon zien.

# .env file (never commit this!)
# OPENAI_API_KEY=sk-proj-...

# In your Python script:
import os
from dotenv import load_dotenv

load_dotenv()  # reads .env and sets environment variables

api_key = os.environ.get('OPENAI_API_KEY')
if not api_key:
    raise ValueError('OPENAI_API_KEY environment variable not set!')

print('API key loaded:', api_key[:8] + '...')  # only print prefix

De OpenAI-client initialiseren

Je maakt één OpenAI()-client en roept alles via die client aan. Als je sleutel als omgevingsvariabele is ingesteld, vindt de client die automatisch — overzichtelijker en veiliger.

from openai import OpenAI

# API key is read from OPENAI_API_KEY environment variable automatically
client = OpenAI()

# Or explicitly:
# client = OpenAI(api_key='sk-proj-...')  # only for quick tests

# For alternative providers:
# client = OpenAI(
#     api_key='your-together-key',
#     base_url='https://api.together.xyz/v1'
# )

Je eerste API-statuscontrole

Voordat je iets bouwt, voer je een kleine statuscontrole uit die de modellen opvraagt. Zo bevestig je dat je sleutel werkt, het netwerk in orde is en de SDK is geïnstalleerd. Voer deze altijd eerst uit.

from openai import OpenAI

client = OpenAI()

# Simple health check: list available models
try:
    models = client.models.list()
    print(f'Connection successful! Found {len(list(models))} models.')
except Exception as e:
    print(f'Connection failed: {e}')

Aanbevolen werkwijzen voor projectstructuur

Naarmate projecten groeien, voorkomt een consistente projectstructuur veel gedoe: bewaar geheimen in .env, code in src/ en een .env.example-sjabloon, zodat teamgenoten weten wat nodig is.

# Recommended project structure:
# my_ai_project/
# |-- .env              (secrets, gitignored)
# |-- .env.example      (template, committed)
# |-- .gitignore
# |-- requirements.txt
# |-- README.md
# |-- src/
# |   |-- __init__.py
# |   |-- client.py    (OpenAI client initialization)
# |   |-- prompts.py   (prompt templates)
# |   |-- main.py
# |-- tests/
# |-- notebooks/
# |-- Makefile

Meerdere API-sleutels veilig beheren

Werk je met veel sleutels van providers? Een geheimenbeheerder zoals AWS Secrets Manager of Doppler schaalt beter dan één .env-bestand. Gebruik per project een aparte sleutel, zodat je die veilig kunt intrekken.

# .env.example - commit this as a template
# OPENAI_API_KEY=sk-proj-...your key here...
# OPENAI_ORG_ID=org-...optional org id...
# COHERE_API_KEY=...cohere key...
# PINECONE_API_KEY=...pinecone key...
# PINECONE_ENVIRONMENT=us-east-1-aws

# In code, load all at once:
from dotenv import load_dotenv
import os

load_dotenv()

config = {
    'openai_key': os.environ['OPENAI_API_KEY'],
    'cohere_key': os.environ.get('COHERE_API_KEY'),  # optional
}

Python-versiebeheerders gebruiken

Verschillende projecten hebben verschillende Python-versies nodig. Een versiebeheerder zoals pyenv installeert meerdere versies en schakelt per map tussen deze versies — zonder conflicten op systeemniveau.

# Install pyenv (macOS via Homebrew)
# brew install pyenv

# Install Python 3.11
# pyenv install 3.11.9

# Set Python version for this project directory
# pyenv local 3.11.9

# This creates a .python-version file:
# cat .python-version
# 3.11.9

# Now python3 automatically uses 3.11.9 in this directory

Je configuratie testen met een echte prompt

De echte test is een live prompt die een echt antwoord oplevert. Deze end-to-end-controle controleert in één keer je configuratie, sleutel, netwerk en facturering. Vraag om één woord: READY.

from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()
client = OpenAI()

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=[
        {'role': 'system', 'content': 'You are a test responder.'},
        {'role': 'user', 'content': 'Reply with just the word READY.'}
    ],
    temperature=0,
    max_tokens=5
)

print('Response:', response.choices[0].message.content)
print('Model used:', response.model)
print('Tokens used:', response.usage.total_tokens)

uv gebruiken voor sneller pakketbeheer

uv is een snelle, op Rust gebaseerde pakketbeheerder die 10 tot 100 keer sneller is dan pip. Voor grote AI-bibliotheken wordt een installatie van 3 minuten teruggebracht tot enkele seconden. Het is de moeite waard om dit vanaf dag één te gebruiken.

# Install uv (macOS/Linux)
# curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a project with uv
# uv init my-ai-project
# cd my-ai-project

# Add dependencies
# uv add openai python-dotenv

# Run your script using the uv-managed environment
# uv run python main.py

# Generate requirements.txt for compatibility
# uv pip compile pyproject.toml -o requirements.txt

Omgevingsvariabelen in productie

In productie is .env niet genoeg. Platforms zoals Railway en Vercel voegen omgevingsvariabelen tijdens runtime toe. Je code leest os.environ; alleen de toegevoegde waarden veranderen.

# Centralized config loader pattern for production
import os
from dataclasses import dataclass

@dataclass
class AppConfig:
    openai_api_key: str
    environment: str
    log_level: str

    @classmethod
    def from_env(cls):
        key = os.environ.get('OPENAI_API_KEY')
        if not key:
            raise EnvironmentError('OPENAI_API_KEY must be set')
        return cls(
            openai_api_key=key,
            environment=os.environ.get('ENVIRONMENT', 'development'),
            log_level=os.environ.get('LOG_LEVEL', 'INFO')
        )

config = AppConfig.from_env()

Korte controle

Test je begrip van de AI-engineeringconcepten uit deze les.

Samenvatting van de les

Je hebt je gereedschappen ingesteld: een virtuele omgeving isoleert afhankelijkheden, API-sleutels staan in omgevingsvariabelen (nooit in code) en op elke machine wordt eerst een gezondheidscontrole uitgevoerd. Hierna: chatten. 🎉

Gratis beginnen

Leer Python met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
30
Lessen
120

Veelgestelde vragen

Is de les “Uw Python-omgeving instellen” gratis?

Ja — de volledige tekst van “Uw Python-omgeving instellen” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus AI Engineering Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus AI Engineering Academy bevat in totaal 4 lessen.

Wat leer ik in “Uw Python-omgeving instellen”?

U installeert de OpenAI Python SDK, maakt een virtuele omgeving aan, slaat uw API-sleutel veilig op met omgevingsvariabelen en controleert met een health check of alles werkt. Je oefent met AI Engineering Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met AI Engineering Academy te beginnen?

Ervaring vooraf is niet nodig. AI Engineering Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 1 van 4.

Hoe lang duurt de les “Uw Python-omgeving instellen”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over AI Engineering Academy?

Ja. Elke les over AI Engineering Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. Uw Python-omgeving instellen
  2. Het Chat Completions-endpoint
  3. Modelgedrag sturen met parameters
  4. Foutafhandeling en rate limits
← Terug naar AI Engineering Academy