FAQ & Tipps

Kurze Antworten zu häufigen Fragen und Stolpersteinen, z. B. warum vertex nicht in den Routes auftaucht oder welcher Zeitraum ohne Datumsangabe verwendet wird.

Allgemeine Fragen

Was ist Admin Bud-E?

Admin Bud-E ist eine Open-Source-Middleware für AI-Assistenten. Sie verwaltet Nutzerzugriff, routet Anfragen an verschiedene AI-Provider (Google Vertex, Together, Mistral usw.), misst die Nutzung und verwaltet Credits.

In Kürze

Eine zentrale Verwaltung für AI-Dienste, damit einzelne Nutzer keine eigenen API-Keys brauchen.

Wer entwickelt Admin Bud-E?

LAION e. V., ein gemeinnütziger Verein, der sich für offene AI-Forschung und -Entwicklung einsetzt.

Ist Admin Bud-E kostenlos?

Ja, die Software ist Open Source (kostenlos). Kosten entstehen nur für:

Server-Hosting (VPS)
AI-Provider-Nutzung (Vertex AI, Together, etc.)

Für wen ist Admin Bud-E geeignet?

Schulen: Zentrale Verwaltung für Schüler & Lehrkräfte
Unternehmen: Team-übergreifende AI-Nutzung mit Budget-Kontrolle
Organisationen: Verwaltung mehrerer Nutzergruppen
Forschung: Kontrollierte AI-Nutzung mit detaillierten Reports

Setup & Installation

Welche Server-Größe brauche ich?

Für die meisten Setups reicht ein kleiner VPS:

2 vCPU, 4 GB RAM, 40 GB Disk für 100-500 Nutzer
4 vCPU, 8 GB RAM, 80 GB Disk für 500-2000 Nutzer

Siehe Server-Setup für Details.

Muss der Server in der EU stehen?

Für DSGVO-konforme Setups: Ja, empfohlen.

Ein EU-Server reduziert:

Grenzüberschreitende Datentransfers
Latenz zu EU-Provider-Endpunkten
Rechtliche Risiken

Siehe Datenschutz für Details.

Kann ich Admin Bud-E auf meinem lokalen PC installieren?

Technisch ja, aber nicht empfohlen.

Probleme:

Keine 24/7-Verfügbarkeit (PC muss immer laufen)
Keine öffentliche IP (Nutzer können nicht zugreifen)
Sicherheitsrisiken (Heim-Netzwerk)

Alternative: Nutzen Sie einen günstigen VPS (~€4/Monat).

Installation schlägt fehl - was tun?

Häufige Ursachen:

Python-Version zu alt

bash

python3 --version
# Sollte Python 3.9+ sein

Dependencies fehlen
bash
```
pip install -r requirements.txt
```
Berechtigungen fehlen
bash
```
sudo chown -R $USER:$USER /opt/bud-e/
```

Siehe Installation für die vollständige Anleitung.

Provider & Routen

Warum erscheint `vertex` nicht in Routes?

Häufigste Ursachen:

Tippfehler im Provider-Namen

❌ Provider-Name: "Vertex" oder "vertex-ai"
✅ Provider-Name: "vertex" (exakt kleingeschrieben)

Provider nicht gespeichert
- Klicken Sie auf Save nach dem Anlegen
- Aktualisieren Sie die Seite (F5)
Browser-Cache
- Leeren Sie den Cache (Strg+Shift+R)
- Oder öffnen Sie einen Inkognito-Tab

Provider-Name ist case-sensitive!

Der Name muss exakt übereinstimmen: vertex, nicht Vertex oder VERTEX.

Wie füge ich mehrere Provider hinzu?

Navigieren Sie zu Providers
Klicken Sie auf Add Provider für jeden Anbieter
Konfigurieren Sie jeden Provider separat

Beispiel-Setup:

Provider 1: vertex (Google Vertex AI)
Provider 2: together (Together AI)
Provider 3: mistral (Mistral AI)

