v1.0.0 GitHub ← Hauptseite
Dokumentation · Aktuell

KI DEVment Dokumentation

Vollständiger Leitfaden zur Installation, Konfiguration und Verwendung der KI DEVment Plattform – von den ersten Schritten bis zum Deployment.

📖 Willkommen bei KI DEVment

KI DEVment ist eine Python-basierte Plattform, die ein vollständig automatisiertes KI-Entwicklerteam simuliert. Sie koordiniert 10 spezialisierte KI-Agenten, die zusammenarbeiten, um Ihre Softwareprojekte automatisch zu planen, zu entwickeln, zu testen und bereitzustellen.

Diese Dokumentation führt Sie durch jeden Aspekt der Plattform – von der Installation über die Konfiguration bis hin zum produktiven Einsatz.

💡

Tipp: Falls Sie nur schnell loslegen möchten, springen Sie direkt zum Abschnitt Schnellstart.

📥 Installation

Systemanforderungen

  • Betriebssystem: Windows 10/11, macOS oder Linux
  • Python: Version 3.10 oder höher (3.11+ empfohlen)
  • RAM: Mindestens 4 GB (8 GB empfohlen)
  • Speicher: 500 MB frei (1 GB empfohlen)
  • Ollama (optional): Für lokale KI – mindestens 2 GB RAM zusätzlich

Schritt 1 – Download & Verzeichnis

Terminal
# Verzeichnis wechseln
cd "KI DEVment"

Schritt 2 – Abhängigkeiten installieren

Terminal
pip install -r requirements.txt

Schritt 3 – Ollama installieren (optional)

Ollama ermöglicht es, KI-Modelle vollständig lokal auszuführen – ohne Internet und ohne Kosten.

ℹ️

Besuchen Sie ollama.ai und laden Sie das Installationspaket für Ihr Betriebssystem herunter.

Terminal – Modell herunterladen
ollama pull llama3
ollama pull mistral
ollama pull codellama

Schritt 4 – Anwendung starten

Terminal
python main.py

Als EXE kompilieren (Windows)

Terminal
python compile.py
💡

Tipp: Die kompilierte EXE-Datei kann ohne Python-Installation auf dem Zielrechner ausgeführt werden.

Schnellstart

Der schnellste Weg, um Ihr erstes Projekt mit KI DEVment zu erstellen:

  1. Starten Sie KI DEVment mit python main.py
  2. Beschreiben Sie Ihr Projekt in natürlicher Sprache im Eingabefeld
  3. Klicken Sie „Projekt starten" – die Plattform analysiert Ihre Beschreibung
  4. Beobachten Sie die Agenten beim Arbeiten im Live-Dashboard
  5. Projekt fertig! Die Anwendung wurde automatisch erstellt und kann optional per FTP bereitgestellt werden
⚠️

Hinweis: Stellen Sie sicher, dass Ollama läuft (ollama serve), bevor Sie ein Projekt starten – andernfalls kann die lokale KI nicht verwendet werden.

Beispiel-Prompt

Projekt-Beschreibung
"Erstelle eine einfache To-Do-Liste Webanwendung
mit MySQL-Datenbank, einem modernen Frontend
und einer REST-API im Backend."

🏗️ Architektur – Übersicht

KI DEVment basiert auf einer Multi-Agenten-Architektur. Eine zentrale Steuerungsplattform koordiniert spezialisierte Agenten, die jeweils eine klare Verantwortlichkeit haben.

Kommunikationsfluss

  1. Eingabe: Der Benutzer beschreibt sein Projekt in natürlicher Sprache
  2. Analyse: Die Smart-Prompt-Analysis bewirtet die Komplexität und bestimmt benötigte Agenten
  3. Orchestrierung: Der Projekt-Koordinator weist Aufgaben den Agenten zu
  4. Entwicklung: Agenten arbeiten parallel und kommunizieren sich gegenseitig
  5. Testing: Der Betatest-Agent validiert die Ergebnisse im eingebetteten Browser
  6. Deployment: Der FTP-Manager übertragen die fertigen Dateien auf den Server
ℹ️

Intelligente Agenten-Auswahl: Nicht alle 10 Agenten werden bei jedem Projekt aktiviert. Die Plattform wählt nur die Agenten aus, die tatsächlich benötigt werden – maximale Effizienz, minimale Ressourcen.

🤖 KI-Agenten

Die 10 Agenten bilden das Herzstück von KI DEVment. Jeder Agent hat eine klare Spezialisierung und arbeitet eigenständig innerhalb seiner Verantwortlichkeit.

