Konfigurere Python-miljøet
Installer OpenAI Python SDK, opprett et virtuelt miljø, lagre API-nøkkelen sikkert ved hjelp av miljøvariabler, og kontroller at alt fungerer med en helsesjekk.
Konfigurere Python-miljøet er en gratis leksjon i AI Engineering Academy på CoddyKit. Dette er leksjon 1 av 4. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i AI Engineering Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i AI Engineering Academy inneholder totalt 4 leksjoner.
Hvorfor virtuelle miljøer er viktige
AI-prosjekter bruker mange pakker, og de kan ha motstridende versjonskrav. Et virtuelt miljø gir hvert prosjekt sitt eget isolerte Python-miljø, slik at ingenting kolliderer. Koden setter opp et slikt miljø.
# 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 PythonInstallere OpenAI Python SDK
Den offisielle OpenAI Python SDK er måten du kommuniserer med API-et på – den håndterer autentisering, nye forsøk og tolking av svar. Installer den i det aktive miljøet, slik koden viser.
# 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.txtHente og lagre API-nøkkelen
API-nøkkelen din er hemmelig – legg den aldri i kode. Lagre den i en .env-fil, legg filen til i .gitignore, og last den inn som en miljøvariabel. Koden viser mønsteret.
# .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 prefixInitialisere OpenAI-klienten
Du oppretter én OpenAI()-klient og utfører alle kall gjennom den. Hvis nøkkelen er satt som en miljøvariabel, finner klienten den automatisk – ryddigere og sikrere.
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'
# )Din første helsesjekk av API-et
Før du bygger noe, kjører du en liten helsesjekk som viser modellene. Den bekrefter at nøkkelen fungerer, at nettverket er i orden, og at SDK-et er installert. Kjør den alltid først.
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}')Beste praksis for prosjektstruktur
Etter hvert som prosjekter vokser, reduserer en konsekvent prosjektstruktur hodebry: oppbevar hemmeligheter i .env, kode i src/, og en .env.example-mal slik at teammedlemmer vet hva som trengs.
# 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/
# |-- MakefileSikker håndtering av flere API-nøkler
Håndterer De mange nøkler fra ulike leverandører? En hemmelighetshåndterer som AWS Secrets Manager eller Doppler skalerer bedre enn én .env-fil. Bruk en separat nøkkel per prosjekt, slik at De kan tilbakekalle dem på en trygg måte.
# .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
}Bruke versjonsbehandlere for Python
Ulike prosjekter trenger ulike Python-versjoner. En versjonsbehandler som pyenv installerer flere versjoner og bytter mellom dem per mappe – uten konflikter på systemnivå.
# 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 directoryTeste oppsettet med en ekte forespørsel
Den virkelige testen er en aktiv forespørsel som får et ekte svar. Denne ende-til-ende-kontrollen validerer oppsettet, nøkkelen, nettverket og faktureringen i ett trinn. Be om ett ord: 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)Bruke uv for raskere pakkehåndtering
uv er en rask, Rust-basert pakkehåndterer som er 10–100 ganger raskere enn pip. For tunge AI-biblioteker kan en installasjon på tre minutter reduseres til sekunder. Det er verdt å ta i bruk fra første dag.
# 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.txtMiljøvariabler i produksjon
I produksjon er ikke .env tilstrekkelig. Plattformer som Railway og Vercel injiserer miljøvariabler under kjøring. Koden leser os.environ; bare de injiserte verdiene endres.
# 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()Rask kontroll
Test forståelsen Deres av AI Engineering-konseptene fra denne leksjonen.
Oppsummering av leksjonen
De satte opp verktøysettet: et virtuelt miljø isolerer avhengigheter, API-nøkler ligger i miljøvariabler (aldri i koden), og en helsekontroll kjøres først på enhver maskin. Neste tema: chat. 🎉
Lær deg Python med en AI-veileder – gratis
Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.
- Kurs
- 30
- Leksjoner
- 120
Ofte stilte spørsmål
Er leksjonen «Konfigurere Python-miljøet» gratis?
Ja – hele teksten i «Konfigurere Python-miljøet» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av AI Engineering Academy-kurset, kan du oppgradere til CoddyKit PRO. Kurset i AI Engineering Academy inneholder totalt 4 leksjoner.
Hva lærer jeg i «Konfigurere Python-miljøet»?
Installer OpenAI Python SDK, opprett et virtuelt miljø, lagre API-nøkkelen sikkert ved hjelp av miljøvariabler, og kontroller at alt fungerer med en helsesjekk. Du øver på AI Engineering Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.
Trenger jeg erfaring for å begynne med AI Engineering Academy?
Ingen tidligere erfaring er nødvendig. AI Engineering Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 1 av 4.
Hvor lang tid tar leksjonen «Konfigurere Python-miljøet»?
De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.
Kan jeg skrive og kjøre kode i denne AI Engineering Academy-leksjonen?
Ja. Alle AI Engineering Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.
Alle leksjonene i dette kurset
- Konfigurere Python-miljøet
- Endepunktet for chat completions
- Styr modellens atferd med parametere
- Feilhåndtering og hastighetsgrenser