Siehe Provider für Details.

Was bedeutet "Failover"?

Failover = Automatischer Wechsel zum nächsten Provider bei Fehlern.

Beispiel:

Route: LLM
  Priority 1: vertex
  Priority 2: together

Anfrage → vertex (Error 429: Rate Limit)
       → Automatischer Wechsel zu together ✅

Siehe Routen für Details.

Welchen Provider soll ich wählen?

Für EU-DSGVO-Compliance:

✅ Vertex AI (Google, EU-Regionen verfügbar)
✅ Mistral AI (EU-Unternehmen)

Für Kostenoptimierung:

✅ Together AI (oft günstiger als Vertex)
✅ Vertex Flash-Modelle (günstiger als Pro)

Für höchste Qualität:

✅ Vertex AI Gemini Pro
✅ Anthropic Claude 3.5 Sonnet (aber US-basiert)

Siehe Provider für Vergleiche.

Credits & Budgets

Was ist ein "Credit"?

Ein Credit ist die interne Abrechnungseinheit in Admin Bud-E.

Typische Konvention:

1 Credit = $0.01 (1 US-Cent)

Sie können aber auch andere Werte definieren (z.B. 1 Credit = €0.01).

Wie viel kostet eine typische Anfrage?

Grobe Richtwerte:

Anfrage-Typ	Tokens/Zeichen	Credits	Kosten
Kurze Chat-Antwort (LLM)	500 in + 200 out	0.05	$0.0005
Lange Chat-Antwort (LLM)	2000 in + 1000 out	0.20	$0.002
Bildanalyse (VLM)	1000 in + 300 out	0.15	$0.0015
TTS (Satz vorlesen)	50 Zeichen	0.001	$0.00001
ASR (10 Sek Audio)	~10 Sek	0.0003	$0.000003

Fazit: LLM ist meist der Haupt-Kostenfaktor.

Wie viele Credits braucht ein Schüler pro Monat?

Typische Werte:

Gelegentliche Nutzung: 50-100 Credits/Monat (~$0.50-$1)
Regelmäßige Nutzung: 100-200 Credits/Monat (~$1-$2)
Intensive Nutzung: 200-500 Credits/Monat (~$2-$5)

Für eine Klasse (25 Schüler):

25 Schüler × 100 Credits = 2.500 Credits/Monat
Bei $0.01/Credit = $25/Monat

Was ist der Unterschied zwischen Allowance und Credits?

	Allowance	Persönliche Credits
Vergabe	Automatisch, periodisch	Manuell vom Admin
Verfällt	Ja (am Periodenende)	Nein (dauerhaft)
Rückfluss	Ja (zu Common Pool)	Nein
Priorität	Wird zuerst verbraucht	Wird zuletzt verbraucht

Siehe Budgets & Allowance für Details.

Wie funktioniert der Common Pool?

Der Common Pool ist ein geteiltes Credit-Reservoir:

Allowance wird zuerst verbraucht
Common Pool wird als nächstes genutzt (wenn Allowance leer)
Persönliche Credits zuletzt

Beispiel:

Marie hat:
  - Allowance: 0 (aufgebraucht)
  - Common Pool: 5.000 (geteilt mit allen)
  - Persönliche: 50

Nächste Anfrage kostet 10 Credits:
→ Kommt vom Common Pool (nicht von persönlichen)

Siehe Budgets & Allowance für Details.

Usage & Reports

Welcher Zeitraum wird ohne Datum angezeigt?

Standard: Aktueller Kalendermonat

Beispiel: Heute ist 11. Oktober 2025 → Angezeigt wird: 1. Oktober - 31. Oktober 2025

Immer explizit filtern!

Für präzise Reports wählen Sie immer explizit den Zeitraum.

Wie exportiere ich Berichte?

Im Admin-Dashboard:

