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.
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 PythonDe 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.txtJe 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 prefixDe 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/
# |-- MakefileMeerdere 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 directoryJe 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.txtOmgevingsvariabelen 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. 🎉
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
- Uw Python-omgeving instellen
- Het Chat Completions-endpoint
- Modelgedrag sturen met parameters
- Foutafhandeling en rate limits