openvoiceui 1.0.0

package/.env.example

@@ -0,0 +1,104 @@
+# =============================================================================
+# OpenVoiceUI — .env.example
+# Copy to .env and fill in your values: cp .env.example .env
+# =============================================================================
+
+# Server
+PORT=5001
+DOMAIN=your-domain.com
+
+# Flask secret key — generate with: python3 -c "import secrets; print(secrets.token_hex(32))"
+# Required for persistent sessions. If unset, a random key is generated per restart.
+SECRET_KEY=your-secret-key-here
+
+# Canvas pages directory
+# VPS/systemd install: set to the path created by deploy/setup-sudo.sh
+# Docker install:      leave UNSET — defaults to runtime/canvas-pages/ inside the container
+#                      (matches the docker-compose volume mount)
+# CANVAS_PAGES_DIR=/var/www/openvoiceui/canvas-pages
+
+# =============================================================================
+# OpenClaw Gateway (required for LLM / voice conversations)
+# Download and install OpenClaw: https://openclaw.ai
+# =============================================================================
+CLAWDBOT_GATEWAY_URL=ws://127.0.0.1:18791
+CLAWDBOT_AUTH_TOKEN=your-openclaw-gateway-token
+
+# Coding CLI for the openclaw container (activates the coding-agent skill).
+# Same options as openclaw's setup wizard. Choose one:
+#   codex    — OpenAI Codex CLI  (also set OPENAI_API_KEY)
+#   claude   — Anthropic Claude Code  (also set ANTHROPIC_API_KEY)
+#   opencode — OpenCode  (bring your own provider key)
+#   pi       — Pi coding agent  (bring your own provider key)
+#   none     — skip (coding-agent skill inactive, default)
+# Note: if you already ran openclaw's setup wizard it handled this for you.
+# CODING_CLI=codex
+
+# OpenClaw version for the Docker image — pinned to a tested release.
+# Only change this if you've verified the new version works with OpenVoiceUI.
+# OPENCLAW_VERSION=2026.3.13
+
+# Session key prefix — change if running multiple instances on the same gateway
+GATEWAY_SESSION_KEY=voice-main-1
+
+# =============================================================================
+# TTS — choose one or more providers
+# =============================================================================
+
+# Groq Orpheus (recommended — fast, high quality, free tier available)
+# Get key: https://console.groq.com
+GROQ_API_KEY=your-groq-api-key
+USE_GROQ=true
+USE_GROQ_TTS=true
+
+# Qwen3-TTS via fal.ai (optional)
+# Get key: https://fal.ai/dashboard
+# FAL_KEY=your-fal-key
+
+# Hume EVI (optional — expressive, emotion-aware TTS)
+# Get keys: https://platform.hume.ai/settings/keys
+# HUME_API_KEY=your-hume-api-key
+# HUME_SECRET_KEY=your-hume-secret-key
+
+# Supertonic (ships with docker compose — no config needed)
+# Override only if you run the Supertonic service elsewhere:
+# SUPERTONIC_API_URL=http://supertonic:8765
+
+# =============================================================================
+# Authentication — Clerk (optional)
+# Without Clerk, the app runs open — no login required (fine for single-user).
+# To require login: set key below + CANVAS_REQUIRE_AUTH=true + ALLOWED_USER_IDS
+# Get keys: https://clerk.com → Your App → API Keys
+# =============================================================================
+# CLERK_PUBLISHABLE_KEY=pk_live_...
+# CANVAS_REQUIRE_AUTH=true
+
+# Restrict access to specific user IDs (recommended in production)
+# Find your user_id in server logs after first login, then set it here
+# ALLOWED_USER_IDS=user_abc123,user_xyz789
+
+# =============================================================================
+# Vision (optional — for screenshot/image analysis)
+# Get key: https://aistudio.google.com/app/apikey
+# =============================================================================
+# GEMINI_API_KEY=your-gemini-key
+
+# =============================================================================
+# Music Generation (optional — Suno AI)
+# =============================================================================
+# SUNO_API_KEY=your-suno-key
+# SUNO_CALLBACK_URL=https://your-domain.com/api/suno/callback
+# SUNO_WEBHOOK_SECRET=your-webhook-secret   # optional HMAC verification
+
+# =============================================================================
+# Search (optional — Brave Search for web_search tool in OpenClaw agent)
+# Free tier: 2,000 queries/month. Get key: https://brave.com/search/api/
+# Must also be set in the OpenClaw gateway service environment.
+# =============================================================================
+# BRAVE_API_KEY=your-brave-search-api-key
+
+# =============================================================================
+# Rate limiting (optional — overrides defaults set in app.py)
+# Format: "N per period" e.g. "500 per day" or "500 per day;100 per hour"
+# =============================================================================
+# RATELIMIT_DEFAULT=200 per day;50 per hour

package/Dockerfile

@@ -0,0 +1,30 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# System deps for cryptography, audio processing, vision, and canvas features
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential libffi-dev \
+    libgl1 libglib2.0-0 \
+    ffmpeg \
+    libsndfile1 && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# Writable dirs for runtime data
+RUN mkdir -p runtime/uploads runtime/canvas-pages runtime/known_faces runtime/music runtime/generated_music runtime/faces runtime/transcripts
+
+# Run as non-root user
+RUN useradd -m -u 1001 appuser && chown -R appuser:appuser /app
+USER appuser
+
+# Bind to all interfaces inside the container
+ENV HOST=0.0.0.0
+
+EXPOSE 5001
+
+CMD ["python3", "server.py"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenVoiceUI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.