v0.20.1

What's New in v0.20.1

Patch release. Theme: use an external OpenAI-compatible or Ollama embedder with uteke-serve and the Docker image. Two fixes, nothing else (no schema change, no API change).

Fixed

• uteke-serve ignored the embedding configuration (#1399, #1401) - the server opened its store with a hardcoded onnx backend, ServerFileConfig had no [embedding] section and UTEKE_EMBEDDING_BACKEND was only read by the CLI, so an external OpenAI-compatible or Ollama embedder could never be used by the server. The server now reads [embedding] (backend, model, api_key, base_url, endpoint_path, dims) and [vector] from uteke.toml; UTEKE_EMBEDDING_BACKEND (non-empty) wins over the file, onnx stays the default, and an unsupported backend exits at startup with a message naming the supported ones. The project-local .uteke/uteke.toml stays untrusted for embedding.*. Deployments without these settings behave exactly as before.
• Docker entrypoint downloaded the ONNX model for every backend and looped when /data was not writable (#1398, #1400) - with UTEKE_EMBEDDING_BACKEND=openai|ollama (env, or [embedding] backend in $UTEKE_HOME/uteke.toml) the ~208 MB model download is now skipped. When a download is needed but the data dir is not writable, the container exits with a message naming the fixes (chown the volume to uid 1000, pre-populate the model, or use an external embedder) instead of dying on a bare mkdir error and restarting forever. The server still needs a writable data dir for uteke.db and the index files.

📦 Downloads

Each archive contains three binaries + ONNX Runtime shared library:

Binary	Description
uteke	CLI tool
uteke-serve	HTTP server daemon
uteke-mcp	MCP server (stdio + HTTP)
libonnxruntime.so* / libonnxruntime*.dylib / onnxruntime*.dll	ONNX Runtime

Platform	File
Linux x86_64 (AVX2)	uteke-x86_64-unknown-linux-gnu-v0.20.1.tar.gz
Linux x86_64 (Legacy, SSE4.2)	uteke-x86_64-unknown-linux-gnu-legacy-v0.20.1.tar.gz
Linux ARM64	uteke-aarch64-unknown-linux-gnu-v0.20.1.tar.gz
macOS Apple Silicon	uteke-aarch64-apple-darwin-v0.20.1.tar.gz
Windows x86_64	uteke-x86_64-pc-windows-msvc-v0.20.1.zip

Legacy Bundle (Linux only) — Includes a SSE4.2-only ORT sidecar (ort-legacy/) for CPUs without AVX2 (Intel Celeron J4125/N4020). Use this bundle to avoid SIGILL crashes on older hardware.

🚀 Quick Start

# Quick install (Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/codecoradev/uteke/main/install.sh | sh

# Pin a specific version
UTEKE_VERSION=v0.20.1 curl -fsSL https://raw.githubusercontent.com/codecoradev/uteke/main/install.sh | sh

# Store a memory
uteke remember "Important context" --tags project

# Recall by meaning
uteke recall "what was that context?"

# Start server for fast AI agent access
uteke-serve --port 8767

Full changelog: https://github.com/codecoradev/uteke/blob/main/CHANGELOG.md

Community contributors

(No external contributions in this cycle. Full contributor list: https://github.com/codecoradev/uteke/graphs/contributors)