feat: rename project from xcstrings-translator to opentrans and update Docker configuration

- Rename binary from xcstrings-translator to opentrans in build scripts and workflows
- Update CI workflow to trigger on 'next' branch instead of 'main'
- Add yzma/llama.cpp library support with proper runtime dependencies
- Enhance Dockerfile with multi-stage build including yzma CLI tool and library handling
- Update .gitignore to reflect new binary name
- Add comprehensive Docker run examples with environment variables and volume mounts
- Configure library paths and permissions for non-root execution

Author: umesok

.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: CI
 
 on:
   push:
-    branches: [ main ]
+    branches: [ next ]
   pull_request:
 
 jobs:
@@ -87,7 +87,7 @@ jobs:
           CGO_ENABLED: 0
         run: |
           mkdir -p dist
-          go build -o dist/xcstrings-translator-${{ matrix.suffix }} .
+          go build -o dist/opentrans-${{ matrix.suffix }} .
 
   gui-build:
     runs-on: ${{ matrix.os }}
@@ -154,4 +154,4 @@ jobs:
           CGO_ENABLED: 1
         run: |
           mkdir -p dist
-          go build -tags gui -o dist/xcstrings-translator-${{ matrix.suffix }} .
+          go build -tags gui -o dist/opentrans-${{ matrix.suffix }} .

.github/workflows/docker-release.yml

@@ -2,7 +2,7 @@ name: Build and Push Docker Image
 
 on:
   push:
-    branches: [ main ]
+    branches: [ next ]
     # tags: [ 'v*' ]
 
 env:

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-xcstrings-translator
+opentrans
 .DS_Store
 dist/
 !webui/dist/

.gitignore

@@ -16,16 +16,25 @@ RUN git clone https://github.com/fdddf/opentrans.git . && \
 # Builder stage
 FROM golang:1.25-alpine AS builder
 
-RUN apk update && apk add --no-cache make gcc musl-dev
+RUN apk update && apk add --no-cache make gcc musl-dev git
 
-# Set working directory
+# Set working directory to backend where go.mod is located
 WORKDIR /app
 
-COPY . .
+COPY backend/ .
 
 # Install Go dependencies
 RUN go env -w GOPROXY='https://goproxy.cn,direct' && go mod tidy
 
+# Install yzma CLI tool to download llama.cpp libraries
+RUN go install github.com/hybridgroup/yzma/cmd/yzma@latest
+
+# Download llama.cpp precompiled libraries for Linux (will be placed in ./lib by default)
+RUN yzma lib get || true
+
+# Ensure lib directory exists (even if yzma lib get fails)
+RUN mkdir -p /app/lib
+
 # Copy built UI assets from ui-builder stage
 COPY --from=ui-builder /app/webui/dist ./webui/dist
 
@@ -35,10 +44,13 @@ RUN make
 # Final stage - minimal Alpine image
 FROM alpine:latest
 
-# Install runtime dependencies
+# Install runtime dependencies including libyzma support
 RUN apk --no-cache add \
     ca-certificates \
     tzdata \
+    libstdc++ \
+    libgcc \
+    libffi \
     && update-ca-certificates
 
 # Create non-root user
@@ -48,9 +60,17 @@ RUN addgroup -g 65532 --system nonroot && \
 # Copy the binary from builder stage
 COPY --from=builder /app/opentrans /usr/local/bin/opentrans
 
-# Create app directory and set permissions
-RUN mkdir -p /app && \
-    chown -R nonroot:nonroot /app
+# Copy yzma/llama.cpp libraries from builder stage
+COPY --from=builder --chown=nonroot:nonroot /app/lib /usr/local/lib/yzma
+
+# Create app directory, models directory for local Llama models, library directory, and set permissions
+RUN mkdir -p /app /app/models /usr/local/lib/yzma && \
+    chown -R nonroot:nonroot /app && \
+    chmod -R 755 /usr/local/lib/yzma
+
+# Set yzma library path
+ENV LD_LIBRARY_PATH=/usr/local/lib/yzma
+ENV YZMA_LIB=/usr/local/lib/yzma
 
 WORKDIR /app
 

Dockerfile

@@ -47,8 +47,69 @@ A modern iOS/macOS multilingual string translation management platform supportin
 ### Quick Start with Docker
 
 ```bash
+# Build the Docker image
 docker build -t opentrans .
+
+# Run with default configuration
 docker run -p 3000:3000 opentrans
+
+# Run with environment variables
+docker run -d \
+  -p 3000:3000 \
+  -e DB_HOST=your-db-host \
+  -e DB_PORT=5432 \
+  -e DB_USER=your-db-user \
+  -e DB_PASSWORD=your-db-password \
+  -e DB_NAME=xcstrings_translator \
+  -e JWT_SECRET=your-jwt-secret \
+  -e GOOGLE_API_KEY=your-google-api-key \
+  -e DEEPL_API_KEY=your-deepl-api-key \
+  -e BAIDU_APP_ID=your-baidu-app-id \
+  -e BAIDU_APP_SECRET=your-baidu-app-secret \
+  -e OPENAI_API_KEY=your-openai-api-key \
+  -e ADMIN_USERNAME=admin \
+  -e ADMIN_EMAIL=admin@example.com \
+  -e ADMIN_PASSWORD=admin123 \
+  --name opentrans \
+  opentrans
+
+# Run with environment file
+docker run -d \
+  -p 3000:3000 \
+  --env-file .env \
+  --name opentrans \
+  opentrans
+
+# Run with config file mount and environment variables
+docker run -d \
+  -p 3000:3000 \
+  -v $(pwd)/config.yaml:/app/config.yaml:ro \
+  -v $(pwd)/models:/app/models \
+  -e DB_HOST=your-db-host \
+  -e DB_PORT=5432 \
+  -e DB_USER=your-db-user \
+  -e DB_PASSWORD=your-db-password \
+  -e DB_NAME=xcstrings_translator \
+  -e JWT_SECRET=your-jwt-secret \
+  --name opentrans \
+  opentrans
+
+# Run with persistent volume for local Llama models
+docker run -d \
+  -p 3000:3000 \
+  -v opentrans-models:/app/models \
+  --env-file .env \
+  --name opentrans \
+  opentrans
+
+# Check logs
+docker logs -f opentrans
+
+# Stop the container
+docker stop opentrans
+
+# Remove the container
+docker rm opentrans
 ```
 
 ### Manual Installation

README.md

@@ -1,5 +1,5 @@
 -- ============================================
--- xcstrings-translator Database Schema
+-- opentrans Database Schema
 -- Combined migration - all tables and fields
 -- ============================================