Navigieren Sie zu Usage
Wenden Sie Filter an (Zeitraum, Projekt, etc.)
Klicken Sie auf:
- Export PDF (einzelner Bericht)
- Export CSV (Daten für Excel)
- Export All Projects (ZIP) (alle Projekte)

Siehe Nutzungsberichte für Details.

Kann ich alte Usage-Daten löschen?

Ja, aber nicht empfohlen (außer aus Datenschutzgründen).

Warum behalten?

Audit-Trail für Abrechnung
Trend-Analyse
Rechtliche Anforderungen

Löschung:

sql

-- WARNUNG: Unwiderruflich!
sqlite3 /opt/bud-e/.../admin_bude.db
DELETE FROM usage WHERE timestamp < '2025-01-01';

Besser: Archivieren Sie alte Daten:

bash

# Export vor Löschung
sqlite3 admin_bude.db ".mode csv" ".output usage_2024.csv" "SELECT * FROM usage WHERE timestamp < '2025-01-01';"

Warum stimmen die Credits nicht?

Häufige Ursachen:

Pricing falsch konfiguriert
- Prüfen Sie die Preise unter Pricing
- Vergleichen Sie mit Provider-Preisliste
Token-Zählung unterschiedlich
- Provider zählen Tokens unterschiedlich
- Manche Modelle haben "Overhead"-Tokens
Rundungsfehler
- Admin Bud-E rundet auf 4 Dezimalstellen
- Bei sehr kleinen Beträgen kann es Differenzen geben

Siehe Preise für Details.

Problembehebung

Server antwortet nicht

Checkliste:

bash

# 1. Service läuft?
sudo systemctl status admin-bude.service

# 2. Firewall offen?
sudo ufw status
# Ports 80/443 sollten ALLOW sein

# 3. Proxy funktioniert?
curl http://localhost:8000/admin
# Sollte HTML zurückgeben

# 4. Logs prüfen
sudo journalctl -u admin-bude.service -n 50

"Out of Credits" trotz Budget

Mögliche Ursachen:

Projekt-Budget leer (nicht Nutzer-Credits!)
- Prüfen Sie Projects → Budget-Stand
Common Pool leer
- Prüfen Sie Projects → Common Pool
Allowance nicht konfiguriert
- Prüfen Sie Projects → Allowance-Einstellungen
Settlement fällig
- Klicken Sie auf Settle Now im Projekt

API-Key funktioniert nicht

Checkliste:

✅ Key korrekt kopiert? (kein Leerzeichen am Ende)
✅ Nutzer aktiv? (nicht deaktiviert)
✅ Nutzer hat Credits?
✅ Projekt hat Budget?
✅ Provider konfiguriert?

Test:

bash

curl -X POST https://ihr-server/api/test \
  -H "Authorization: Bearer sb_ihr_key_hier"

Anfragen schlagen fehl

Prüfen Sie:

Provider-Status
- Ist der Provider erreichbar?
- API-Key gültig?
Routes
- Ist mindestens ein Provider in der Route?
- Provider-Name korrekt?
Pricing
- Sind Preise für das Modell hinterlegt?

Logs

bash

sudo journalctl -u admin-bude.service -p err -n 20

Backup-Wiederherstellung schlägt fehl

Häufige Probleme:

Falsche SQLite-Version
bash
```
sqlite3 --version
# Sollte 3.x sein
```

Korrupte Backup-Datei

bash

sqlite3 backup.db "PRAGMA integrity_check;"
# Sollte "ok" ausgeben

Berechtigungen falsch

bash

sudo chown ubuntu:ubuntu admin_bude.db
sudo chmod 644 admin_bude.db

Siehe Backups für Details.

Best Practices

Wie oft sollte ich Backups machen?

Empfehlung:

Täglich: Automatische Backups
Wöchentlich: Test-Wiederherstellung
Monatlich: Externe Archivierung

Siehe Backups für Details.

Wie sicher sind die API-Keys?

API-Keys werden verschlüsselt in der Datenbank gespeichert.

Zusätzliche Sicherheit:

