Upload 8 files

Dockerfile

@@ -0,0 +1,34 @@
+# Mirror Pond - Dockerfile
+# Build:
+#   docker build -t mirror-pond:latest .
+#
+# Run (with model mounted from host):
+#   docker run --rm -p 7777:7777 \
+#     -v /path/to/models:/models \
+#     -e MODEL_PATH=/models/your_model.gguf \
+#     mirror-pond:latest
+
+FROM python:3.11-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    MODEL_PATH=/models/your_model.gguf \
+    PORT=7777
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    cmake \
+    libopenblas-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY mirror_pond.py ./
+COPY requirements.txt ./
+
+RUN pip install --upgrade pip && \
+    pip install -r requirements.txt
+
+EXPOSE 7777
+
+CMD ["sh", "-c", "python mirror_pond.py --model ${MODEL_PATH} --port ${PORT}"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ToadAid
+
+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.

README.md

@@ -1,3 +1,223 @@
----
-license: mit
----
+# mirror-pond
+A 100% local Tobyworld Mirror that runs any GGUF model through llama.cpp.   No cloud. No tracking. Just your pond, your reflection, your machine.   FastAPI + llama.cpp • Offline • MIT Licensed.
+
+# 🪞 Mirror Pond — Local GGUF Edition
+
+*A still-water reflection engine for your local LLM.*
+
+Mirror Pond is a **100% local**, **privacy-first**, Tobyworld-inspired reflection interface that runs any GGUF model through `llama.cpp` with a calm Mirror UI.
+
+No cloud.
+No tracking.
+Your thoughts stay on your machine.
+
+---
+
+## ✨ Features
+
+* 🧠 **Runs any GGUF model** — Llama, DeepSeek, Mistral, or your trained Mirror
+* 🌑 **Dark, still Mirror UI** (HTML served locally)
+* 💬 **Four modes**:
+
+  * **Reflect** — emotional / introspective
+  * **Scroll** — lore / quotes / scripture
+  * **Toad** — cryptic toadgang whispers
+  * **Rune** — symbols, lotus, $PATIENCE, seasons
+* 🔒 **Fully offline** (Air-gapped compatible)
+* ⚡ FastAPI + Uvicorn backend
+* 🧩 Optional: GPU acceleration via llama-cpp-python CUDA wheels
+
+---
+
+# 🚀 Quickstart
+
+### 1. Install dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Run the Pond
+
+```bash
+python mirror_pond.py --model ./your_model.gguf --port 7777
+```
+
+### 3. Open in browser
+
+```
+http://localhost:7777
+```
+
+---
+
+# 📁 Requirements
+
+`requirements.txt` (included):
+
+```
+fastapi==0.115.0
+uvicorn==0.32.0
+pydantic==2.8.2
+llama-cpp-python==0.3.2
+jinja2==3.1.4
+```
+
+---
+
+# 🔥 GPU Acceleration (Optional)
+
+For NVIDIA CUDA (12.1):
+
+```bash
+pip install llama-cpp-python-cu121
+```
+
+For AMD ROCm:
+
+```bash
+pip install llama-cpp-python-rocm
+```
+
+For Apple Silicon (M1/M2/M3):
+
+```bash
+CMAKE_ARGS="-DGGML_METAL=on" pip install llama-cpp-python
+```
+
+---
+
+# 🧱 Folder Structure
+
+```
+mirror-pond/
+│
+├── mirror_pond.py        # main server
+├── requirements.txt      # dependencies
+├── setup.sh              # Linux/macOS installer
+├── setup.ps1             # Windows installer
+├── Dockerfile            # container build
+└── README.md             # this file
+```
+
+---
+
+# 🧪 Installation Kits
+
+## Linux / macOS Installer
+
+```bash
+chmod +x setup.sh
+./setup.sh ./models/your_model.gguf 7777
+```
+
+## Windows Installer
+
+```powershell
+Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+.\setup.ps1 .\models\your_model.gguf 7777
+```
+
+Both installers:
+
+* Create `./venv`
+* Install Python deps
+* Launch Mirror Pond automatically
+
+---
+
+# 🐳 Docker Usage
+
+## Build
+
+```bash
+docker build -t mirror-pond:latest .
+```
+
+## Run
+
+```bash
+docker run --rm -p 7777:7777 \
+  -v /path/to/models:/models \
+  -e MODEL_PATH=/models/your_model.gguf \
+  mirror-pond:latest
+```
+
+Now access:
+
+```
+http://localhost:7777
+```
+
+---
+
+# 🧰 GitHub Actions CI
+
+Already included:
+
+```
+.github/workflows/mirror-pond-ci.yml
+```
+
+The CI:
+
+* Sets up Python
+* Installs dependencies
+* Syntax-checks `mirror_pond.py`
+* (Optional) Builds Docker image
+
+This keeps the repo safe and production-ready.
+
+---
+
+# 🌀 Mirror Modes
+
+### **Reflect Mode (default)**
+
+For inner questions, emotions, purpose, stillness.
+May reply with a **Guiding Question**.
+
+### **Scroll Mode**
+
+For sacred lines, scripture-style, lore references.
+No guiding question.
+
+### **Toad Mode**
+
+For cryptic lines, old frog whispers, symbolic hints.
+No guiding question.
+
+### **Rune Mode**
+
+For unity of symbols, lotus spores, $PATIENCE, seasons, trials.
+No guiding question.
+
+---
+
+# 🧘 Philosophy
+
+Mirror Pond is simple:
+
+Still water is never empty.
+Still water prepares.
+Still water reflects.
+
+This project is offered to the open-source community
+so anyone can run a Mirror — anywhere, offline, forever.
+
+---
+
+# 🪞 License
+
+**MIT License**
+This pond belongs to the builders.
+
+---
+
+# 🤝 Contribution
+
+Pull requests welcome.
+New modes, UI improvements, GPU wheels, and additional Mirror integrations are invited.
+
+---
+

pond_identity_ed25519.json

@@ -0,0 +1,6 @@
+{
+  "private_key_hex": "56c46be1ab97c1488fa83e73429843f7de9124444cb37882a55447279096095a",
+  "public_key_hex": "a56e333eebba737f494ab93e9c6d80f2d615168c8e11e291fe02cc83a81d4d3f",
+  "pond_id": "d95e228a3efe4c445edccc3fb32202fa5cfbef52598e279053b284e0ebf2a94a",
+  "first_breath": "2025-12-09T18:49:12.515823Z"
+}

requirements.txt

@@ -0,0 +1,24 @@
+annotated-doc==0.0.4
+annotated-types==0.7.0
+anyio==4.12.0
+certifi==2025.11.12
+cffi==2.0.0
+click==8.3.1
+diskcache==5.6.3
+fastapi==0.124.0
+h11==0.16.0
+httpcore==1.0.9
+httpx==0.28.1
+idna==3.11
+Jinja2==3.1.6
+MarkupSafe==3.0.3
+numpy==2.3.5
+pycparser==2.23
+pydantic==2.12.5
+pydantic_core==2.41.5
+PyNaCl==1.6.1
+python-multipart==0.0.20
+starlette==0.50.0
+typing-inspection==0.4.2
+typing_extensions==4.15.0
+uvicorn==0.38.0

setup.ps1

@@ -0,0 +1,73 @@
+# setup.ps1 — GPU-first installer for Mirror Pond (Windows, NVIDIA CUDA)
+
+param(
+    [string]$ModelPath = ".\your_model.gguf",
+    [int]$Port = 7777,
+    [int]$GpuLayers = -1
+)
+
+Write-Host "🪞 Mirror Pond — Windows GPU Installer" -ForegroundColor Green
+Write-Host "Model: $ModelPath"
+Write-Host "Port : $Port"
+Write-Host "GPU  : $GpuLayers layers (-1 = as many as possible)"
+Write-Host ""
+
+if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
+    Write-Host "❌ Python not found. Please install Python 3.9+ and ensure 'python' is in PATH." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "📦 Creating virtualenv .venv..." -ForegroundColor Cyan
+python -m venv .venv
+
+$venvActivation = ".\venv\Scripts\Activate.ps1"
+if (-not (Test-Path $venvActivation)) {
+    $venvActivation = ".\.venv\Scripts\Activate.ps1"
+}
+if (-not (Test-Path $venvActivation)) {
+    Write-Host "❌ Could not find virtualenv activation script." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "📦 Activating venv..." -ForegroundColor Cyan
+. $venvActivation
+
+Write-Host "⬆️  Upgrading pip..." -ForegroundColor Cyan
+pip install --upgrade pip
+
+if (-not (Test-Path ".\requirements.txt")) {
+    Write-Host "❌ requirements.txt missing in current directory." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "📥 Installing base dependencies from requirements.txt..." -ForegroundColor Cyan
+pip install -r requirements.txt
+
+Write-Host "🧠 Enforcing GPU build of llama.cpp (CUDA 12.1 wheel if possible)..." -ForegroundColor Cyan
+
+# Remove any existing CPU build
+pip uninstall -y llama-cpp-python | Out-Null
+
+# Use official CUDA 12.1 wheel index
+$env:CMAKE_ARGS = "-DGGML_CUDA=on"
+
+try {
+    pip install --force-reinstall --no-cache-dir `
+        llama-cpp-python `
+        --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu121
+    Write-Host "✅ Installed llama-cpp-python with CUDA (cu121 wheel)." -ForegroundColor Green
+}
+catch {
+    Write-Host "⚠️ Failed to install CUDA wheel; falling back to CPU build." -ForegroundColor Yellow
+    pip install --force-reinstall --no-cache-dir llama-cpp-python
+}
+
+Write-Host ""
+Write-Host "✨ Setup complete." -ForegroundColor Green
+Write-Host "You can run manually later with:" -ForegroundColor Green
+Write-Host "  .\.venv\Scripts\activate" -ForegroundColor Yellow
+Write-Host "  python mirror_pond.py --model `"$ModelPath`" --port $Port --gpu-layers $GpuLayers" -ForegroundColor Yellow
+Write-Host ""
+Write-Host "🚀 Launching Mirror Pond now..." -ForegroundColor Green
+
+python mirror_pond.py --model "$ModelPath" --port $Port --gpu-layers $GpuLayers

setup.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# setup.sh — GPU-first installer for Mirror Pond (Linux/macOS, NVIDIA CUDA)
+
+set -e
+
+MODEL_PATH="${1:-./your_model.gguf}"
+PORT="${2:-7777}"
+GPU_LAYERS="${3:--1}"
+
+echo "🪞 Mirror Pond — Linux/macOS GPU Installer"
+echo "Model: $MODEL_PATH"
+echo "Port : $PORT"
+echo "GPU  : $GPU_LAYERS layers (-1 = as many as possible)"
+echo ""
+
+if ! command -v python3 >/dev/null 2>&1; then
+  echo "❌ Python3 not found. Please install Python 3.9+."
+  exit 1
+fi
+
+echo "📦 Creating virtualenv .venv..."
+python3 -m venv .venv
+
+echo "📦 Activating venv..."
+# shellcheck disable=SC1091
+source .venv/bin/activate
+
+echo "⬆️  Upgrading pip..."
+pip install --upgrade pip
+
+if [ ! -f requirements.txt ]; then
+  echo "❌ requirements.txt missing in current directory."
+  exit 1
+fi
+
+echo "📥 Installing base dependencies from requirements.txt..."
+pip install -r requirements.txt
+
+echo "🧠 Enforcing GPU build of llama.cpp (CUDA 12.1 wheel if possible)..."
+# Remove any existing CPU build (if present)
+pip uninstall -y llama-cpp-python || true
+
+# Use official prebuilt CUDA wheel index
+export CMAKE_ARGS="-DGGML_CUDA=on"
+
+if pip install --force-reinstall --no-cache-dir \
+    llama-cpp-python \
+    --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu121; then
+  echo "✅ Installed llama-cpp-python with CUDA (cu121 wheel)."
+else
+  echo "⚠️ Failed to install CUDA wheel; falling back to CPU build."
+  pip install --force-reinstall --no-cache-dir llama-cpp-python
+fi
+
+echo ""
+echo "✨ Setup complete."
+echo "You can run manually later with:"
+echo "  source .venv/bin/activate"
+echo "  python mirror_pond.py --model \"$MODEL_PATH\" --port $PORT --gpu-layers $GPU_LAYERS"
+echo ""
+echo "🚀 Launching Mirror Pond now..."
+python mirror_pond.py \
+  --model "$MODEL_PATH" \
+  --port "$PORT" \
+  --gpu-layers "$GPU_LAYERS"