Videoübersicht

Anforderungen

Hardware

Speicherplatz

Linux
Downloadgröße
7 GB
Entpackte Größe
10 GB
Zusätzlicher Speicherplatz für die Installation
10 GB
Windows
Downloadgröße
2.5 GB
Entpackte Größe
4 GB
Zusätzlicher Speicherplatz für die Installation
4 GB
Zusätzlicher Speicherplatz
Embedding-Modell
4.5 GB
LLM (Google Gemma 3 27b)
17 GB
Speicher für Datenbanken und temporäre Dateien
je nach Größe Ihrer Daten

Linux

  • 64-Bit (Kernel 3.2+, glibc 2.17+)

  • Möglicherweise müssen Sie die folgenden Bibliotheken über den Paketmanager Ihrer Distribution installieren: libgl1 libmagic1. Auf einem Debian- oder Ubuntu-System können Sie dies mit sudo apt install libgl1 libmagic1 tun.

Windows

Fehlerbehebung: Pfadlänge zu lang Wenn der Fehler Could not install packages due to an OSError: [WinError 206] Der Dateiname oder die Erweiterung ist zu lang auftritt, müssen Sie die Unterstützung für lange Dateipfade in Windows aktivieren:

  1. Drücken Sie Win + R, geben Sie regedit ein und drücken Sie Enter.

  2. Navigieren Sie zu HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem.

  3. Suchen Sie den Wert LongPathsEnabled und machen Sie einen Doppelklick darauf. (Falls nicht vorhanden: Rechtsklick in einen leeren Bereich, Neu > DWORD-Wert (32-Bit) wählen und LongPathsEnabled nennen).

  4. Setzen Sie den Wert auf 1 und klicken Sie auf OK.

Beschaffung, Installation und Start

  1. Laden Sie die Version für Ihre Plattform von https://learn2rag.de/downloads herunter.

  2. Extrahieren Sie das Archiv. Sie müssen dieses Verzeichnis behalten, um Learn2RAG auszuführen.

unzip learn2rag-linux.zip
cd learn2rag-linux
  1. Führen Sie die Datei namens start entweder mit einem rechten Mausklick und “Ausführen” oder in einem Terminal aus.
./start

🛈 Beim ersten Start werden die Python-Umgebung und die Abhängigkeiten vorbereitet, was einige Zeit in Anspruch nehmen kann. Erwartete Dauer für den ersten Start: | Leistungsstarker Server | 10 Min |

Konfiguration

Die Konfiguration der Learn2RAG Software ist als Weboberfläche gestaltet und kann über den Browser geöffnet werden. Dies sollte nach Ausführung des Start-Befehls automatisch geschehen. Falls dies nicht geschieht finden Sie in der Ausgabe des Start-Befehls die URL, die Sie mit ihrem Browser öffnen können, um die Benutzeroberfläche zur Konfiguration zu öffnen.

Die Oberfläche des Konfigurators ist in 3 Bereiche eingeteilt: Sprachmodelle, Datenquellen, und Pipelines. Zusätzlich wird beim ersten Starten ein Assistent im oberen Bereich angezeigt, der bei der Erstellung einer ersten RAG Pipeline unterstützt. Diese Assistent und die 3 einzelnen Bereiche werden im Folgenden näher betrachtet.

Learn2RAG beinhaltet englische und deutsche Lokalisierungen der Benutzeroberfläche. Die Lokalisierung wird gemäß den Einstellungen Ihres Webbrowsers ausgewählt. Weitere Details finden Sie in der Dokumentation Ihres Webbrowsers.

Oberflächensprache

Learn2RAG beinhaltet englische und deutsche Lokalisierungen der Benutzeroberfläche. Die Lokalisierung wird gemäß den Einstellungen Ihres Webbrowsers ausgewählt. Weitere Details finden Sie in der Dokumentation Ihres Webbrowsers.

Assistent für den ersten Start

