Repository navigation
What's New in v0.24.1
Patch release. Theme: uteke-serve 0.24.0 never started listening. Every start of 0.24.0 stopped
after the log line "Lifecycle config loaded": /health never answered, so the Docker image showed
unhealthy, and the stuck process kept the index file lock. If you run uteke-serve or the Docker image,
upgrade from 0.24.0 to 0.24.1. The uteke CLI and uteke-mcp have their own start-up and were not
affected: every CLI command and an MCP stdio session were run against this code.
Upgrade notes
- No schema change: the store stays at schema v27, so a 0.24.0 data directory opens as is.
- Correction to the 0.24.0 notes, which said an older binary ignores the new tables: a 0.23.0 binary
refuses a store at schema v26 or v27 ("database schema version N is newer than supported version 25").
Back up the data directory before moving to 0.24.x if you may roll back. - A remote document search query is at most 2000 characters (#1777); a longer one is a 400.
POST /doc/searchis LAB, the CLI is unchanged.
Docs
- The
uteke-memoryskill (both copies),docs/mcp.mdand the generated API reference say that a
remote document search query is at most 2000 characters (#1777); the Docker tag table names the
0.24minor tag.
Fixed
-
POST /doc/searchanduteke_doc_searchbound the query (#1777) - a remote document search took a
query of any length (up to the 10 MB request limit) and embedded it under an embedding slot. The query
is now at most 2000 characters in every mode, the same bound as a remote skill search: a longer one is a
400 (an MCP tool error) before a slot is taken.POST /doc/searchis LAB; the CLI is unchanged. -
uteke-servev0.24.0 no longer hangs at startup - the server stopped after the log line
"Lifecycle config loaded" and never listened: it took the storeMutextwice inside onelet ctx = ...
statement (the[recall]defaults from #1754 and the embedding gate from #1753), the first guard was a
temporary that lives to the end of the statement, and the secondlock()waited on it forever. Every
start of v0.24.0 was affected:/healthnever answered (Docker showed the container unhealthy), the
process ignored SIGTERM as PID 1 and kept the index file lock, soverify,repairanddoctorblocked.
Each value is now taken in its own statement. A new test starts the realuteke-serveand waits for
GET /health.
📦 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.24.1.tar.gz |
| Linux x86_64 (Legacy, SSE4.2) | uteke-x86_64-unknown-linux-gnu-legacy-v0.24.1.tar.gz |
| Linux ARM64 | uteke-aarch64-unknown-linux-gnu-v0.24.1.tar.gz |
| macOS Apple Silicon | uteke-aarch64-apple-darwin-v0.24.1.tar.gz |
| Windows x86_64 | uteke-x86_64-pc-windows-msvc-v0.24.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.24.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 8767Full 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)