Snelstartgids
Begin binnen 10 minuten met het implementeren van AI-applicaties op Cordatus. Deze pagina is een eenvoudige handleiding. Volg voor de volledige stappen, screenshots en video's de links in elke sectie.
Vereisten
- Een Cordatus-account met de juiste rechten
- Minstens één apparaat verbonden met Cordatus (status: Online of Connected)
- Een apparaat met GPU-ondersteuning (aanbevolen voor LLM-applicaties)
- De Cordatus Client geïnstalleerd en actief op uw apparaat
Heeft u nog geen apparaat verbonden? Doorloop dan eerst de Device Hub Quickstart.
Aan de slag in 10 minuten
1. Beschikbare applicaties bekijken (1 minuut)
- Ga naar Containers > Applications in het linkermenu
- Blader door de applicatiecatalogus:
- vLLM (LLM-inference met hoge doorvoer)
- TensorRT-LLM (geoptimaliseerde NVIDIA-inference)
- Ollama (eenvoudige lokale modellen)
- NVIDIA Dynamo (gedistribueerd, meerdere GPU's)
- NVIDIA VSS (video-analyse)
- Klik op een applicatie om de detailpagina te bekijken
- Controleer de ondersteunde platforms en beschikbare Docker-image-versies
Volledige details → Application Launch Guide
2. Uw eerste applicatie starten (3 minuten)
Voorbeeld: vLLM implementeren met een klein model
- Klik op Start Application op de detailpagina van vLLM
- Selecteer apparaat: kies uw verbonden apparaat
- Selecteer versie: kies de nieuwste Docker-image-versie
- Groen vinkje = al gedownload
- Downloadpictogram = wordt nog gedownload
- Klik op Next om naar Advanced Settings te gaan
Volledige details → Application Launch Guide - Sectie 4
3. Basisinstellingen configureren (3 minuten)
-
Algemene instellingen:
- Environment Name: laat leeg voor een automatisch gegenereerde naam (of voer een aangepaste naam in, zoals
vllm-llama2-7b) - Select GPU: kies All GPU of selecteer specifieke GPU's
- Resource Limits: houd de standaardwaarden aan (of pas de CPU-/RAM-limieten aan)
- Enable Open Web UI: vink dit vakje aan (creëert automatisch een chatinterface)
- Environment Name: laat leeg voor een automatisch gegenereerde naam (of voer een aangepaste naam in, zoals
-
Modelselectie:
- Ga naar het tabblad Cordatus Models
- Zoek naar
llama-2-7bof kies een ander klein model (7B of 13B aanbevolen voor uw eerste implementatie) - Klik op het model om het te selecteren
-
Overige instellingen (nu overslaan):
- Docker Options: automatisch geconfigureerd
- Environment Variables: vooraf ingevuld met standaardwaarden
- Engine Arguments: geoptimaliseerd voor het geselecteerde model
Volledige details → Application Launch Guide - Sectie 5
4. De container starten (1 minuut)
- Klik op de knop Start Environment (rechtsonder)
- Voer uw sudo-wachtwoord in wanneer daarom wordt gevraagd
- Bevestig het downloaden als de Docker-image nog gedownload moet worden
- Wacht tot de implementatie voltooid is (1-5 minuten, afhankelijk van de grootte van de image)
Wat er op de achtergrond gebeurt:
- Cordatus verbindt met uw apparaat
- Downloadt de Docker-image (indien nodig)
- Maakt de container aan en start deze
- Configureert netwerken en volumes
- Start de Open Web UI-container (indien ingeschakeld)
Volledige details → Application Launch Guide - Sectie 6
5. De implementatie verifiëren (2 minuten)
- Ga naar Containers > Containers in het linkermenu
- Zoek uw nieuw aangemaakte containergroep
- Controleer of de status Running weergeeft
- Klik op See the Container Informations (menu met drie puntjes)
- Controleer het tabblad Logs — u zou berichten over het laden van het model moeten zien
- Ga naar het tabblad Ports en kopieer de lokale URL
Toegang tot uw applicatie:
- API-endpoint: open de lokale URL in de browser (toont de API-documentatie)
- Open Web UI: indien ingeschakeld, zoek de tweede container in de groep en open de bijbehorende URL
- Testen met curl:
curl http://localhost:8000/v1/models
Volledige details → Container Management Guide - Sectie 3.6
Verwacht resultaat
Na het voltooien van deze stappen zou u het volgende moeten hebben:
-
Container actief
- Status: Running (groene indicator)
- Logs tonen dat het model succesvol is geladen
- API-endpoint toegankelijk via de lokale URL
-
Open Web UI actief (indien ingeschakeld)
- Tweede container in de groep toont Running
- Chatinterface toegankelijk via de browser
- Berichten verzenden en AI-antwoorden ontvangen is mogelijk
-
Applicatie in de containerlijst
- Zichtbaar onder Containers > Containers
- Containergroep correct georganiseerd
- Alle onderdelen zijn gezond
Wat is de volgende stap?
VRAM Calculator ontdekken (5 minuten)
Bereken de VRAM-vereisten voordat u grotere modellen implementeert:
- Ga naar VRAM Calculator in het hoofdmenu
- Model selecteren: kies een groter model (bijv. Llama-2-70B)
- GPU selecteren: kies uw GPU-model
- Resultaten controleren: kijk of de VRAM voldoende is
- Instellingen aanpassen: probeer verschillende quantization-niveaus (INT8, INT4)
U leert:
- Geheugenvereisten berekenen voorafgaand aan de implementatie
- Verschillende quantization-opties vergelijken
- De optimale batchgrootte en sequentielengte bepalen
- Implementaties met meerdere GPU's plannen
Volledige details → VRAM Calculator User Guide
Uw eigen modellen toevoegen (10 minuten)
Gebruik modellen die u al op uw apparaat hebt gedownload:
-
Modelpaden configureren:
- Verbind met uw apparaat
- Ga naar Metrics > Model Info
- Definieer paden voor Huggingface, Ollama of NVIDIA NIM
-
Scannen naar modellen:
- Ga naar de pagina LLM Models
- Klik op Explore Models on Your Device
- Klik op Start Scanning
- Selecteer modellen om toe te voegen aan Cordatus
-
User Model implementeren:
- Ga naar het tabblad LLM Models > User Models
- Klik op Deploy naast een model
- Selecteer de inference-engine
- Configureer en start
Volledige details → User Models and Model Transfer Guide
Geavanceerde applicaties implementeren (15-30 minuten)
Probeer complexere implementaties:
NVIDIA AI Dynamo (gedistribueerde inference met meerdere GPU's):
- Configureer de verwerkingsmodus (Aggregated/Disaggregated)
- Stel de routerstrategie in (KV-Aware aanbevolen)
- Maak meerdere workers aan met GPU-toewijzingen
- Start de gedistribueerde inference-pipeline
Volledige details → NVIDIA AI Dynamo Creation Guide
NVIDIA VSS (video-analyse):
- Configureer de hoofdcontainer VSS
- Stel de componenten VLM, LLM, Embed en Rerank in
- Kies ervoor om nieuwe componenten te maken of bestaande te gebruiken
- Implementeer de volledige videoanalysepipeline
Volledige details → NVIDIA VSS Creation Guide
Uw containers beheren (5 minuten)
Leer de containerbeheer-bewerkingen:
-
Containers starten/stoppen:
- Klik op de knoppen Start/Stop voor een container
- Selecteer meerdere containers voor bulkbewerkingen
-
Containerinformatie bekijken:
- Volg realtime logs
- Bekijk configuratieparameters
- Controleer poort-mappings
-
Openbare URL's genereren:
- Maak uw applicaties extern toegankelijk
- Deel toegang met teamleden
-
Open Web UI creëren:
- Voeg een chatinterface toe aan bestaande LLM-containers
- Genereer openbare URL's om te delen
-
Containers dupliceren:
- Kopieer bestaande configuraties
- Pas instellingen aan en implementeer opnieuw
Volledige details → Container Management Guide
Snelle tips voor probleemoplossing
Container start niet:
- Controleer of de apparaatstatus Connected is
- Controleer of de GPU beschikbaar en niet in gebruik is
- Bekijk de containerlogs voor foutmeldingen
- Zorg voor voldoende schijfruimte voor de Docker-image
Onvoldoende VRAM-foutmelding:
- Gebruik de VRAM Calculator om de vereisten te controleren
- Probeer een lagere quantization (FP16 → INT8 → INT4)
- Verlaag de batchgrootte of sequentielengte
- Voeg meer GPU's toe of gebruik een kleiner model
Model niet gevonden:
- Voor Custom Models: controleer of de modelnaam correct is
- Voor User Models: controleer of de modelpaden zijn geconfigureerd
- Controleer of het model toegankelijk is vanuit de container
- Bekijk de volume-mappings in Docker Options
Open Web UI werkt niet:
- Controleer of de container actief is
- Controleer of de poort niet al in gebruik is
- Bekijk de logs van de Open Web UI-container
- Zorg voor netwerkconnectiviteit tussen containers
Snel overzicht
Applicatietypes
| Type | Toepassing | Complexiteit | Opzettijd |
|---|---|---|---|
| Standard Apps | Eenvoudige containers | Laag | 5 min |
| LLM Engines | Model-inference | Gemiddeld | 5 min |
| NVIDIA Dynamo | Gedistribueerd met meerdere GPU's | Hoog | 5 min |
| NVIDIA VSS | Video-analyse | Hoog | 10 min |
Aanbevolen GPU-geheugen
| Modelgrootte | Quantization | Minimale VRAM | Aanbevolen GPU |
|---|---|---|---|
| 7B | INT4 | 4-6 GB | RTX 3090, RTX 4090 |
| 7B | INT8 | 8-10 GB | RTX 4090, A10 |
| 13B | INT4 | 8-10 GB | RTX 4090, A10 |
| 13B | INT8 | 14-16 GB | A10, A100 40GB |
| 70B | INT4 | 40-50 GB | A100 80GB, 2x A100 40GB |
| 70B | INT8 | 80-90 GB | A100 80GB, 2x A100 80GB |
Belangrijkste snelkoppelingen
- Containers > Applications: blader door de applicatiecatalogus
- Containers > Containers: beheer actieve containers
- LLM Models: toegang tot Cordatus Models en User Models
- VRAM Calculator: berekening van geheugenvereisten
- Device Metrics: bekijk GPU-/CPU-/RAM-gebruik
Hulp nodig?
Voor gedetailleerde documentatie met screenshots en video's:
- Application Launch Guide
- NVIDIA AI Dynamo Guide
- NVIDIA VSS Guide
- User Models Guide
- Container Management Guide
- VRAM Calculator Guide