AgentFunktionSpezialisierung
🎯 KoordinatorGesamtsteuerungPlanung & Strategie
⚙️ Code-GeneratorProgrammlogikAlgorithmen & Strukturen
🎨 FrontendOberflächenHTML, CSS, JS
🖥️ BackendServer-LogikAPIs, Datenverarbeitung
🗄️ DatenbankDB-ManagementMySQL, PostgreSQL, SQLite
🧪 TesterQualitätssicherungUnit & Integration Tests
📊 MonitorÜberwachungPerformance & Sicherheit
📤 FTP-ManagerDeploymentUpload & Übertragung
🔧 PHP-EntwicklerPHP-GenerierungServer-side Skripte
🌐 BetatestBrowser-TestsEnd-to-End Validierung

🎯 Projekt-Koordinator

Der Koordinator ist der Kern der Orchestrierung. Er analysiert eingehende Projekteinforderungen, erstellt einen Aktionsplan und weist Teilaufgaben den entsprechenden Agenten zu. Er überwacht den Gesamtfortschritt und löst bei Bedarf Eskalationen aus.

⚙️ Code-Generator

Erzeugt die Kernlogik einer Anwendung: Algorithmen, Datenstrukturen und Programmlogik. Arbeitet eng mit Frontend- und Backend-Agenten zusammen, um konsistenten Code zu produzieren.

🎨 Frontend-Entwickler

Erstellt Benutzeroberflächen mit HTML5, CSS3 und JavaScript. Unterstützt moderne CSS-Frameworks und responsives Design. Gibt die fertigen Dateien an den Betatest-Agenten weiter.

🖥️ Backend-Entwickler

Entwickelt server-seitige Logik, RESTful-APIs und Datenverarbeitungspipelines. Arbeitet mit Python und kann optional Node.js-Komponenten integrieren.

🗄️ Datenbank-Architekt

Designt und verwaltet Datenbankstrukturen für MySQL, PostgreSQL und SQLite. Erstellt automatisch Tabellen, Indizes und Relationen basierend auf Projektanforderungen.

🧪 Test-Automatisierer

Erstellt und führt Unit-Tests und Integrationstests aus. Identifiziert Fehler und leitet Korrekturen an den zuständigen Agenten weiter.

📊 Produktions-Monitor

Überwacht die Qualität und Stabilität der entwickelten Software. Prüft auf Performance-Probleme und potenzielle Sicherheitslücken vor dem Deployment.

📤 FTP-Manager

Übernimmt die automatische Dateiübertragung auf den Webserver. Unterstützt FTP und SFTP mit TLS-Verschlüsselung. Kann einzelne Dateien oder ganze Verzeichnisse hochladen.

🔧 PHP-Entwickler

Generiert PHP-Dateien für server-seitige Operationen: Datenbankverbindungen, Tabellenerstellung und Schnittstellen. Die generierten Dateien werden automatisch per FTP übertragen.

🌐 Betatest-Agent

Nutzt einen eingebetteten Chromium-Browser (via PyQt6 WebEngine) zur automatisierten End-to-End-Tests. Extrahiert Fehlermeldungen aus Logs, analysiert Probleme und leitet Korrekturen weiter.

🧠 KI-Einrichtung

Option A – Ollama (Lokal, empfohlen)

Ollama führt KI-Modelle vollständig auf Ihrem Rechner aus – keine Internetverbindung, keine Kosten, maximale Datenschutz.

Terminal – Ollama starten
ollama serve    # Server starten
ollama pull llama3     # Modell laden
ollama list        # Verfügbare Modelle anzeigen

Unterstützte Modelle

  • Llama 3 – Allgemeines Sprachmodell
  • Mistral – Schnell & effizient
  • CodeLlama – Spezialisiert auf Code

Option B – OpenAI (Cloud, optional)

Falls Sie eine Cloud-basierte KI bevorzugen, kann OpenAI konfiguriert werden. Dafür ist ein API-Key erforderlich.

⚠️

Hinweis: Bei der Verwendung von OpenAI werden Ihre Daten an die OpenAI-Server gesendet. Für datenschutzrelevante Projekte empfehlen wir Ollama.

📤 FTP-Konfiguration

Der FTP-Manager ermöglicht eine automatische Dateiübertragung auf Ihren Webserver.

Erforderliche Angaben

  • Server-Adresse: z. B. ftp.ihrewebsite.de
  • Benutzername: Ihr FTP-Benutzername
  • Passwort: Ihr FTP-Passwort
  • Port: Standard 21 (FTP) oder 22 (SFTP)
  • Zielverzeichnis: z. B. /var/www/html/
💡

Tipp: Die Übertragung verwendet TLS-Verschlüsselung, um Ihre Zugangsdaten zu schützen. Bevorzugen Sie SFTP, falls von Ihrem Hosting-Anbieter angeboten.

🗄️ Datenbank-Setup

KI DEVment unterstützt drei Datenbanksysteme und kann automatisch Strukturen und Tabellen erstellen.

Unterstützte Systeme

  • MySQL / MariaDB – Ideal für Webhosting
  • PostgreSQL – Erweiterte Features & Skalierung
  • SQLite – Dateibasiert, keine Server nötig