HTTPS-Pflicht (TLS-Verschlüsselung)
Firewall (nur Port 80/443 offen)
Key-Rotation bei Verdacht
Zugriffsbeschränkung (nur Admins sehen Keys)

Sollte ich mehrere Projekte anlegen?

Ja, empfohlen bei unterschiedlichen Nutzergruppen:

Vorteile:

✅ Separate Budgets
✅ Unterschiedliche Allowance
✅ Einfachere Reports
✅ Granulare Kontrolle

Beispiel:

Projekt "Schüler": 100 Credits/Monat Allowance
Projekt "Lehrer": 300 Credits/Monat Allowance
Projekt "Verwaltung": 500 Credits/Monat Allowance

Wie optimiere ich Kosten?

Tipps:

Günstigere Modelle nutzen

❌ Teuer: Gemini Pro (everywhere)
✅ Günstiger: Gemini Flash für einfache Aufgaben

TTS sparsam einsetzen
- TTS ist günstiger als LLM, aber bei großen Texten summiert sich's
- Option: TTS deaktivieren für Budget-kritische Projekte
Allowance anpassen
- Nutzen-basierte Allowance (Vielnutzer = mehr)
- Seasonal Adjustments (Ferien = weniger)
Common Pool nutzen
- Ungenutzte Allowance fließt zurück
- Reduziert Waste
Monitoring
- Wöchentlich Top-Nutzer prüfen
- Ausreißer identifizieren und ansprechen

Weitere Hilfe

Wo finde ich mehr Informationen?

Dokumentation:

Diese Docs: /docs/de/
English Docs: /docs/en/
GitHub: school-bud-e-middleware

Community & Support:

LAION Website: laion.ai
Blog (DE): Admin Bud-E Artikel
Blog (EN): Bud-E Release

Wie kann ich zur Entwicklung beitragen?

Admin Bud-E ist Open Source!

Möglichkeiten:

🐛 Bug-Reports auf GitHub
✨ Feature-Requests
💻 Pull Requests (Code-Beiträge)
📝 Dokumentation verbessern
🌍 Übersetzungen

GitHub: christophschuhmann/school-bud-e-middleware

Ich habe einen Bug gefunden - was tun?

Prüfen Sie: Ist es wirklich ein Bug oder ein Konfigurationsfehler?
Suchen Sie: Gibt es bereits ein Issue auf GitHub?
Erstellen Sie ein Issue:
- Beschreibung des Problems
- Schritte zur Reproduktion
- Erwartetes vs. tatsächliches Verhalten
- Logs (falls relevant)
- Version von Admin Bud-E

GitHub Issues: Neues Issue erstellen

Glossar

Begriff	Bedeutung
Admin Bud-E	Die Middleware für AI-Assistenten
API-Key	Authentifizierungsschlüssel für Nutzer
ASR	Automatic Speech Recognition (Sprache → Text)
Allowance	Periodische Credit-Gutschrift
Common Pool	Geteiltes Credit-Reservoir für Projekt
Credits	Interne Abrechnungseinheit
DPA	Data Processing Agreement (Datenverarbeitungsvertrag)
DSGVO	Datenschutz-Grundverordnung (EU)
Failover	Automatischer Wechsel bei Provider-Fehler
LLM	Large Language Model (Textmodell)
Provider	Externer AI-Dienst (Vertex, Together, etc.)
Route	Routing-Regel für Anfragen
Settlement	Allowance-Abrechnung am Periodenende
TTS	Text-to-Speech (Text → Sprache)
VLM	Vision-Language Model (Bild+Text)
VPS	Virtual Private Server

Nächste Schritte

Erkunden Sie die vollständige Dokumentation:

