Martin Dvorak
756a6257a2
Entry points (no sixth tab): Ask in the Library header (desktop button, phone icon), Ask about this deck in the deck menu, Ask a question on study/homework results (compact result travels as context), and a Chat row in the desktop sidebar. Phones get a full-screen route with back + New chat; the tab bar steps aside. - Client-side retrieval: chunk scoped decks (~800 tokens), BM25 against the question + recent turns, top chunks under ~7k tokens, each labelled with deck + section. Notes come from the deck's stored sourceText (already kept for Regenerate); decks without it fall back to generated content and the UI says so. - Stateless server: /api/chat validates against the CHAT_MODELS allowlist, trims the history to ~6k tokens, caps context at ~9k and streams token/thinking/done/error NDJSON. /api/chat/extract reduces attachments to text through the existing vision step. - UI: user bubbles + full-width assistant text, streaming with stop, auto-scroll that pauses with a jump-to-bottom button, safe markdown (React nodes, no HTML injection; KaTeX dynamically imported only when a message has math), Thinking row for reasoning, copy/regenerate/ edit-and-resend, model + context pickers (last model remembered), composer with visualViewport keyboard handling, safe-area, 16px textarea, Enter-to-send on desktop. - Usage-limit failures keep the draft and show the shared message with Settings/Ollama actions; stopping maps the reader abort to a clean stopped state; offline disables sending with a reason. - Settings: Keep notes text for chat toggle; deck menu: Delete notes text. RATE_LIMIT_CHAT + CHAT_MODELS in .env.example and README. - Tests: chat suite (63 checks, stub Ollama) wired into run-all. Full set: 12/12 suites, 487 checks. SW -> freezmo-v32. Also: tests/model-compare.mjs (diagnostic) benchmarks two models on the same notes (latency, repair rounds, activity types) so the gpt-oss vs gemma default can be decided on numbers; defaults unchanged.
89 lines
4.2 KiB
Bash
89 lines
4.2 KiB
Bash
# ---------------------------------------------------------------------------
|
|
# Freezmo - Ollama configuration
|
|
# Copy this file to `.env.local` and adjust if needed.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# WHO PROVIDES THE API KEY -----------------------------------------------------
|
|
# user-key (default) Every browser supplies its own key. The key is typed
|
|
# into the settings dialog, kept in that browser's local
|
|
# storage and sent with each request in the
|
|
# `x-ollama-key` header. The server never stores it.
|
|
# Point OLLAMA_BASE_URL at https://ollama.com.
|
|
# server One key for everyone, read from OLLAMA_API_KEY below
|
|
# (single-user installs). Nothing is sent from the client.
|
|
# local No key at all: a local daemon signed in with
|
|
# `ollama signin` proxies the cloud models.
|
|
OLLAMA_AUTH=user-key
|
|
|
|
# Ollama endpoint. https://ollama.com for cloud, http://localhost:11434 for a
|
|
# local daemon. In user-key mode this is the endpoint the browser's key is sent
|
|
# to; in server/local mode it is used directly.
|
|
OLLAMA_BASE_URL=https://ollama.com
|
|
|
|
# Only used when OLLAMA_AUTH=server. Never commit a real key.
|
|
OLLAMA_API_KEY=
|
|
|
|
# Model used for the vision/transcription step (reads photos of notes).
|
|
# Must be multimodal — gpt-oss and other text-only models cannot be used here.
|
|
# Free-tier friendly: gemma4:31b-cloud, kimi-k3:cloud (paid), mistral-large-3 (paid).
|
|
VISION_MODEL=gemma4:31b-cloud
|
|
|
|
# Model used to generate activities, grade short answers and restore the
|
|
# language if a transcription came back translated. gpt-oss:120b is free-tier
|
|
# friendly, very good at strict JSON and the strongest multilingual model in the
|
|
# free plan. NOTE: it is text-only, so it can't be used as VISION_MODEL.
|
|
# Free alternatives: nemotron-3-super:cloud, gpt-oss:20b-cloud.
|
|
# Paid/credit: glm-5.3-flash:cloud, kimi-k3:cloud.
|
|
TEXT_MODEL=gpt-oss:120b-cloud
|
|
|
|
# CHAT MODELS (optional) -------------------------------------------------------
|
|
# The allowlist the chat model picker offers, comma-separated. The server never
|
|
# accepts a model name outside this list. The first entry is the default.
|
|
# When unset, the configured TEXT_MODEL and VISION_MODEL are used.
|
|
# Example: CHAT_MODELS=gemma4:31b-cloud,gpt-oss:120b-cloud
|
|
# CHAT_MODELS=
|
|
|
|
# RATE LIMITS (per client IP, sliding window, in-memory) ----------------------
|
|
# Generation decks are expensive, so they are limited tightly by default.
|
|
# RATE_LIMIT_WINDOW_MS=300000
|
|
# RATE_LIMIT_GENERATE=12
|
|
# RATE_LIMIT_GRADE=40
|
|
# RATE_LIMIT_HOMEWORK=12
|
|
# Homework follow-ups (short rewrites).
|
|
# RATE_LIMIT_REFINE=30
|
|
# RATE_LIMIT_HEALTH=90
|
|
# Encrypted sync (no model calls, but shouldn't be hammered).
|
|
# RATE_LIMIT_SYNC=60
|
|
# Push subscription changes and test sends.
|
|
# RATE_LIMIT_PUSH=30
|
|
# Chat turns (one model call each; users send them in bursts).
|
|
# RATE_LIMIT_CHAT=60
|
|
|
|
# PUSH REMINDERS (optional) ----------------------------------------------------
|
|
# Web Push reminders only appear in the UI when BOTH VAPID keys are set.
|
|
# Generate them once with: npx web-push generate-vapid-keys
|
|
# VAPID_PUBLIC_KEY=
|
|
# VAPID_PRIVATE_KEY=
|
|
# VAPID_SUBJECT=mailto:you@example.com
|
|
# Where subscriptions are stored (endpoint + keys only, no personal data).
|
|
# PUSH_DIR=.freezmo/push
|
|
# The daily sender is a script you schedule yourself (cron/systemd timer):
|
|
# node scripts/send-reminders.mjs
|
|
# PUSH_REMINDER_TITLE=Time to review
|
|
# PUSH_REMINDER_BODY=Your decks are waiting — a few due cards keep the streak alive.
|
|
|
|
# ENCRYPTED SYNC STORAGE -------------------------------------------------------
|
|
# Opt-in sync uploads an opaque AES-GCM blob; the server can't read it and
|
|
# never sees the passphrase or the API key. One small JSON file per sync ID.
|
|
# SYNC_DIR=.freezmo/sync
|
|
# Per-blob cap in bytes (larger uploads are refused with HTTP 413).
|
|
# SYNC_MAX_BYTES=12582912
|
|
# Total cap for the directory in bytes (new blobs refused with HTTP 507).
|
|
# SYNC_TOTAL_BYTES=1073741824
|
|
|
|
# Optional tuning ------------------------------------------------------------
|
|
# OLLAMA_TIMEOUT_MS=300000
|
|
# OLLAMA_HEALTH_TIMEOUT_MS=8000
|
|
# Send `think: false` to thinking models for faster JSON output.
|
|
# OLLAMA_THINK=false
|
|
# FREEZMO_DEFAULT_ACTIVITY_COUNT=10
|