Beim ersten Start, bevor Sie Konfigurationen erstellt haben, wird ein Assistent im oberen Bereich der Seite angezeigt. Dieser hilft Ihnen dabei in wenigen Schritten eine einfache RAG Pipeline zu erstellen. Folgen Sie einfach den vorgegebenen Schritten, um eine grundlegende Beispielkonfiguration einzurichten.

Sprachmodelle

Herunterladbare Sprachmodelle

Learn2RAG kann ein Sprachmodell herunterladen und bereitstellen. Dies geschieht mit Ollama, das automatisch gestartet wird.

Eine kurze Liste empfohlener Sprachmodelle zum Herunterladen wird für einen schnellen Start bereitgestellt. Sie können aber auch jedes andere von Ollama unterstützte Modell auswählen. Eine Übersicht über verfügbare Modelle finden Sie unter: https://ollama.com/library.

🛈 Beachten Sie bitte, dass einige Modelle hohe Anforderungen an die zur Verfügung gestellt Hardware haben können.

Externe Sprachmodelle

Ein externes (lokales oder Remote-) Sprachmodell kann verwendet werden, wenn es über eine OpenAI- oder Ollama-kompatible API verfügbar ist. Sie benötigen eine API-URL und (falls erforderlich) ein Zugriffstoken.

OpenAI’s ChatGPT
API-Typ
ChatOpenAI
API-URL
(leer lassen)
Zugriffstoken
<Ihr Token>
Sprachmodell
gpt-4o oder ein anderes OpenAI Modell

Herunterladbare Sprachmodelle

Learn2RAG kann ein Sprachmodell herunterladen und bereitstellen. Dies geschieht mit Ollama, das automatisch gestartet wird.

Eine kurze Liste empfohlener Sprachmodelle zum Herunterladen wird für einen schnellen Start bereitgestellt. Sie können aber auch jedes andere von Ollama unterstützte Modell auswählen. Eine Übersicht über verfügbare Modelle finden Sie unter: https://ollama.com/library.

🛈 Beachten Sie bitte, dass einige Modelle hohe Anforderungen an die zur Verfügung gestellte Hardware haben können.

Air-Gapped- / Offline-Umgebungen

Wenn der Zielrechner keinen Internetzugang hat, können Sie Modelle nicht über den integrierten Assistenten herunterladen. Sie müssen Ollama und die Modelldateien manuell übertragen. Eine Schritt-für-Schritt-Anleitung finden Sie im Leitfaden zur Offline-Einrichtung von Ollama.

Datenquellen

In diesem Untermenü werden existierende Datenquellen aufgeführt und es können neue Quellen konfiguriert werden. Dabei hat eine Datenquelle grundsätzlich einen Namen, den Sie frei wählen können, um später die Quelle auswählen zu können.

Datenquelle Unterstützt Nutzerrechte unterstützt
Dateisystem Ja Nein
Webseiten Ja Nein
Microsoft Ja Nein
Drupal Ja Ja

Details zu den unterstützten Datenquellen finden sie hier

Auf dieser Seite werden die Datenquellen lediglich konfiguriert. Das Abrufen der eigentlichen Daten von der Quelle erfolgt in einem späteren Schritt, nachdem eine Pipeline konfiguriert und der Datenimport gestartet wurde.

Pipelines

Auf dieser Seite können sie eine oder mehrere RAG Pipelines konfigurieren, starten und stoppen.

Minimale Konfiguration

Um eine Pipeline zu erstellen, müssen Sie das Speicherverzeichnis angeben, in dem das System alle zugehörigen Daten speichert, und auswählen, welches konfigurierte Sprachmodelle und welche Datenquellen verwendet werden sollen.

Hinweis: Standardmäßig befindet sich der Pipeline-Speicherpfad im Benutzerdatenverzeichnis des Benutzers, der Learn2RAG ausführt (siehe Datenspeicherorte). Es kann jedoch jeder zugängliche Pfad auf Ihrem System verwendet werden.

Optionale Konfiguration

Ports

Sie können angeben, welche Ports die Pipeline-Komponenten verwenden sollen. Ansonsten wird die Software automatisch Ports auswählen.

Datenimport