Verbindungsparameter

  • Host: Datenbankserver (z. B. localhost)
  • Port: Standard 3306 (MySQL) oder 5432 (PostgreSQL)
  • Datenbank: Name Ihrer Datenbank
  • Benutzer & Passwort
ℹ️

Der PHP-Entwickler-Agent generiert automatisch PHP-Dateien für die Datenbankverbindung und Tabellenerstellung – diese werden per FTP direkt auf Ihren Server übertragen.

✍️ Prompt-Leitfaden

Die Qualität Ihrer Projektbeschreibung beeinflusst direkt das Ergebnis. Hier sind Tipps für bessere Prompts:

✓ Gute Praktiken

  • Seien Sie konkret: Beschreiben Sie Funktionen, nicht nur das Ziel
  • Technologie angeben: „mit MySQL" oder „React Frontend"
  • Umfang begrenzen: Beginnen Sie mit kleinen Projekten
  • Beispiele geben: „Ähnlich wie eine To-Do-Liste, aber mit…"

✕ Zu vermeiden

  • Zu vague: „Erstelle eine App" – zu wenig Information
  • Zu komplex auf einmal: Teilen Sie große Projekte in Teilprojekte auf
Beispiel – Guter Prompt
"Erstelle eine Aufgabenverwaltung mit:
- MySQL-Datenbank für Aufgaben & Benutzer
- REST-API im Backend (Python/Flask)
- Modernes Frontend mit Karten-Layout
- Login/Logout Funktionalität
- FTP-Deployment auf meinen Server"

🔄 Workflow

Der typische Workflow von Eingabe bis Ergebnis:

  1. Prompt Eingabe – Sie beschreiben Ihr Projekt
  2. Smart Analysis – Komplexität wird bewertet, Agenten werden ausgewählt
  3. Planning Phase – Der Koordinator erstellt einen Aktionsplan
  4. Development Phase – Agenten arbeiten parallel an ihren Teilaufgaben
  5. Testing Phase – Automatisierte Tests im eingebetteten Browser
  6. Review Phase – Der Monitor prüft Qualität und Sicherheit
  7. Deployment (optional) – FTP-Upload auf Ihren Server

🚀 Deployment

Nach der Entwicklung kann Ihr Projekt automatisch auf einen Webserver bereitgestellt werden.

Voraussetzungen

  • Ein FTP/SFTP-Zugang zu Ihrem Webserver
  • FTP-Konfiguration in KI DEVment eingegeben (siehe FTP-Setup)

Was wird hochgeladen?

  • HTML/CSS/JS-Dateien (Frontend)
  • PHP-Dateien (Datenbankverbindung, Server-Logik)
  • Konfigurationsdateien
  • Optionale Medien & Assets
💡

Tipp: Der FTP-Manager kann einzelne Dateien oder ganze Verzeichnisse auf einmal hochladen (Bulk-Upload).

💻 CLI-Referenz

BefehlBeschreibung
python main.pyHauptanwendung starten
python compile.pyAls EXE kompilieren
pip install -r requirements.txtAbhängigkeiten installieren
ollama serveOllama-Server starten
ollama pull [modell]KI-Modell herunterladen
ollama listVerfügbare Modelle anzeigen

🔧 Fehlerbehebung

Ollama wird nicht gefunden

⚠️

Lösung: Stellen Sie sicher, dass Ollama installiert und der Server läuft (ollama serve). Prüfen Sie, dass der Dienst auf Port 11434 aktiv ist.

FTP-Verbindung fehlgeschlagen

⚠️

Lösung: Überprüfen Sie Server-Adresse, Benutzername, Passwort und Port. Stellen Sie sicher, dass Ihr Hosting-Anbieter FTP/SFTP aktiviert hat.

Python-Fehler beim Starten

⚠️

Lösung: Führen Sie pip install -r requirements.txt erneut aus. Stellen Sie sicher, dass Python 3.10+ installiert ist.

Betatest-Agent funktioniert nicht

⚠️

Lösung: Der Betatest-Agent benötigt PyQt6 mit WebEngine. Prüfen Sie, ob PyQt6-WebEngine in requirements.txt enthalten ist und korrekt installiert wurde.

FAQ

Kann ich KI DEVment ohne Ollama nutzen?

Ja, Sie können OpenAI als alternative KI-Quelle konfigurieren. Dafür wird ein API-Key benötigt und eine Internetverbindung.

Wie lange dauert ein typisches Projekt?

Das variiert je nach Komplexität. Einfache Webseiten können in wenigen Minuten fertig sein, komplexere Anwendungen benötigen länger – aber immer deutlich schneller als manuelle Entwicklung.

Kann ich die generierten Dateien anpassen?

Absolut! Alle generierten Dateien werden lokal gespeichert und können frei editiert werden. Sie können jederzeit das Projekt weiter entwickeln.

Welche Sprachen unterstützt die Oberfläche?

Die Benutzeroberfläche ist in Deutsch, Englisch und Französisch verfügbar. Die Sprache kann in den Einstellungen geändert werden.