Initial commit: Open WebUI Nextcloud ExApp

- Beautiful chat interface integrated with Nextcloud AppAPI
- FastAPI wrapper for lifecycle management
- Auto-connects to Ollama ExApp
- Supports OpenAI-compatible APIs
- Multi-user support

Co-Authored-By: Claude <noreply@anthropic.com>

Author: rubenvdlinde

.github/workflows/build.yml

@@ -0,0 +1,89 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches: [main, master]
+    tags: ['v*']
+  pull_request:
+    branches: [main, master]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  test:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name != 'pull_request'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Test container startup
+        run: |
+          docker run -d --name test-container \
+            -e APP_ID=open_webui \
+            -e APP_SECRET=test \
+            -e NEXTCLOUD_URL=http://localhost:8080 \
+            -e OLLAMA_BASE_URL=http://localhost:11434 \
+            -p 9000:9000 \
+            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+
+          sleep 30
+
+          # Test heartbeat (before init, will return error)
+          curl http://localhost:9000/heartbeat || true
+
+          docker stop test-container

.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv/
+*.egg-info/
+dist/
+build/
+
+# Docker
+.docker/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Local development
+.env
+.env.local
+*.local
+
+# Data
+/data/

Dockerfile

@@ -0,0 +1,55 @@
+# Open WebUI Nextcloud ExApp
+# Combines Open WebUI chat interface with AppAPI lifecycle management
+
+FROM ghcr.io/open-webui/open-webui:main
+
+# Install additional dependencies for AppAPI wrapper
+USER root
+
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies (Open WebUI already has Python)
+COPY requirements.txt /app/exapp_requirements.txt
+RUN pip install --no-cache-dir -r /app/exapp_requirements.txt
+
+# Install FRP client for HaRP support
+RUN set -ex; \
+    ARCH=$(uname -m); \
+    if [ "$ARCH" = "aarch64" ]; then \
+      FRP_URL="https://raw.githubusercontent.com/nextcloud/HaRP/main/exapps_dev/frp_0.61.1_linux_arm64.tar.gz"; \
+      FRP_DIR="frp_0.61.1_linux_arm64"; \
+    else \
+      FRP_URL="https://raw.githubusercontent.com/nextcloud/HaRP/main/exapps_dev/frp_0.61.1_linux_amd64.tar.gz"; \
+      FRP_DIR="frp_0.61.1_linux_amd64"; \
+    fi; \
+    curl -L "$FRP_URL" -o /tmp/frp.tar.gz; \
+    tar -C /tmp -xzf /tmp/frp.tar.gz; \
+    cp /tmp/${FRP_DIR}/frpc /usr/local/bin/frpc; \
+    chmod +x /usr/local/bin/frpc; \
+    rm -rf /tmp/frp* /tmp/${FRP_DIR}
+
+# Copy ExApp wrapper
+COPY ex_app /app/ex_app
+
+# Create data directory
+RUN mkdir -p /data
+
+WORKDIR /app
+
+# Expose ports
+EXPOSE 9000 8080
+
+# Environment defaults
+ENV APP_HOST=0.0.0.0
+ENV APP_PORT=9000
+ENV PYTHONUNBUFFERED=1
+ENV WEBUI_AUTH=true
+ENV ENABLE_SIGNUP=false
+
+# Entrypoint script
+COPY entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+ENTRYPOINT ["/entrypoint.sh"]

LICENSE

@@ -0,0 +1,19 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2024 Conduction B.V.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Full license text: https://www.gnu.org/licenses/agpl-3.0.txt

Makefile

@@ -0,0 +1,49 @@
+# Open WebUI Nextcloud ExApp - Build System
+
+REGISTRY ?= ghcr.io/conductionnl
+IMAGE_NAME ?= open-webui-nextcloud
+VERSION ?= 1.0.0
+
+.PHONY: build push run test clean help
+
+help:
+	@echo "Open WebUI Nextcloud ExApp"
+	@echo ""
+	@echo "Usage:"
+	@echo "  make build    - Build Docker image"
+	@echo "  make push     - Push to registry"
+	@echo "  make run      - Run locally for testing"
+	@echo "  make test     - Test endpoints"
+	@echo "  make clean    - Remove local images"
+	@echo ""
+	@echo "Variables:"
+	@echo "  REGISTRY=$(REGISTRY)"
+	@echo "  VERSION=$(VERSION)"
+
+build:
+	docker build -t $(REGISTRY)/$(IMAGE_NAME):$(VERSION) -t $(REGISTRY)/$(IMAGE_NAME):latest .
+
+push: build
+	docker push $(REGISTRY)/$(IMAGE_NAME):$(VERSION)
+	docker push $(REGISTRY)/$(IMAGE_NAME):latest
+
+run:
+	docker run -it --rm \
+		-e APP_ID=open_webui \
+		-e APP_SECRET=dev-secret \
+		-e NEXTCLOUD_URL=http://host.docker.internal:8080 \
+		-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
+		-p 9000:9000 \
+		-p 8081:8080 \
+		$(REGISTRY)/$(IMAGE_NAME):latest
+
+test:
+	@echo "Testing heartbeat endpoint..."
+	@curl -s http://localhost:9000/heartbeat || echo "Container not running"
+	@echo ""
+	@echo "Testing Open WebUI health..."
+	@curl -s http://localhost:9000/health || echo "Open WebUI not running"
+
+clean:
+	-docker rmi $(REGISTRY)/$(IMAGE_NAME):$(VERSION)
+	-docker rmi $(REGISTRY)/$(IMAGE_NAME):latest