Einführung - Grundkonzepte verstehen
Server-Setup - Server planen
Installation - Admin Bud-E installieren
Vertex AI - Google Cloud konfigurieren
Provider - Provider hinzufügen
Routen - Routing konfigurieren
Preise - Pricing hinterlegen
Benutzer - Nutzer verwalten
Projekte - Projekte strukturieren
Budgets - Budget-System verstehen
Usage - Berichte analysieren
Datenschutz - DSGVO-Compliance
Backups - Datensicherung einrichten
Wartung - Regelmäßige Wartung

FAQ & Tipps ​

Allgemeine Fragen ​

Was ist Admin Bud-E? ​

Wer entwickelt Admin Bud-E? ​

Ist Admin Bud-E kostenlos? ​

Für wen ist Admin Bud-E geeignet? ​

Setup & Installation ​

Welche Server-Größe brauche ich? ​

Muss der Server in der EU stehen? ​

Kann ich Admin Bud-E auf meinem lokalen PC installieren? ​

Installation schlägt fehl - was tun? ​

Provider & Routen ​

Warum erscheint vertex nicht in Routes? ​

Wie füge ich mehrere Provider hinzu? ​

Was bedeutet "Failover"? ​

Welchen Provider soll ich wählen? ​

Credits & Budgets ​

Was ist ein "Credit"? ​

Wie viel kostet eine typische Anfrage? ​

Wie viele Credits braucht ein Schüler pro Monat? ​

Was ist der Unterschied zwischen Allowance und Credits? ​

Wie funktioniert der Common Pool? ​

Usage & Reports ​

Welcher Zeitraum wird ohne Datum angezeigt? ​

Wie exportiere ich Berichte? ​

Kann ich alte Usage-Daten löschen? ​

Warum stimmen die Credits nicht? ​

Problembehebung ​

Server antwortet nicht ​

"Out of Credits" trotz Budget ​

API-Key funktioniert nicht ​

Anfragen schlagen fehl ​

Backup-Wiederherstellung schlägt fehl ​

Best Practices ​

Wie oft sollte ich Backups machen? ​

Wie sicher sind die API-Keys? ​

Sollte ich mehrere Projekte anlegen? ​

Wie optimiere ich Kosten? ​

Weitere Hilfe ​

Wo finde ich mehr Informationen? ​

Wie kann ich zur Entwicklung beitragen? ​

Ich habe einen Bug gefunden - was tun? ​

Glossar ​

Nächste Schritte ​

FAQ & Tipps

Allgemeine Fragen

Was ist Admin Bud-E?

Wer entwickelt Admin Bud-E?

Ist Admin Bud-E kostenlos?

Für wen ist Admin Bud-E geeignet?

Setup & Installation

Welche Server-Größe brauche ich?

Muss der Server in der EU stehen?

Kann ich Admin Bud-E auf meinem lokalen PC installieren?

Installation schlägt fehl - was tun?

Provider & Routen

Warum erscheint `vertex` nicht in Routes?

Wie füge ich mehrere Provider hinzu?

Was bedeutet "Failover"?

Welchen Provider soll ich wählen?

Credits & Budgets

Was ist ein "Credit"?

Wie viel kostet eine typische Anfrage?

Wie viele Credits braucht ein Schüler pro Monat?

Was ist der Unterschied zwischen Allowance und Credits?

Wie funktioniert der Common Pool?

Usage & Reports

Welcher Zeitraum wird ohne Datum angezeigt?

Wie exportiere ich Berichte?

Kann ich alte Usage-Daten löschen?

Warum stimmen die Credits nicht?

Problembehebung

Server antwortet nicht

"Out of Credits" trotz Budget

API-Key funktioniert nicht

Anfragen schlagen fehl

Backup-Wiederherstellung schlägt fehl

Best Practices

Wie oft sollte ich Backups machen?

Wie sicher sind die API-Keys?

Sollte ich mehrere Projekte anlegen?

Wie optimiere ich Kosten?

Weitere Hilfe

Wo finde ich mehr Informationen?

Wie kann ich zur Entwicklung beitragen?

Ich habe einen Bug gefunden - was tun?

Glossar

Nächste Schritte