mirror of
https://github.com/mudler/LocalAI.git
synced 2026-06-14 19:58:44 -04:00
718223f33b
* chore(localvqe): update backend to v1.3, add v1.2/v1.3 gallery models Bump the LocalVQE backend pin 72bfb4c6 -> b0f0378a, which adds the v1.2 (1.3 M) and v1.3 (4.8 M) GGUF SHA-256s to the upstream released-models allowlist (and the arch_version=3 loader) so both load without LOCALVQE_ALLOW_UNHASHED. Add gallery entries for localvqe-v1.2-1.3m and localvqe-v1.3-4.8m (SHA-256 verified against the downloaded weights) and update the audio-transform docs to make v1.3 the current default while noting the compact v1.1/v1.2 alternatives. Assisted-by: Claude:claude-opus-4-8 Claude-Code Signed-off-by: Richard Palethorpe <io@richiejp.com> * chore(flake): add ffmpeg-headless to the dev shell pkg/utils/ffmpeg_test.go shells out to the `ffmpeg` CLI, and the pre-commit gate runs those tests via `make test-coverage`. Without ffmpeg in the dev shell the gate fails with "executable file not found in $PATH". The headless build provides the CLI without GUI/X deps. Assisted-by: Claude:claude-opus-4-8 [Claude Code] Signed-off-by: Richard Palethorpe <io@richiejp.com> * fix(localvqe): parse WAV by walking RIFF sub-chunks Walk the RIFF chunk list instead of assuming the canonical 44-byte header layout. Real inputs (browser-recorded clips, ffmpeg output with an 18/40-byte extensible `fmt ` chunk or trailing LIST/INFO metadata) would otherwise splice header/metadata bytes into the PCM stream as an audible impulse. Honour the `data` chunk size and validate that both `fmt ` and `data` chunks are present. Assisted-by: Claude:claude-opus-4-8 [Claude Code] Signed-off-by: Richard Palethorpe <io@richiejp.com> * fix(security-headers): allow blob: in connect-src for waveform fetch The waveform renderer XHRs/fetches a freshly-created blob: object URL (e.g. an uploaded or enhanced clip before it has a server URL). XHR/fetch of blob: is governed by connect-src, not media-src, so it was blocked by the CSP. Add blob: to connect-src. Assisted-by: Claude:claude-opus-4-8 [Claude Code] Signed-off-by: Richard Palethorpe <io@richiejp.com> * feat(react-ui): add input/output spectrogram view to AudioTransform The transform page only showed time-domain amplitude waveforms, so you could see how loud a clip was but not which frequencies the model touched. Add a time x frequency spectrogram heatmap and render the input and output spectrums side by side, so it's visible which bands the enhancement attenuates (bright input bands that go dark in the output). Computed client-side via a Hann-windowed STFT over both clips (a small dependency-free radix-2 FFT), defaulting to the LocalVQE 512/256 frame geometry. This shows the net input->output spectral change; the model's internal gain mask is not exposed by the backend. - src/utils/fft.js radix-2 FFT - src/hooks/useSpectrogram.js decode + STFT -> normalised dB magnitude grid - src/components/audio/Spectrogram.jsx canvas heatmap (magma colormap) - AudioTransform.jsx dual-spectrogram panel + CSS - e2e spec + UI coverage baseline bump (38.29 -> 39.0; measured ~39.4-40.2) Assisted-by: Claude:claude-opus-4-8 [Claude Code] Signed-off-by: Richard Palethorpe <io@richiejp.com> * test(react-ui): make UI coverage deterministic, tighten the gate UI e2e line coverage swung ~1pp run-to-run (39.1% <-> 40.2%), which forced a loose 0.8pp tolerance on the monotonic gate — a band wide enough to let a real ~300-line regression through silently. The swing was a bug, not inherent jitter: the 'Create Agent navigates' spec ended on the URL assertion, so AgentCreate.jsx's ~400 lines were collected only when its render happened to beat the coverage teardown. Wait for the page to actually render (assert its heading) so those lines are covered every run. With the race gone, repeated runs land within ~0.013pp of each other, so: - tighten UI_COVERAGE_TOLERANCE 0.8 -> 0.1 (noise floor, not a drift band) - set the baseline to the real, reliably-achieved value (39.0 -> 39.86) Localised by running the V8-coverage suite repeatedly and diffing per-file line coverage; AgentCreate.jsx was the sole ~1pp flipper. Assisted-by: Claude:claude-opus-4-8 [Claude Code] Signed-off-by: Richard Palethorpe <io@richiejp.com> --------- Signed-off-by: Richard Palethorpe <io@richiejp.com>
100 lines
3.2 KiB
Makefile
100 lines
3.2 KiB
Makefile
CMAKE_ARGS?=
|
||
BUILD_TYPE?=
|
||
NATIVE?=false
|
||
|
||
GOCMD?=go
|
||
GO_TAGS?=
|
||
JOBS?=$(shell nproc --ignore=1)
|
||
|
||
# LocalVQE upstream version pin. Bump to a specific commit when picking up
|
||
# a new release; `main` works for development but is not reproducible.
|
||
LOCALVQE_REPO?=https://github.com/localai-org/LocalVQE
|
||
LOCALVQE_VERSION?=b0f0378a450e87c871b85689554801601ca56d98
|
||
|
||
# LocalVQE handles CPU feature selection internally (it ships the multiple
|
||
# libggml-cpu-*.so variants and its loader picks the best one at runtime
|
||
# via GGML_BACKEND_DL), so we build a single liblocalvqe.so + the per-CPU
|
||
# ggml shared libs and let it sort itself out. No need for a wrapper
|
||
# MODULE library or per-AVX backend variants here.
|
||
|
||
CMAKE_ARGS+=-DLOCALVQE_BUILD_SHARED=ON
|
||
CMAKE_ARGS+=-DGGML_BUILD_TESTS=OFF
|
||
CMAKE_ARGS+=-DGGML_BUILD_EXAMPLES=OFF
|
||
|
||
ifeq ($(NATIVE),false)
|
||
CMAKE_ARGS+=-DGGML_NATIVE=OFF
|
||
endif
|
||
|
||
# LocalVQE upstream supports CPU + Vulkan only. Other BUILD_TYPE values
|
||
# fall through to the default CPU build — Vulkan is already as fast as the
|
||
# specialised GPU paths would be on these small (1.3 M–4.8 M parameter)
|
||
# models.
|
||
ifeq ($(BUILD_TYPE),vulkan)
|
||
CMAKE_ARGS+=-DGGML_VULKAN=ON -DLOCALVQE_VULKAN=ON
|
||
else ifeq ($(OS),Darwin)
|
||
CMAKE_ARGS+=-DGGML_METAL=OFF
|
||
endif
|
||
|
||
# --- Sources ---
|
||
|
||
sources/LocalVQE:
|
||
mkdir -p sources/LocalVQE
|
||
cd sources/LocalVQE && \
|
||
git init && \
|
||
git remote add origin $(LOCALVQE_REPO) && \
|
||
git fetch origin && \
|
||
git checkout $(LOCALVQE_VERSION) && \
|
||
git submodule update --init --recursive --depth 1 --single-branch
|
||
|
||
# --- Native build ---
|
||
#
|
||
# Drives cmake directly against the upstream LocalVQE/ggml CMakeLists.
|
||
# Produces liblocalvqe.so plus the per-CPU libggml-cpu-*.so variants in
|
||
# build/bin/, all of which we copy into the backend directory so package.sh
|
||
# can pick them up. The `liblocalvqe.so` rule deliberately uses a sentinel
|
||
# stamp file because Make's wildcard tracking would otherwise mis-decide
|
||
# about freshness when SOVERSION symlinks are involved.
|
||
|
||
LIB_SENTINEL=.localvqe-build.stamp
|
||
|
||
$(LIB_SENTINEL): sources/LocalVQE
|
||
mkdir -p build && \
|
||
cd build && \
|
||
cmake ../sources/LocalVQE/ggml $(CMAKE_ARGS) -DCMAKE_BUILD_TYPE=Release && \
|
||
cmake --build . --config Release -j$(JOBS)
|
||
# Upstream's CPU build sets GGML_BACKEND_DL=ON + GGML_CPU_ALL_VARIANTS=ON,
|
||
# which produces multiple libggml-cpu-*.so files (SSE4.2 / AVX2 / AVX-512)
|
||
# that the loader picks at runtime. We must build every target — the
|
||
# default `--target localvqe_shared` drops these. CMAKE_LIBRARY_OUTPUT_DIRECTORY
|
||
# routes all of them into build/bin; copy them out next to the binary.
|
||
cp -P build/bin/liblocalvqe.so* . 2>/dev/null || cp -P build/liblocalvqe.so* .
|
||
cp -P build/bin/libggml*.so* . 2>/dev/null || true
|
||
touch $(LIB_SENTINEL)
|
||
|
||
liblocalvqe.so: $(LIB_SENTINEL)
|
||
|
||
# --- Go binary + packaging ---
|
||
|
||
localvqe: main.go golocalvqe.go $(LIB_SENTINEL)
|
||
CGO_ENABLED=0 $(GOCMD) build -tags "$(GO_TAGS)" -o localvqe ./
|
||
|
||
package: localvqe
|
||
bash package.sh
|
||
|
||
build: package
|
||
|
||
clean: purge
|
||
rm -rf liblocalvqe.so* libggml*.so* package sources/LocalVQE localvqe $(LIB_SENTINEL)
|
||
|
||
purge:
|
||
rm -rf build
|
||
|
||
test: localvqe
|
||
@echo "Running localvqe tests..."
|
||
bash test.sh
|
||
@echo "localvqe tests completed."
|
||
|
||
all: localvqe package
|
||
|
||
.PHONY: build package clean purge test all
|