Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
import { useCallback, useEffect, useRef, useState } from "react";
import { getTinfoilModels, type CloudModelDefinition } from "../models/ModelRegistry";
import { isTinfoilListFresh, refreshTinfoilModels } from "../models/tinfoilModels";
import logger from "../utils/logger";
interface UseTinfoilModelsResult {
models: CloudModelDefinition[];
loading: boolean;
error: string | null;
refresh: () => Promise<void>;
}
/**
* Refreshes Tinfoil's model list into the registry and re-renders with it. Pass
* `enabled` only while the user is looking at Tinfoil, so nobody else's settings
* visit reaches out to it. The registry keeps its last known list when the fetch
* fails, so the picker stays usable offline.
*/
export function useTinfoilModels(enabled: boolean): UseTinfoilModelsResult {
const [models, setModels] = useState<CloudModelDefinition[]>(() => getTinfoilModels());
const [loading, setLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
const isMountedRef = useRef(true);
useEffect(() => {
isMountedRef.current = true;
return () => {
isMountedRef.current = false;
};
}, []);
const refresh = useCallback(async () => {
// A list we fetched within the hour resolves without touching the network,
// so don't flash a "refreshing" state the user can't even read.
const willFetch = !isTinfoilListFresh();
if (willFetch && isMountedRef.current) {
setLoading(true);
setError(null);
}
try {
const fresh = await refreshTinfoilModels();
if (isMountedRef.current) {
setModels(fresh);
}
} catch (err) {
// Leave the known list in place: without an answer we can't tell a
// retired model from an unreachable endpoint.
logger.error("Failed to load Tinfoil models", { error: err }, "models");
if (isMountedRef.current) {
setError((err as Error).message || "Unable to load models");
}
} finally {
if (willFetch && isMountedRef.current) {
setLoading(false);
}
}
}, []);
useEffect(() => {
if (!enabled) return;
refresh();
}, [enabled, refresh]);
return { models, loading, error, refresh };
}