Inrichting – Stap 1: VENV, GITHUB,

Samenvatting uitvoeren commando’s vanuit CMD:

ContextWanneer te gebruiken?Voorbeelden
Willekeurige directoryVoor systeem-gerelateerde acties of tools die overal beschikbaar zijn.docker --version, git config, docker run hello-world
CKBA-directoryVoor acties of bestanden specifiek voor jouw project.git init, docker build, echo "venv/" > .gitignore
Venv geactiveerdVoor Python-specifieke acties, zoals installeren van pakketten of draaien van je applicatie.pip install fastapi, python app/main.py, pip freeze > requirements.txt

Belangrijk

  • Volgorde van acties:
    1. Ga naar je CKBA-directory:bashCode kopiërencd pad/naar/ckba
    2. Activeer je venv:bashCode kopiërenvenv\Scripts\activate # Windows CMD
    3. Voer Python-gerelateerde commando’s uit.
  • Docker-commando’s:
    • Deze kun je uitvoeren zonder de venv te activeren.

Hybride Setup voor CKBA

Wat lokaal draaien?

  1. Lichte onderdelen:
    • Python-code (FastAPI-backend).
    • Kleine FAISS-vectorstore met testdata.
    • WordPress-plugin-ontwikkeling.
  2. Tools:
    • Python, Git, en Docker voor lokale ontwikkeling.

Wat extern draaien?

  1. Zware onderdelen:
    • PostgreSQL-database: Gebruik Railway of een andere VPS.
    • Productiebackend en grotere datasets: Deploy in de cloud met Docker.
  2. Externe tools:
    • Railway of DigitalOcean voor hosting.

Stap 1: Python en Git installeren

1. Python installeren

  1. Download Python:
  2. Installeer Python:
    • Zorg dat de optie “Add Python to PATH” is aangevinkt tijdens de installatie.
    • Volg de standaardinstallatieprocedure.
  3. Controleer Python-installatie: Open een terminal (Command Prompt, PowerShell of Terminal) en voer het volgende uit:bashCode kopiërenpython --version Je zou een versie moeten zien, zoals Python 3.10.x.
  4. Upgrade pip:bashCode kopiërenpython -m pip install --upgrade pip

2. Virtuele omgeving instellen

  1. Maak een projectmap aan:bashCode kopiërenmkdir ckba cd ckba
  2. Maak een virtuele omgeving:bashCode kopiërenpython -m venv venv
  3. Activeer de virtuele omgeving:
    • Windows:bashCode kopiërenvenv\Scripts\activate
    • Mac/Linux:bashCode kopiërensource venv/bin/activate
  4. Controleer of de virtuele omgeving actief is: Je ziet (venv) voor je terminalprompt.

3. Git installeren

  1. Download Git:
    • Ga naar de officiële website: Git Downloads.
    • Kies de versie die geschikt is voor jouw besturingssysteem.
  2. Installeer Git:
    • Volg de installatie-instructies. Je kunt meestal de standaardinstellingen gebruiken.
  3. Configureer Git:
    • Stel je naam en e-mail in:bashCode kopiërengit config --global user.name "Jouw Naam" git config --global user.email "jouw.email@example.com"
  4. Controleer Git-installatie:bashCode kopiërengit --version Je zou een versie moeten zien, zoals git version 2.x.x.

4. Project initialiseren in Git

  1. Initialiseer Git in je projectmap:
    • Ga naar je ckba-map en voer het volgende uit:bashCode kopiërengit init
  2. Maak een .gitignore bestand:
    • Voeg bestanden toe die je niet wilt tracken:markdownCode kopiërenvenv/ __pycache__/ *.pyc .DS_Store
  3. Commit je eerste bestanden:
    • Voeg een basisbestand toe (bijvoorbeeld README.md) en commit:bashCode kopiërenecho "# CKBA Project" > README.md git add . git commit -m "Initial commit for CKBA setup"
  4. Maak een GitHub-repository aan:
    • Ga naar GitHub en maak een nieuwe repository aan.
    • Koppel je lokale Git-repository aan de GitHub-repo:bashCode kopiërengit remote add origin https://github.com/jouw-gebruikersnaam/ckba.git git branch -M main git push -u origin main

Checklist voor Stap 1

  • Python geïnstalleerd en geconfigureerd.
  • Virtuele omgeving gemaakt en geactiveerd.
  • Git geïnstalleerd en ingesteld.
  • GitHub-repository aangemaakt en gekoppeld.