Sie können über eine Checkbox festlegen, ob der Datenimport direkt nach der Konfiguration der Pipeline ausgeführt werden soll. Der Import kann zu jeder Zeit separat gestartet werden (siehe unten).

Verwendung

Nachdem eine Pipeline konfiguriert wurde, können Sie diese Pipeline nun steuern. Dabei sollte zunächst der Datenimport gestartet werden, da die Pipeline sonst keinerlei Daten für ihre Arbeit hat.

configurator pipeline start

Datenimport

Sobald der Import gestartet wurde verarbeitet die Pipeline alle Daten der ausgewählten Datenquellen. Nach dem Start des Imports müssen Sie warten, bis dieser abgeschlossen ist.

Hinweis: Der Import großer Datenmengen kann sehr viel Zeit in Anspruch nehmen.

Starten der Pipeline

Durch die Auswahl eine Pipeline zu starten werden die erforderlichen Komponenten der Pipeline erzeugt und gestartet.

Nach dem Start können Sie die Schaltfläche “Open” (Öffnen) verwenden, um die Benutzeroberfläche für die RAG Pipeline zu öffnen. Für Details zur Benutzeroberfläche verweisen wir auf das Benutzerhandbuch.

Die Pipeline kann aber auch über eine API in bestehende Software eingebunden werden.

Aktualisierung

  1. Führen Sie die Datei namens uninstall aus.

  2. Laden Sie die neue Version der Learn2RAG Software herunter.

  3. Installieren Sie diese Version wie oben beschrieben.

Deinstallation

Führen Sie die Datei namens uninstall aus. Dadurch werden automatisch erstellte Anwendungsdateien entfernt, Ihre Konfigurationsdaten und heruntergeladenen Modelle jedoch an ihrem Speicherort belassen.

Datenspeicherorte

Linux

$XDG_DATA_HOME/pyapp/ (~/.local/share/pyapp/)
Anwendungsdaten
$XDG_DATA_HOME/Learn2RAG/ (~/.local/share/Learn2RAG/)
Benutzerdaten

Windows

%LOCALAPPDATA%\pyapp\data\
Anwendungsdaten
%LOCALAPPDATA%\Learn2RAG\
Benutzerdaten

Erweiterte Konfiguration

Sie können eine Datei config.yml neben der Datei start erstellen, um die Konfigurationsoberfläche anzupassen.

Ein Beispiel mit allen unterstützten Optionen:

flask:
  # Anwendungspfad für Benutzerdaten, Downloads (LLMs)
  # Wird auch als Standardspeicherpfad verwendet
  instance_path: '/data/learn2rag'
UI:
  # Administrationsoberfläche für andere in einem beliebigen Netzwerk verfügbar machen (oder das eigene angeben)
  host: '0.0.0.0'
  port: 9000
SIMPLE_AUTH:
  # Anmeldeinformationen für die Administrationsoberfläche
  username: admin
  password: 123
CHAT:
  # Chat-Oberfläche für andere in einem beliebigen Netzwerk verfügbar machen (oder das eigene angeben)
  host: '0.0.0.0'
  # Anmeldeinformationen für die Benutzeroberfläche
  username: user
  password: 456
TLS:
  KEYFILE: '/absolute/path/key.pem'
  CERTFILE: '/absolute/path/fullchain.pem'
logging:
  # Detaillierte Debug-Protokolle anzeigen und speichern
  debug: true
# Ports, die standardmäßig für zusätzliche Dienste bevorzugt werden
PREFERRED_PORTS:
  - 5001
  - 5002
  - 5003
SUGGESTED_MODELS:
  local-chat:
    label: Lokale LLM Konfiguration
    description: Fügen Sie hier weitere Informationen ein.
    config:
      api: ChatOpenAI
      url: https://example.com/api
      model: gemma-3-27b-it
      token: xxx

Fehlerbehebung

Anwendungs- und Benutzerdatenspeicher entfernen

<#datenspeicherorte>

Table of contents

This site uses Just the Docs, a documentation theme for Jekyll.