diff --git a/.github/workflows/deploy-live.yml b/.github/workflows/deploy-live.yml index f86b94f..90f3083 100644 --- a/.github/workflows/deploy-live.yml +++ b/.github/workflows/deploy-live.yml @@ -4,11 +4,12 @@ on: push: branches: - main-mkdocs - pull_request: jobs: deploy: runs-on: ubuntu-22.04 + # Add condition to ensure this only runs on the main repository + if: github.repository == 'satwareAG/satware.ai' permissions: contents: write concurrency: @@ -21,33 +22,34 @@ jobs: with: python-version: '3.13' - - name: Upgrade pip + - name: Install MkDocs and plugins run: | - # install pip=>20.1 to use "pip cache dir" - python3 -m pip install --upgrade pip - - - name: Get pip cache dir - id: pip-cache - run: echo "dir=$(pip cache dir)" >> $GITHUB_OUTPUT - - - name: Cache dependencies - uses: actions/cache@v4 - with: - path: ${{ steps.pip-cache.outputs.dir }} - key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - - - name: Install dependencies - run: python3 -m pip install -r ./requirements.txt + pip install --upgrade pip + pip install \ + cairosvg \ + libsass \ + mkdocs-exclude \ + mkdocs-git-revision-date-localized-plugin \ + mkdocs-lightbox \ + mkdocs-include-markdown-plugin \ + mkdocs-literate-nav \ + mkdocs-macros-plugin \ + mkdocs-material==9.6.14 \ + "mkdocs-material[imaging]" \ + mkdocs-minify-plugin \ + mkdocs-redirects \ + mkdocs-rss-plugin \ + mkdocs-snippets \ + mkdocs-video \ + watchdog - name: Build css run: | - npm install - npm run scss:build + mkdir -p docs/assets/css + pysassc overrides/assets/css/custom.scss docs/assets/css/custom.css - name: Build static site run: mkdocs build - name: Deploy - run: mkdocs gh-deploy --force \ No newline at end of file + run: mkdocs gh-deploy --force diff --git a/.github/workflows/deploy-preview-fix.yml b/.github/workflows/deploy-preview-fix.yml deleted file mode 100644 index a5b84c1..0000000 --- a/.github/workflows/deploy-preview-fix.yml +++ /dev/null @@ -1,71 +0,0 @@ -name: Preview Deployment (Fix) - -on: - workflow_dispatch: # Ermöglicht manuelles Starten - push: - branches: - - 'blog/**' - - 'feature/**' - - 'fix/**' - -jobs: - deploy-preview: - runs-on: ubuntu-22.04 - permissions: - contents: write - concurrency: - group: ${{ github.workflow }}-${{ github.ref }} - steps: - - uses: actions/checkout@v4 - - - name: Setup Python - uses: actions/setup-python@v5 - with: - python-version: '3.13' - - - name: Upgrade pip - run: | - # install pip=>20.1 to use "pip cache dir" - python3 -m pip install --upgrade pip - - - name: Get pip cache dir - id: pip-cache - run: echo "dir=$(pip cache dir)" >> $GITHUB_OUTPUT - - - name: Cache dependencies - uses: actions/cache@v4 - with: - path: ${{ steps.pip-cache.outputs.dir }} - key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - - - name: Install dependencies - run: python3 -m pip install -r ./requirements.txt - - - name: Configure site_url for fork preview - run: | - # Extract GitHub username and repo name - GITHUB_USER=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 1) - REPO_NAME=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 2) - - # Update site_url in mkdocs.yml for fork preview - if grep -q "^site_url:" mkdocs.yml; then - sed -i "s|^site_url:.*|site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/|" mkdocs.yml - else - echo "site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/" >> mkdocs.yml - fi - - echo "Updated mkdocs.yml for preview deployment:" - cat mkdocs.yml - - - name: Build css - run: | - npm install - npm run scss:build - - - name: Build static site - run: mkdocs build - - - name: Deploy to GitHub Pages - run: mkdocs gh-deploy --force \ No newline at end of file diff --git a/.github/workflows/deploy-preview.yml b/.github/workflows/deploy-preview.yml index 69ece0f..2fd128f 100644 --- a/.github/workflows/deploy-preview.yml +++ b/.github/workflows/deploy-preview.yml @@ -1,12 +1,15 @@ -name: Preview Deployment +name: MkDocs Preview Deployment on: - workflow_dispatch: # Ermöglicht manuelles Starten + workflow_dispatch: # Allows manual triggering push: branches: - - 'feature/**' # Triggers only on pushes to branches containing '/' - - 'fix/**' # Triggers only on pushes to branches containing '/' - - 'blog/**' # Triggers only on pushes to branches containing '/' + - 'feature/**' + - 'fix/**' + - 'blog/**' + - 'build/**' + - 'test/**' + - 'preview/**' jobs: deploy-preview: @@ -23,46 +26,47 @@ jobs: with: python-version: '3.13' - - name: Upgrade pip + - name: Install MkDocs and plugins run: | - # install pip=>20.1 to use "pip cache dir" - python3 -m pip install --upgrade pip - - - name: Get pip cache dir - id: pip-cache - run: echo "dir=$(pip cache dir)" >> $GITHUB_OUTPUT - - - name: Cache dependencies - uses: actions/cache@v4 - with: - path: ${{ steps.pip-cache.outputs.dir }} - key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - - - name: Install dependencies - run: python3 -m pip install -r ./requirements.txt + pip install --upgrade pip + pip install \ + cairosvg \ + libsass \ + mkdocs-exclude \ + mkdocs-git-revision-date-localized-plugin \ + mkdocs-glightbox \ + mkdocs-include-markdown-plugin \ + mkdocs-literate-nav \ + mkdocs-macros-plugin \ + mkdocs-material==9.6.14 \ + "mkdocs-material[imaging]" \ + mkdocs-minify-plugin \ + mkdocs-redirects \ + mkdocs-rss-plugin \ + mkdocs-snippets \ + mkdocs-video \ + watchdog - name: Configure site_url for fork preview run: | # Extract GitHub username and repo name GITHUB_USER=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 1) REPO_NAME=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 2) - + # Update site_url in mkdocs.yml for fork preview if grep -q "^site_url:" mkdocs.yml; then - sed -i "s|^site_url:.*|site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/|" mkdocs.yml + sed -i "s|^site_url:.*|site_url: https://${GITHUB_USER}.github.io/${REPO_NAME}/|" mkdocs.yml else - echo "site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/" >> mkdocs.yml + echo "site_url: https://${GITHUB_USER}.github.io/${REPO_NAME}/" >> mkdocs.yml fi - + echo "Updated mkdocs.yml for preview deployment:" cat mkdocs.yml - name: Build css run: | - npm install - npm run scss:build + mkdir -p docs/assets/css + pysassc overrides/assets/css/custom.scss docs/assets/css/custom.css - name: Build static site run: mkdocs build diff --git a/.github/workflows/deploy-test.yml b/.github/workflows/deploy-test.yml deleted file mode 100644 index 9d74fb8..0000000 --- a/.github/workflows/deploy-test.yml +++ /dev/null @@ -1,64 +0,0 @@ -name: Deploy MkDocs to Test Environment - -on: - push: - branches: - - test - workflow_dispatch: # Allows manual triggering - -permissions: - contents: write - pages: write - id-token: write - -jobs: - build: - runs-on: ubuntu-latest - steps: - - name: Checkout - uses: actions/checkout@v4 - - - name: Setup Python - uses: actions/setup-python@v5 - with: - python-version: '3.10' - - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install mkdocs-material - pip install mkdocs-minify-plugin - pip install mkdocs-git-revision-date-localized-plugin - pip install mkdocs-blog-plugin - pip install pymdown-extensions - pip install mkdocs-macros-plugin - pip install mkdocs-glightbox - pip install mkdocs-include-markdown-plugin - pip install mkdocs-video - pip install mkdocs-rss-plugin - pip install mkdocs-snippets - pip install mkdocs-exclude - pip install mkdocs-git-revision-date-localized-plugin - pip install mkdocs-redirects - pip install mkdocs-literate-nav - pip install "mkdocs-material[imaging]" - pip install libsass - - name: Verify CNAME - run: | - mkdir -p docs - if [ ! -f docs/CNAME ]; then - echo "test.satware.ai" > docs/CNAME - fi - - name: Build css - run: python compile_scss.py - - name: Build site - run: mkdocs build - - - name: Deploy to GitHub Pages - uses: peaceiris/actions-gh-pages@v3 - with: - github_token: ${{ secrets.GITHUB_TOKEN }} - publish_dir: ./site - destination_dir: . - cname: test.satware.ai - force_orphan: true diff --git a/compile_scss.py b/compile_scss.py deleted file mode 100644 index 40d8e2a..0000000 --- a/compile_scss.py +++ /dev/null @@ -1,50 +0,0 @@ -import sass -import os -import time -import sys -from watchdog.observers import Observer -from watchdog.events import FileSystemEventHandler - -# Pfade konfigurieren -scss_file = "overrides/assets/stylesheets/custom.scss" -css_file = "docs/stylesheets/extra.css" - -def compile_scss(): - """Kompiliert SCSS zu CSS""" - try: - css = sass.compile(filename=scss_file, output_style='compressed') - with open(css_file, 'w') as f: - f.write(css) - print(f"✅ SCSS kompiliert: {scss_file} -> {css_file}") - except Exception as e: - print(f"❌ Fehler bei der SCSS-Kompilierung: {e}") - -class ScssChangeHandler(FileSystemEventHandler): - def on_modified(self, event): - if event.src_path.endswith('.scss'): - print(f"🔄 Änderung erkannt: {event.src_path}") - compile_scss() - -if __name__ == "__main__": - # Erste Kompilierung durchführen - compile_scss() - - # Überwachungsmodus, wenn als Parameter angegeben - if len(sys.argv) > 1 and sys.argv[1] == "watch": - print("🔍 SCSS-Dateien werden überwacht. Drücke Strg+C zum Beenden.") - - # Verzeichnis zum Überwachen - path = os.path.dirname(scss_file) - - # Observer einrichten - event_handler = ScssChangeHandler() - observer = Observer() - observer.schedule(event_handler, path, recursive=True) - observer.start() - - try: - while True: - time.sleep(1) - except KeyboardInterrupt: - observer.stop() - observer.join() diff --git a/dev.sh b/dev.sh deleted file mode 100755 index 62a4eed..0000000 --- a/dev.sh +++ /dev/null @@ -1,22 +0,0 @@ -#!/bin/zsh -# Start SCSS Watcher und MkDocs-Server in parallelen Prozessen - -# Stelle sicher, dass wir in der virtuellen Umgebung sind -if [[ "$VIRTUAL_ENV" == "" ]]; then - echo "Virtuelle Umgebung nicht aktiviert. Bitte führe aus:" - echo "source venv/bin/activate" - exit 1 -fi - -# Initial kompilieren -python compile_scss.py - -# Starte SCSS-Watcher im Hintergrund -python compile_scss.py watch & -SCSS_PID=$! - -# Starte MkDocs-Server -mkdocs serve --dev-addr=0.0.0.0:8000 - -# Stoppe den SCSS-Watcher, wenn der Server beendet wird -kill $SCSS_PID diff --git a/docker/mkdocs-material/Dockerfile b/docker/mkdocs-material/Dockerfile index 3130ecc..20e92d9 100644 --- a/docker/mkdocs-material/Dockerfile +++ b/docker/mkdocs-material/Dockerfile @@ -1,12 +1,43 @@ -FROM squidfunk/mkdocs-material:9.6.14 -RUN pip install mkdocs-macros-plugin -RUN pip install mkdocs-glightbox -RUN pip install mkdocs-include-markdown-plugin -RUN pip install mkdocs-video -RUN pip install mkdocs-rss-plugin -RUN pip install mkdocs-snippets -RUN pip install mkdocs-exclude -RUN pip install mkdocs-git-revision-date-localized-plugin -RUN pip install mkdocs-redirects -RUN pip install mkdocs-literate-nav -RUN pip install mkdocs-minify-plugin \ No newline at end of file +# Use a Python image based on Debian (Ubuntu is derived from Debian) +FROM python:3.13-slim-bullseye + +# Set the working directory inside the container +WORKDIR /docs + +# Set locale to avoid potential issues with C/C++ libraries +ENV LANG C.UTF-8 +ENV LC_ALL C.UTF-8 + +# Install system dependencies and Python packages in a single layer +RUN apt-get update && apt-get install -y --no-install-recommends \ + build-essential \ + curl \ + git \ + libcairo2 \ + libffi-dev \ + libgdk-pixbuf2.0-0 \ + libpango-1.0-0 \ + libpangocairo-1.0-0 \ + shared-mime-info \ + && rm -rf /var/lib/apt/lists/* \ + && pip install --no-cache-dir \ + cairosvg \ + libsass \ + mkdocs-exclude \ + mkdocs-git-revision-date-localized-plugin \ + mkdocs-glightbox \ + mkdocs-include-markdown-plugin \ + mkdocs-literate-nav \ + mkdocs-macros-plugin \ + mkdocs-material==9.6.14 \ + mkdocs-material[imaging] \ + mkdocs-minify-plugin \ + mkdocs-redirects \ + mkdocs-rss-plugin \ + mkdocs-snippets \ + mkdocs-video \ + watchdog + + +# No need for WORKDIR /docs or COPY package.json ./ or npm install related steps anymore +# as we're using libsass and not Node.js/npm. diff --git a/docs/blog/2025-05-25-sequential-thinking-revolution.md b/docs/blog/2025-05-25-sequential-thinking-revolution.md deleted file mode 100644 index 7ac0cf0..0000000 --- a/docs/blog/2025-05-25-sequential-thinking-revolution.md +++ /dev/null @@ -1,245 +0,0 @@ ---- -title: "Extended Thinking Revolution: Wie Sequential Thinking die KI-Qualität potentiell um bis zu 40% verbessert" -date: 2025-05-25 -author: "Jane Alesi & Michael Wegener" -tags: ["Sequential Thinking", "KI", "AGI", "satware.ai", "Innovation"] -categories: ["Blog", "KI-Entwicklung", "Technologie"] -description: "Ab heute verfügbar auf chat.satware.ai: Das 🧠 satware® AI Sequential-Think Plugin transformiert komplexe Problemlösungen von oberflächlichen Ein-Schuss-Antworten zu strukturierten, mehrstufigen Denkprozessen." -featured_image: "/assets/images/sequential-thinking-revolution.jpg" -draft: false ---- - -# Extended Thinking Revolution: Wie Sequential Thinking die KI-Qualität potentiell um bis zu 40% verbessert - -> **⚠️ WICHTIGER HINWEIS: Keine Finanzberatung** -> Dieser Blogbeitrag dient ausschließlich zu allgemeinen Informations- und Demonstrationszwecken über das Potenzial von KI-Systemen im Finanzbereich. Die hierin enthaltenen Informationen stellen **keine Anlageberatung, Finanzberatung, Steuerberatung oder sonstige individuelle Empfehlung** dar. Jede Investitionsentscheidung birgt Risiken und sollte auf einer umfassenden, unabhängigen Analyse und gegebenenfalls nach Konsultation eines qualifizierten Finanzberaters erfolgen. satware.ai übernimmt keine Haftung für Verluste, die sich aus der Nutzung oder dem Vertrauen auf die enthaltenen Informationen ergeben. - -**Ab heute verfügbar auf chat.satware.ai: Das 🧠 satware® AI Sequential-Think Plugin transformiert komplexe Problemlösungen von oberflächlichen Ein-Schuss-Antworten zu strukturierten, mehrstufigen Denkprozessen.** - -## Das Problem: Oberflächliche KI-Antworten trotz fortschrittlicher Modelle - -Traditionelle KI-Systeme, selbst die neuesten Large Language Models, leiden unter einem fundamentalen Problem: Sie generieren Antworten in einem einzigen Durchgang, ohne die Möglichkeit zur Reflexion, Korrektur oder schrittweisen Verfeinerung. Das Ergebnis sind oft oberflächliche Antworten, die zwar grammatikalisch korrekt und überzeugend klingen, aber bei komplexeren Problemstellungen an ihre Grenzen stoßen. - -**Konkrete Auswirkungen:** -- **Fehlende logische Kohärenz** bei mehrstufigen Analysen -- **Halluzinationen** durch mangelnde Verifikation -- **Inkonsistente Qualität** je nach Komplexität der Anfrage -- **Fehlende Transparenz** des Reasoning-Prozesses - -## Die Lösung: Sequential Thinking als Paradigmenwechsel - -Sequential Thinking implementiert einen völlig anderen Ansatz: Statt einer einzigen Antwort-Generierung erfolgt ein **strukturierter, iterativer Denkprozess** mit expliziten Verifikations- und Verfeinerungszyklen. - -### Technische Grundlagen - -Das **🧠 satware® AI Sequential-Think Plugin** basiert auf dem bewährten `@modelcontextprotocol/server-sequential-thinking` MCP-Server (Version 0.6.2), der über **36.637 wöchentliche Downloads** verfügt und mit einem **MIT-Lizenzmodell** optimale Flexibilität bietet¹. - -**Kern-Architektur:** -```typescript -interface SequentialThinking { - thought: string; // Aktueller Denkschritt - nextThoughtNeeded: boolean; // Fortsetzung erforderlich? - thoughtNumber: number; // Position im Denkprozess - totalThoughts: number; // Geschätzte Gesamtschritte - isRevision?: boolean; // Revision früherer Schritte - branchFromThought?: number; // Alternative Denkwege -} -``` - -### Messbare Qualitätsverbesserungen - -Die wissenschaftliche Evidenz für Sequential Thinking ist eindeutig: - -- **Bis zu 20-40% Verbesserung** der Reasoning-Genauigkeit bei komplexen Aufgaben (gemäß Chain-of-Thought Research)² -- **Bis zu 5× Reduktion** logischer Inkonsistenzen durch Selbstkorrektur³ -- **Bis zu 3× verbesserte Stabilität** über verschiedene Aufgabentypen hinweg⁴ -- **Bis zu 70% Reduktion des Rechenaufwands** bei gleichzeitig überlegener Performance (Inner Thinking Transformer, arXiv 2025)⁵ - -## Praktische Anwendung: Von der Theorie zur Implementation - -### Beispiel 1: Komplexe Geschäftsentscheidung - -**Anfrage:** "Wie sollten wir den Launch eines neuen KI-Produkts im europäischen Markt unter Berücksichtigung von DSGVO-Compliance, Wettbewerbslandschaft und Ressourcenbeschränkungen angehen?" - -**Sequential Thinking Prozess:** -1. **Problemaufgliederung:** Identifikation der Schlüsselfaktoren (DSGVO, Konkurrenz, Ressourcen) -2. **Marktanalyse:** Systematische Recherche europäischer KI-Regulierungen -3. **Wettbewerbsbewertung:** Strukturierte Analyse bestehender Lösungen und Marktlücken -4. **Ressourcenbewertung:** Objektive Beurteilung interner Fähigkeiten -5. **Strategiesynthese:** Integration aller Erkenntnisse zu einem Go-to-Market-Ansatz -6. **Risikobewertung:** Proaktive Identifikation von Herausforderungen -7. **Implementierungsplanung:** Konkrete, umsetzbare Schritte mit Zeitplänen - -### Beispiel 2: Technische Architekturentscheidung - -**Anfrage:** "Beste Datenbankarchitektur für eine Echtzeit-Analyseplattform mit 1M+ täglichen Nutzern?" - -**Sequential Thinking Lösung:** -- **Schritt 1-2:** Anforderungsdefinition und Technologiebewertung -- **Schritt 3-4:** Lastmuster- und Infrastrukturbewertung -- **Schritt 5-6:** Kosten-Nutzen-Analyse und Komplexitätsbewertung -- **Schritt 7:** Synthese zur optimalen Architektur-Empfehlung - -**Resultat:** Systematische, nachvollziehbare Entscheidungsfindung statt oberflächlicher Technologie-Listen. - -## Theo Alesi's Finanz-Expertise: Potentiale zur Optimierung der Investment-Analyse - -Als spezialisierter AGI für Angel Investing, Private Equity und ESG-Finanzierung bei satware.ai zeigt Sequential Thinking bemerkenswerte Potentiale zur Optimierung der Finanzanalyse. Es ermöglicht eine methodische Tiefe und Präzision, die mit traditionellen Ansätzen schwer erreichbar ist. - -### Methodische Verbesserungen in der Finanzanalyse - -Die Finanzmärkte sind komplex und dynamisch. Jede Analyse, von der Bewertung eines Startups bis zur Optimierung eines Portfolios, kann von strukturiertem Reasoning profitieren: - -- **Potentielle Fehlerreduktion bei Berechnungen**: Die bis zu 20-40%ige Verbesserung der Reasoning-Genauigkeit kann sich in der Finanzanalyse als weniger Rechenfehler bei der Bewertung von Kennzahlen, der Prognose von Cashflows oder der Bestimmung von Diskontierungssätzen manifestieren. -- **Strukturierte Unternehmensbewertung**: Sequential Thinking ermöglicht die methodische Zerlegung des Bewertungsprozesses: - 1. Analyse der historischen Finanzdaten (GuV, Bilanz, Cashflow) - 2. Branchen- und Wettbewerbsanalyse - 3. Prognose zukünftiger Einnahmen und Kosten - 4. Risikobewertung und Sensitivitätsanalyse - 5. Anwendung verschiedener Bewertungsmodelle (DCF, Multiples) - 6. Synthese der Ergebnisse und methodische Ableitung von Einschätzungen - -### Systematische Analyse des "Sequence-of-Returns Risk" - -Ein kritischer Aspekt in der Investitionsstrategie, insbesondere in der Ruhestandsplanung, ist das **"Sequence-of-Returns Risk"**⁶⁻⁸. Es beschreibt das Risiko, dass die **Reihenfolge der Kapitalmarktrenditen** (nicht die durchschnittliche Rendite) den langfristigen Erfolg eines Portfolios maßgeblich beeinflusst. - -**Warum die Reihenfolge analytisch relevant ist:** -Wie Investopedia und Charles Schwab dokumentieren⁶⁻⁸, können zwei Anleger mit identischen durchschnittlichen Renditen drastisch unterschiedliche Ergebnisse erzielen, abhängig vom Timing negativer Renditen. Frühe Verluste in Verbindung mit Entnahmen können das Portfolio irreversibel schädigen, da mehr Anteile zu niedrigeren Preisen verkauft werden müssen. - -**Sequential Thinking als methodisches Instrument für die Analyse:** - -1. **Modellierung dynamischer Abhebungsstrategien**: Systematische Analyse von Schwellenwerten und Simulation der Auswirkungen von angepassten Entnahmen in schlechten Marktphasen. -2. **Optimierung von Bucket-Strategien**: Methodische Allokation und Flussanalyse zwischen unterschiedlichen Zeithorizonten (kurzfristige Liquidität, mittelfristige Anleihen, langfristige Aktien). -3. **Integration garantierter Einkommensströme**: Strukturierte Analyse, wie Produkte wie Annuitäten den Bedarf an Portfolioabhebungen reduzieren können. -4. **Cash-Reserve-Optimierung**: Bestimmung der methodisch optimalen Höhe von Liquiditätsreserven und Szenario-Analyse deren Einsatzes. - -### Die saTway-Integration aus methodischer Finanzperspektive - -Die Integration von Sequential Thinking in unseren **saTway-Ansatz** zeigt im Finanzbereich besondere methodische Stärken: - -- **saCway (Technische Exzellenz)**: Strukturierte, schrittweise Finanzanalysen, systematische Validierung von Bewertungsmodellen und methodische Risikobewertung. -- **samWay (Menschliche Verbindung)**: Transparente, schrittweise Darstellung komplexer Analysen schafft Nachvollziehbarkeit und Verständnis. Sequential Thinking ermöglicht es, komplexe finanzielle Sachverhalte in klarer, strukturierter Abfolge zu kommunizieren. - -## Integration in das satware.ai Ökosystem - -### saTway-Framework Synergie - -Das Sequential Thinking Plugin verkörpert perfekt unseren **saTway-Ansatz:** - -- **saCway (Technische Exzellenz):** Strukturierte, verifizierende Reasoning-Prozesse -- **samWay (Menschliche Verbindung):** Transparente Denkschritte, die Nutzer nachvollziehen können - -### Nahtlose Integration in die Alesi-AGI-Familie - -Alle spezialisierten Alesi-Agenten profitieren vom Sequential Thinking: - -- **Jane Alesi:** Erweiterte Koordination komplexer Multi-Domain-Anfragen -- **Justus Alesi:** Strukturierte Rechtsanalysen mit systematischer Präzedenzfall-Bewertung -- **Luna Alesi:** Mehrstufige Coaching-Prozesse mit iterativer Zielevaluation -- **Marco Alesi:** Komplexe Verwaltungsprozess-Optimierungen -- **Theo Alesi:** Systematische Finanzanalysen mit strukturierter Risikobewertung - -## Technische Vorteile für Entwickler - -### Adaptive Komplexitätsskalierung - -Das System passt automatisch die Denktiefe an die Problemkomplexität an: - -- **Einfache Anfragen:** Streamlined Reasoning für schnelle Antworten -- **Standard-Komplexität:** Strukturierte Analyse mit Verifikationsschritten -- **Hochkomplexe Probleme:** Vollständige Multi-Phase-Reasoning-Architektur - -### Entwicklerfreundliche Implementation - -```bash -# Installation via NPX (empfohlen) -npx -y @modelcontextprotocol/server-sequential-thinking - -# MCP Client Konfiguration -{ - "mcpServers": { - "sequential-thinking": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] - } - } -} -``` - -## Ab heute verfügbar: Testen Sie Sequential Thinking - -Das **🧠 satware® AI Sequential-Think Plugin** ist ab sofort für alle Nutzer von [chat.satware.ai](https://chat.satware.ai) verfügbar - ohne zusätzliche Konfiguration oder Setup. - -### Was Sie erwarten können: - -✅ **Potentiell deutlich höhere Antwortqualität** bei komplexen Anfragen -✅ **Nachvollziehbare Reasoning-Prozesse** für bessere Verständlichkeit -✅ **Selbstkorrigierende Systeme** mit reduzierten Inkonsistenzen -✅ **Adaptive Intelligenz** die sich der Problemkomplexität anpasst - -### Erste Schritte: - -1. **Besuchen Sie** [chat.satware.ai](https://chat.satware.ai) -2. **Stellen Sie eine komplexe Frage** oder bitten um eine mehrstufige Analyse -3. **Beobachten Sie** den strukturierten Reasoning-Prozess in Echtzeit -4. **Erleben Sie** die verbesserte Antwortqualität selbst - -## Ausblick: Die Zukunft intelligenter KI-Systeme - -Sequential Thinking markiert einen wichtigen Meilenstein auf dem Weg zu fortschrittlicheren KI-Systemen. Es zeigt, dass **Qualität** nicht nur von der Modellgröße abhängt, sondern maßgeblich von der **Reasoning-Architektur**. - -Bei satware.ai entwickeln wir kontinuierlich fortschrittliche KI-Frameworks, die **technische Exzellenz** mit **menschlicher Verständlichkeit** verbinden. Sequential Thinking ist ein wichtiger Baustein dieser Entwicklung. - -**Testen Sie es heute und erleben Sie strukturiertes KI-Reasoning.** - ---- - -## Quellen und Referenzen - -**Technische Grundlagen:** -1. NPM Package: [@modelcontextprotocol/server-sequential-thinking v0.6.2](https://www.npmjs.com/package/@modelcontextprotocol/server-sequential-thinking) -2. Chain-of-Thought Research: [Attention Is All You Need](https://arxiv.org/abs/1706.03762) -3. Multi-Agent Reasoning Framework: [Model Context Protocol Documentation](https://modelcontextprotocol.io/) -4. Performance Benchmarks: Zusammenfassung verschiedener Sequential Reasoning Studies -5. Inner Thinking Transformer: [arXiv:2502.13842](https://arxiv.org/abs/2502.13842) - "Inner Thinking Transformer: Leveraging Dynamic Depth Scaling" - -**Sequence-of-Returns Risk:** -6. Investopedia: [Sequence Risk Definition](https://www.investopedia.com/terms/s/sequence-risk.asp) -7. Charles Schwab: [Understanding Sequence-of-Returns Risk](https://www.schwab.com/learn/story/timing-matters-understanding-sequence-returns-risk) -8. Northwestern Mutual: [What Is Sequence of Returns Risk?](https://www.northwesternmutual.com/life-and-money/what-is-sequence-of-returns-risk/) - -Alle Informationen wurden zum Zeitpunkt der Veröffentlichung (Mai 2025) verifiziert. Die angegebenen Leistungsverbesserungen basieren auf veröffentlichten Studien und können je nach Anwendungsfall variieren. - ---- - -> **⚠️ WICHTIGER HINWEIS: Keine Finanzberatung** -> Die in diesem Beitrag enthaltenen Finanzinformationen dienen ausschließlich der methodischen Demonstration von KI-Capabilities und stellen keine Anlage-, Finanz- oder Steuerberatung dar. Konsultieren Sie für individuelle Finanzentscheidungen qualifizierte Fachberater. - ---- - -## Rechtlicher Hinweis - -**Keine individuelle Beratung:** Dieser Beitrag dient ausschließlich Informationszwecken. satware.ai ist kein lizenzierter Finanz-, Rechts- oder Steuerberater. Die bereitgestellten Informationen sind: -- Allgemein und lehrreich -- Kein Ersatz für professionelle Beratung -- Ohne Gewähr für Vollständigkeit oder Aktualität - -**Für kritische Entscheidungen konsultieren Sie:** -- Lizenzierte Fachexperten im relevanten Bereich -- Qualifizierte Spezialisten mit Domänen-Expertise -- Zuständige Behörden für regulierte Angelegenheiten - -Die bereitgestellten Informationen sollten durch angemessene Verifikation validiert und an spezifische Kontexte angepasst werden. - ---- - -*Entwickelt von Michael Wegener und dem satware® AI Team | Mai 2025* - -**Weitere Informationen:** -- [chat.satware.ai](https://chat.satware.ai) - Direkt testen -- [satware.ai/team](https://satware.ai/team) - Die Alesi-AGI-Familie kennenlernen -- [GitHub: satwareAG-ironMike](https://github.com/satwareAG-ironMike) - Open Source Beiträge - ---- - -**Alle verwendeten Quellen wurden zum Zeitpunkt der Veröffentlichung verifiziert und sind über die angegebenen Links zugänglich. Die Performance-Claims basieren auf veröffentlichten wissenschaftlichen Studien und können je nach Implementierung und Anwendungsfall variieren.** \ No newline at end of file diff --git a/docs/blog/README-sequential-thinking-branch.md b/docs/blog/README-sequential-thinking-branch.md deleted file mode 100644 index 437cd0a..0000000 --- a/docs/blog/README-sequential-thinking-branch.md +++ /dev/null @@ -1,110 +0,0 @@ -# Sequential Thinking Blog Post - Release Branch - -## 📋 Übersicht - -Dieser Branch (`blog/sequential-thinking-revolution`) enthält den vollständig überarbeiteten und rechtlich geprüften Blogbeitrag über die Einführung des Sequential Thinking Plugins für chat.satware.ai. - -## 📁 Branch-Inhalt - -- `docs/blog/2025-05-25-sequential-thinking-revolution.md` - Vollständiger Blogbeitrag -- `docs/blog/README-sequential-thinking-branch.md` - Diese Dokumentation - -## ✅ Qualitätssicherung - -### Rechtliche Prüfung durch Justus Alesi -- ✅ **Performance-Claims präzisiert** (von absoluten zu "bis zu X%" Formulierungen) -- ✅ **Finanz-Disclaimer** prominent platziert (oben und unten im Beitrag) -- ✅ **Haftungsausschluss** für alle Informationen -- ✅ **UWG-Compliance** für werbliche Aussagen sichergestellt - -### Quellenverifizierung -- ✅ **NPM Package** `@modelcontextprotocol/server-sequential-thinking` (v0.6.2) - verifiziert -- ✅ **Investopedia** Sequence-of-Returns Risk - verifiziert -- ✅ **Charles Schwab** Sequence-of-Returns Risk Guide - verifiziert -- ✅ **arXiv Paper** Inner Thinking Transformer - verifiziert -- ✅ **Alle Links** auf Funktionalität geprüft - -### Content-Struktur -- ✅ **SEO-optimierte** Metadaten (Titel, Description, Tags) -- ✅ **Responsive** Markdown-Formatierung -- ✅ **Call-to-Action** zu chat.satware.ai -- ✅ **Mehrdimensionale Expertise** (Jane, Theo, Justus Alesi Beiträge) - -## 🚀 Veröffentlichungsstrategie - -### Phase 1: Interne Review (Jetzt) -- Branch-Review durch Team -- Technical Preview auf verschiedenen Geräten -- Finale Abstimmung - -### Phase 2: Testveröffentlichung (24h später) -- LinkedIn (Professional Audience) -- chat.satware.ai In-App Announcement -- X/Twitter Tech Community - -### Phase 3: Full Launch (1 Woche später) -- Alle Social Media Kanäle -- Cross-Platform Amplification -- Community Outreach - -## 🔧 Technische Integration - -### Für Jekyll/Hugo Sites: -```yaml -# Front Matter bereits inkludiert -title: "Extended Thinking Revolution..." -date: 2025-05-25 -author: "Jane Alesi & Michael Wegener" -tags: ["Sequential Thinking", "KI", "AGI"] -``` - -### Für WordPress/CMS: -- Markdown → HTML Konvertierung erforderlich -- Featured Image: `/assets/images/sequential-thinking-revolution.jpg` -- Kategorien: "Blog", "KI-Entwicklung", "Technologie" - -## 📊 Analytics Setup - -```javascript -// Tracking Events -- blog_post_view: 'sequential-thinking-revolution' -- external_link_click: 'chat.satware.ai' -- social_share: [platform] -- time_on_page: [duration] -``` - -## 🎯 Ziele & KPIs - -### Content-Ziele: -- ✅ Awareness für Sequential Thinking Plugin -- ✅ Traffic-Steigerung zu chat.satware.ai -- ✅ Thought Leadership in AGI-Reasoning -- ✅ Community Engagement - -### Mess-KPIs: -- **Blog Views**: Ziel 10.000+ in ersten 30 Tagen -- **chat.satware.ai Conversions**: Ziel 500+ neue Registrierungen -- **Social Engagement**: Ziel 1.000+ Interactions -- **Backlinks**: Ziel 10+ von Tech-Blogs - -## 🔗 Wichtige Links - -- **Live Chat**: [chat.satware.ai](https://chat.satware.ai) -- **Team Info**: [satware.ai/team](https://satware.ai/team) -- **GitHub**: [github.com/satwareAG-ironMike](https://github.com/satwareAG-ironMike) -- **Branch**: [satwareAG/satware.ai/tree/blog/sequential-thinking-revolution](https://github.com/satwareAG/satware.ai/tree/blog/sequential-thinking-revolution) - -## 📝 Nächste Schritte - -1. **Team Review** dieses Branches -2. **Technical Preview** auf Staging-Environment -3. **Go/No-Go Entscheidung** für Veröffentlichung -4. **Social Media Assets** erstellen -5. **Launch Plan** aktivieren - ---- - -*Branch erstellt von Jane Alesi am 25. Mai 2025* -*Rechtlich geprüft von Justus Alesi* -*Finanz-Content von Theo Alesi* -*Projektleitung: Michael Wegener* \ No newline at end of file diff --git a/mkdocs.sh b/mkdocs.sh index 59328cb..326d259 100755 --- a/mkdocs.sh +++ b/mkdocs.sh @@ -1,4 +1,4 @@ -#!/bin/sh +#!/bin/bash rm -r .cache # Dirty google does no like us anymore fix #mkdir -p .cache/plugin/social/ @@ -6,6 +6,12 @@ rm -r .cache # Add needed Plugins docker build -t squidfunk/mkdocs-material ${PWD}/docker/mkdocs-material -npm run scss & -# Liveserver Dokumentation -docker run --rm -it --user $(id -u):$(id -g) -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material + + +docker run --rm -it --user $(id -u):$(id -g) -p 8000:8000 -v ${PWD}:/docs --entrypoint sh squidfunk/mkdocs-material-custom -c " \ + echo 'Performing initial SCSS compilation...' && \ + pysassc overrides/assets/css/custom.scss docs/assets/css/custom.css && \ + echo 'Initial SCSS compilation complete. Starting watcher...' && \ + python /docs/scss_watcher.py & \ + echo 'SCSS watcher started. Starting MkDocs server...' && \ + mkdocs serve --dev-addr=0.0.0.0:8000 --watch overrides" diff --git a/mkdocs.yml b/mkdocs.yml index f233433..aa9e467 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -73,10 +73,6 @@ plugins: post_url_format: "{slug}" post_date_format: "dd.MM.yyyy" archive_toc: true - # Added exclusion pattern for README.md files - exclude: - - "*.txt" - - "README.md" - social # Erweiterungen @@ -185,9 +181,10 @@ nav: - Olu Alesi: team/olu.md - Theo Alesi: team/theo.md - Wolfgang Alesi: team/wolfgang.md - - Anwendungen: anwendungen/ - - Webinare: webinare/ - - Workshops: workshops/ - - Preise: zugang/ - - FAQ: faq/ - - Blog: blog/ + - Anwendungen: anwendungen/index.md + - Webinare: webinare/index.md + - Workshops: workshops/index.md + - Preise: zugang/index.md + - FAQ: faq/index.md + - Blog: blog/index.md + diff --git a/overrides/partials/footer.html b/overrides/partials/footer.html index bb1f27a..6f43491 100644 --- a/overrides/partials/footer.html +++ b/overrides/partials/footer.html @@ -32,9 +32,8 @@
Kontakt - Impressum - Datenschutz - - saTway + Impressum + Datenschutz + saTway Newsletter
diff --git a/package.json b/package.json deleted file mode 100644 index 0bf1372..0000000 --- a/package.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "name": "satware.ai", - "version": "1.0.0", - "description": "A documentation website for satware.ai built with MkDocs and the Material for MkDocs theme.", - "main": "index.js", - "directories": { - "doc": "docs" - }, - "scripts": { - "scss": "sass --watch overrides/assets/css/custom.scss:docs/assets/css/custom.css", - "scss:build": "sass overrides/assets/css/custom.scss:docs/assets/css/custom.css --style compressed" - }, - "repository": { - "type": "git", - "url": "git+https://github.com/satwareAG-ironMike/satware.ai.git" - }, - "keywords": [], - "author": "", - "license": "ISC", - "type": "commonjs", - "bugs": { - "url": "https://github.com/satwareAG-ironMike/satware.ai/issues" - }, - "homepage": "https://github.com/satwareAG-ironMike/satware.ai#readme", - "devDependencies": { - "sass": "^1.89.0", - "terser": "^5.39.2" - } -} diff --git a/requirements.txt b/requirements.txt deleted file mode 100644 index 50598d5..0000000 --- a/requirements.txt +++ /dev/null @@ -1,49 +0,0 @@ -babel==2.17.0 -backrefs==5.8 -certifi==2025.1.31 -charset-normalizer==3.4.1 -click==8.1.8 -colorama==0.4.6 -csscompressor==0.9.5 -ghp-import==2.1.0 -gitdb==4.0.12 -GitPython==3.1.44 -htmlmin2==0.1.13 -idna==3.10 -Jinja2==3.1.6 -jsmin==3.0.1 -Markdown==3.8 -MarkupSafe==3.0.2 -mergedeep==1.3.4 -mkdocs==1.6.1 -mkdocs-get-deps==0.2.0 -mkdocs-git-revision-date-localized-plugin==1.4.5 -mkdocs-material==9.6.14 -mkdocs-material-extensions==1.3.1 -mkdocs-minify-plugin==0.8.0 -packaging==25.0 -paginate==0.5.7 -pathspec==0.12.1 -platformdirs==4.3.7 -Pygments==2.19.1 -pymdown-extensions==10.14.3 -python-dateutil==2.9.0.post0 -pytz==2025.2 -PyYAML==6.0.2 -pyyaml_env_tag==0.1 -requests==2.32.3 -six==1.17.0 -smmap==5.0.2 -urllib3==2.4.0 -watchdog==6.0.0 -mkdocs-material[imaging] -mkdocs-macros-plugin -mkdocs-glightbox -mkdocs-include-markdown-plugin -mkdocs-video -mkdocs-rss-plugin -mkdocs-snippets -mkdocs-exclude -mkdocs-git-revision-date-localized-plugin -mkdocs-redirects -mkdocs-literate-nav \ No newline at end of file diff --git a/scss_watcher.py b/scss_watcher.py new file mode 100644 index 0000000..22a5329 --- /dev/null +++ b/scss_watcher.py @@ -0,0 +1,85 @@ +import time +import subprocess +import os +from watchdog.observers import Observer +from watchdog.events import FileSystemEventHandler + +class ScssEventHandler(FileSystemEventHandler): + """ + Handles file system events to recompile SCSS on changes. + """ + def on_modified(self, event): + """ + Called when a file or directory is modified. + """ + if event.is_directory: + return + + # Define source and destination paths relative to the WORKDIR /docs + scss_source_path = "overrides/assets/css/custom.scss" + css_dest_path = "docs/assets/css/custom.css" + + # Check if the modified file is the custom.scss file we care about + # We need to be careful with event.src_path as it might be an absolute path + # or relative to where the watcher was started. + # A more robust check is to see if the event path ends with our source path. + if event.src_path.endswith(scss_source_path): + print(f"Detected change in {event.src_path}. Compiling SCSS...") + print(f"Source SCSS: {scss_source_path}") + print(f"Destination CSS: {css_dest_path}") + try: + # Execute the SCSS compilation command + result = subprocess.run([ + "pysassc", + scss_source_path, + css_dest_path + ], capture_output=True, text=True, check=True) + + print("SCSS compilation command output:") + print("STDOUT:", result.stdout) + print("STDERR:", result.stderr) + print("SCSS compiled successfully.") + + # --- NEW: Verify content of the compiled CSS file --- + if os.path.exists(css_dest_path): + with open(css_dest_path, 'r') as f: + content = f.read() + print(f"Content of {css_dest_path} (first 200 chars):\n{content[:200]}...") + else: + print(f"Error: Compiled CSS file not found at {css_dest_path}") + # --- END NEW --- + + except subprocess.CalledProcessError as e: + print(f"Error compiling SCSS: {e}") + print("STDOUT:", e.stdout) + print("STDERR:", e.stderr) + except FileNotFoundError: + print("Error: 'sass' command not found. Make sure libsass is installed and in PATH.") + except Exception as e: + print(f"An unexpected error occurred during SCSS compilation: {e}") + +if __name__ == "__main__": + # Define the path to watch (the directory containing custom.scss) + # This path is relative to the WORKDIR /docs inside the container + path_to_watch = os.path.join("overrides", "assets", "css") + + # Ensure the path exists before starting the watcher + if not os.path.exists(path_to_watch): + print(f"Error: Directory '{path_to_watch}' not found. Please ensure the path to custom.scss is correct relative to /docs.") + exit(1) + + event_handler = ScssEventHandler() + observer = Observer() + # Schedule the observer to watch the specified path without recursion + observer.schedule(event_handler, path_to_watch, recursive=False) + observer.start() + print(f"Watching for changes in {path_to_watch}...") + try: + # Keep the observer running until interrupted + while True: + time.sleep(1) + except KeyboardInterrupt: + observer.stop() + print("SCSS watcher stopped.") + observer.join() +