@tuned-tensor/local 0.1.0

package/dist/process-training.js

@@ -0,0 +1,135 @@
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { access, copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { copyDatasetToTrainingChannel, fileUri, writeJson } from "./artifacts.js";
+import { resolveTrainingModel } from "./model-registry.js";
+export function buildTrainingHyperparameters(request) {
+    const model = resolveTrainingModel(request.spec_snapshot.base_model);
+    const hyper = request.hyperparameters;
+    return {
+        run_id: request.run_id,
+        base_model: model.id,
+        model_family: model.family,
+        model_loader: model.loader,
+        n_epochs: String(hyper.n_epochs),
+        learning_rate: String(hyper.learning_rate ?? model.defaultLearningRate),
+        per_device_train_batch_size: String(hyper.batch_size ?? model.defaultPerDeviceBatchSize),
+        gradient_accumulation_steps: String(hyper.gradient_accumulation_steps ?? model.defaultGradientAccumulationSteps),
+        lora_rank: String(hyper.lora_rank ?? model.defaultLoraRank),
+        lora_alpha: String(hyper.lora_alpha ?? model.defaultLoraAlpha),
+        lora_dropout: String(hyper.lora_dropout ?? model.defaultLoraDropout),
+        max_seq_length: String(hyper.max_seq_length ?? model.defaultMaxSeqLength),
+        save_adapter_only: String(hyper.save_adapter_only),
+        requires_hf_token: String(model.requiresHfToken),
+        trust_remote_code: String(model.trustRemoteCode),
+    };
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function buildUvArgs(training) {
+    const args = ["run"];
+    if (training.project)
+        args.push("--project", training.project);
+    if (training.with?.length) {
+        for (const dependency of training.with)
+            args.push("--with", dependency);
+    }
+    args.push("python");
+    if (training.module) {
+        args.push("-m", training.module);
+    }
+    else if (training.script) {
+        args.push(training.script);
+    }
+    else {
+        args.push("training/sft-local/src/train.py");
+    }
+    args.push(...training.args);
+    return args;
+}
+export async function launchProcessTraining(args) {
+    const { request, artifacts, config } = args;
+    const jobName = `tt-local-${request.run_id}`;
+    await mkdir(artifacts.trainingDir, { recursive: true });
+    await copyDatasetToTrainingChannel(artifacts);
+    const hyperparameters = buildTrainingHyperparameters(request);
+    await writeJson(join(artifacts.trainingConfigDir, "hyperparameters.json"), hyperparameters);
+    if (config.dryRun) {
+        await writeFile(artifacts.trainingLog, "Dry run enabled. uv training process was not launched.\n", "utf8");
+        return {
+            provider: "local-uv",
+            training_job_name: jobName,
+            model_artifact_uri: fileUri(artifacts.trainingModelDir),
+            base_model_artifact_uri: config.paths.baseModel ? fileUri(config.paths.baseModel) : undefined,
+            metrics: { dry_run: true },
+            exit_code: 0,
+            log_uri: fileUri(artifacts.trainingLog),
+            command: ["uv", ...buildUvArgs(config.training)],
+        };
+    }
+    const uvArgs = buildUvArgs(config.training);
+    const logStream = createWriteStream(artifacts.trainingLog, { flags: "w" });
+    const childEnv = {
+        ...process.env,
+        ...config.training.env,
+        BACKEND: "local",
+        SM_CHANNEL_TRAINING: resolve(artifacts.trainingInputDir),
+        SM_CHANNEL_BASE_MODEL: config.paths.baseModel ? resolve(config.paths.baseModel) : undefined,
+        SM_MODEL_DIR: resolve(artifacts.trainingModelDir),
+        SM_OUTPUT_DIR: resolve(artifacts.trainingOutputDir),
+        TT_HYPERPARAMETERS_PATH: resolve(artifacts.trainingConfigDir, "hyperparameters.json"),
+        HF_HOME: config.paths.modelCache ? resolve(config.paths.modelCache) : process.env.HF_HOME,
+    };
+    for (const [key, value] of Object.entries(childEnv)) {
+        if (value === undefined)
+            delete childEnv[key];
+    }
+    if (config.paths.modelCache)
+        await mkdir(config.paths.modelCache, { recursive: true });
+    const exitCode = await new Promise((resolvePromise, reject) => {
+        const child = spawn("uv", uvArgs, {
+            cwd: config.training.cwd ? resolve(config.training.cwd) : process.cwd(),
+            stdio: ["ignore", "pipe", "pipe"],
+            env: childEnv,
+        });
+        child.stdout.pipe(logStream, { end: false });
+        child.stderr.pipe(logStream, { end: false });
+        child.on("error", reject);
+        child.on("close", (code) => resolvePromise(code ?? 1));
+    }).finally(() => {
+        logStream.end();
+    });
+    const metricsPath = join(artifacts.trainingModelDir, "training-metrics.json");
+    const metrics = await pathExists(metricsPath)
+        ? JSON.parse(await readFile(metricsPath, "utf8"))
+        : null;
+    if (exitCode !== 0) {
+        throw new Error(`uv training exited with code ${exitCode}. See ${artifacts.trainingLog}.`);
+    }
+    const modelTarPath = join(artifacts.trainingOutputDir, "model.tar.gz");
+    const modelUri = await pathExists(modelTarPath)
+        ? fileUri(modelTarPath)
+        : fileUri(artifacts.trainingModelDir);
+    if (await pathExists(modelTarPath)) {
+        await copyFile(modelTarPath, join(artifacts.runDir, "model.tar.gz")).catch(() => undefined);
+    }
+    return {
+        provider: "local-uv",
+        training_job_name: jobName,
+        model_artifact_uri: modelUri,
+        base_model_artifact_uri: config.paths.baseModel ? fileUri(config.paths.baseModel) : undefined,
+        metrics,
+        exit_code: exitCode,
+        log_uri: fileUri(artifacts.trainingLog),
+        command: ["uv", ...uvArgs],
+    };
+}
+//# sourceMappingURL=process-training.js.map

package/dist/process-training.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-training.js","sourceRoot":"","sources":["../src/process-training.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import { type LocalRunnerConfig } from "./contracts.js";
+export declare function serveLocalDashboard(options?: {
+    host?: string;
+    port?: number;
+    config?: LocalRunnerConfig;
+}): Promise<{
+    url: string;
+    close(): Promise<void>;
+}>;

package/dist/server.js

@@ -0,0 +1,211 @@
+import { createServer } from "node:http";
+import { readFile, stat } from "node:fs/promises";
+import { createLocalStore } from "./store.js";
+import { fineTuneRunRequestSchema, localRunnerConfigSchema } from "./contracts.js";
+import { runLocalFineTune } from "./orchestrator.js";
+function sendJson(res, status, body) {
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+    });
+    res.end(`${JSON.stringify(body, null, 2)}\n`);
+}
+function sendText(res, status, body, contentType = "text/plain; charset=utf-8") {
+    res.writeHead(status, {
+        "Content-Type": contentType,
+        "Cache-Control": "no-store",
+    });
+    res.end(body);
+}
+async function readBody(req) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    const text = Buffer.concat(chunks).toString("utf8").trim();
+    return text ? JSON.parse(text) : {};
+}
+const DASHBOARD_HTML = `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Tuned Tensor Local</title>
+  <style>
+    body { margin: 0; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #f7f7f4; color: #1e2320; }
+    header { display: flex; justify-content: space-between; align-items: center; padding: 16px 24px; border-bottom: 1px solid #d9ddd6; background: #ffffff; position: sticky; top: 0; }
+    main { display: grid; grid-template-columns: minmax(280px, 420px) 1fr; min-height: calc(100vh - 65px); }
+    aside { border-right: 1px solid #d9ddd6; padding: 16px; overflow: auto; }
+    section { padding: 20px; overflow: auto; }
+    button { border: 1px solid #a8b0a8; background: #ffffff; padding: 7px 10px; border-radius: 6px; cursor: pointer; }
+    .run { width: 100%; text-align: left; display: grid; gap: 4px; margin-bottom: 8px; }
+    .muted { color: #667066; font-size: 12px; }
+    .pill { display: inline-block; border: 1px solid #b8c0b6; border-radius: 999px; padding: 2px 8px; font-size: 12px; background: #fff; }
+    pre { background: #1f2420; color: #eef2ed; padding: 12px; overflow: auto; border-radius: 6px; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 12px; }
+    .metric { border: 1px solid #d9ddd6; background: #fff; border-radius: 6px; padding: 12px; }
+    @media (max-width: 760px) { main { grid-template-columns: 1fr; } aside { border-right: 0; border-bottom: 1px solid #d9ddd6; } }
+  </style>
+</head>
+<body>
+  <header>
+    <strong>Tuned Tensor Local</strong>
+    <button id="refresh">Refresh</button>
+  </header>
+  <main>
+    <aside><div id="runs"></div></aside>
+    <section><div id="detail" class="muted">Select a run.</div></section>
+  </main>
+  <script>
+    let selected = null;
+    let events = null;
+    const fmt = (v) => v == null ? "—" : String(v);
+    async function api(path) {
+      const res = await fetch(path);
+      if (!res.ok) throw new Error(await res.text());
+      return res.json();
+    }
+    async function loadRuns() {
+      const runs = await api("/api/runs");
+      document.getElementById("runs").innerHTML = runs.map(run => \`
+        <button class="run" data-run="\${run.id}">
+          <span><strong>\${run.spec_name}</strong> <span class="pill">\${run.status}</span></span>
+          <span class="muted">\${run.id.slice(0, 8)} · \${run.current_stage} · \${run.base_model}</span>
+        </button>\`).join("") || '<p class="muted">No runs yet.</p>';
+      for (const el of document.querySelectorAll("[data-run]")) {
+        el.onclick = () => showRun(el.getAttribute("data-run"));
+      }
+      if (!selected && runs[0]) showRun(runs[0].id);
+    }
+    async function showRun(id) {
+      selected = id;
+      if (events) events.close();
+      const run = await api("/api/runs/" + id);
+      let report = null;
+      try { report = await api("/api/runs/" + id + "/report"); } catch {}
+      document.getElementById("detail").innerHTML = \`
+        <h2>\${run.spec_name}</h2>
+        <p><span class="pill">\${run.status}</span> <span class="muted">\${run.id}</span></p>
+        <div class="grid">
+          <div class="metric"><div class="muted">Stage</div><strong>\${run.current_stage}</strong></div>
+          <div class="metric"><div class="muted">Base Model</div><strong>\${run.base_model}</strong></div>
+          <div class="metric"><div class="muted">Model ID</div><strong>\${fmt(run.model_id)}</strong></div>
+          <div class="metric"><div class="muted">Updated</div><strong>\${run.updated_at}</strong></div>
+        </div>
+        <h3>Report</h3>
+        <pre>\${report ? JSON.stringify({
+          avg_score_delta: report.comparison?.avg_score_delta,
+          pass_rate_delta: report.comparison?.pass_rate_delta,
+          artifact: report.fine_tuned_model_id,
+          metrics: report.training?.metrics,
+        }, null, 2) : "Report not available yet."}</pre>
+        <h3>Events</h3>
+        <pre id="events"></pre>\`;
+      const eventBox = document.getElementById("events");
+      const history = await api("/api/runs/" + id + "/events");
+      eventBox.textContent = history.map(e => \`\${e.occurred_at} \${e.stage}: \${e.message}\`).join("\\n");
+      events = new EventSource("/api/runs/" + id + "/events/stream");
+      events.onmessage = (msg) => {
+        const e = JSON.parse(msg.data);
+        eventBox.textContent += "\\n" + \`\${e.occurred_at} \${e.stage}: \${e.message}\`;
+      };
+    }
+    document.getElementById("refresh").onclick = loadRuns;
+    loadRuns().catch(err => document.getElementById("detail").textContent = err.message);
+  </script>
+</body>
+</html>`;
+async function streamRunEvents(req, res, storeRoot, runId) {
+    const store = createLocalStore(storeRoot);
+    const run = await store.getRun(runId);
+    const eventPath = `${store.paths.runsDir}/${run.id}/progress.jsonl`;
+    let offset = 0;
+    res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive",
+    });
+    const sendNew = async () => {
+        const size = await stat(eventPath).then((s) => s.size).catch(() => 0);
+        if (size <= offset)
+            return;
+        const text = await readFile(eventPath, "utf8");
+        const chunk = text.slice(offset);
+        offset = text.length;
+        for (const line of chunk.split(/\r?\n/).filter(Boolean)) {
+            res.write(`data: ${line}\n\n`);
+        }
+    };
+    await sendNew();
+    const timer = setInterval(() => { sendNew().catch(() => undefined); }, 1000);
+    req.on("close", () => clearInterval(timer));
+}
+export async function serveLocalDashboard(options = {}) {
+    const host = options.host ?? "127.0.0.1";
+    const port = options.port ?? 8787;
+    const config = options.config ?? localRunnerConfigSchema.parse({});
+    const storeRoot = config.storeRoot;
+    const store = createLocalStore(storeRoot);
+    await store.ensure();
+    const server = createServer(async (req, res) => {
+        try {
+            const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+            const path = url.pathname;
+            if (req.method === "GET" && path === "/")
+                return sendText(res, 200, DASHBOARD_HTML, "text/html; charset=utf-8");
+            if (req.method === "GET" && path === "/api/health")
+                return sendJson(res, 200, { ok: true, store_root: store.root });
+            if (req.method === "GET" && path === "/api/runs")
+                return sendJson(res, 200, await store.listRuns());
+            if (req.method === "GET" && path === "/api/models")
+                return sendJson(res, 200, await store.listModels());
+            if (req.method === "GET" && path === "/api/specs")
+                return sendJson(res, 200, await store.listSpecs());
+            const runMatch = path.match(/^\/api\/runs\/([^/]+)(?:\/(events|events\/stream|report|cancel))?$/);
+            if (runMatch) {
+                const id = runMatch[1];
+                const tail = runMatch[2];
+                if (req.method === "GET" && !tail)
+                    return sendJson(res, 200, await store.getRun(id));
+                if (req.method === "GET" && tail === "events")
+                    return sendJson(res, 200, await store.getRunEvents(id));
+                if (req.method === "GET" && tail === "events/stream")
+                    return streamRunEvents(req, res, store.root, id);
+                if (req.method === "GET" && tail === "report")
+                    return sendJson(res, 200, await store.getRunReport(id));
+                if (req.method === "POST" && tail === "cancel") {
+                    await store.cancelRun(id);
+                    return sendJson(res, 200, { ok: true });
+                }
+            }
+            const modelMatch = path.match(/^\/api\/models\/([^/]+)$/);
+            if (req.method === "GET" && modelMatch)
+                return sendJson(res, 200, await store.getModel(modelMatch[1]));
+            const specMatch = path.match(/^\/api\/specs\/([^/]+)$/);
+            if (req.method === "GET" && specMatch)
+                return sendJson(res, 200, await store.getSpec(specMatch[1]));
+            if (req.method === "POST" && path === "/api/runs") {
+                const body = await readBody(req);
+                const request = fineTuneRunRequestSchema.parse(body.request ?? body);
+                const runConfig = localRunnerConfigSchema.parse({ ...config, ...(body.config ?? {}) });
+                void runLocalFineTune({ request, config: runConfig }).catch((error) => {
+                    console.error("[tt-local.serve.run]", error);
+                });
+                return sendJson(res, 202, { ok: true, run_id: request.run_id });
+            }
+            sendJson(res, 404, { error: "not_found" });
+        }
+        catch (error) {
+            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+        }
+    });
+    await new Promise((resolveListen, reject) => {
+        server.once("error", reject);
+        server.listen(port, host, () => resolveListen());
+    });
+    const address = server.address();
+    return {
+        url: `http://${host}:${address.port}/`,
+        close: async () => await new Promise((resolveClose) => server.close(() => resolveClose())),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,98 @@
+import type { FineTuneRunRequest, RunReport, SpecSnapshot } from "./contracts.js";
+export type LocalRunStatus = "queued" | "preparing" | "evaluating_baseline" | "training" | "evaluating_candidate" | "completed" | "failed" | "cancelled";
+export interface LocalRunState {
+    id: string;
+    behavior_spec_id: string;
+    user_id: string;
+    run_number: number;
+    status: LocalRunStatus;
+    current_stage: string;
+    status_message: string;
+    artifact_dir: string;
+    report_path?: string;
+    model_id?: string;
+    error?: string;
+    base_model: string;
+    spec_name: string;
+    created_at: string;
+    updated_at: string;
+    started_at?: string;
+    completed_at?: string;
+}
+export interface LocalRunEvent {
+    id: string;
+    run_id: string;
+    stage: string;
+    status: LocalRunStatus | "running" | "completed" | "failed";
+    message: string;
+    details?: Record<string, unknown>;
+    occurred_at: string;
+}
+export interface LocalRunIndexRecord extends LocalRunState {
+    catalog_updated_at: string;
+}
+export interface LocalModelRecord {
+    id: string;
+    run_id: string;
+    behavior_spec_id: string;
+    name: string;
+    provider: "local-uv";
+    base_model: string;
+    artifact_uri: string;
+    artifact_dir: string;
+    metrics: Record<string, unknown> | null;
+    created_at: string;
+}
+export interface LocalSpecRecord {
+    id: string;
+    name: string;
+    base_model: string;
+    path: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface LocalStore {
+    root: string;
+    paths: ReturnType<typeof localStorePaths>;
+    ensure(): Promise<void>;
+    importSpec(specId: string, spec: SpecSnapshot): Promise<LocalSpecRecord>;
+    listSpecs(): Promise<LocalSpecRecord[]>;
+    getSpec(id: string): Promise<LocalSpecRecord & {
+        spec: SpecSnapshot;
+    }>;
+    startRun(args: {
+        request: FineTuneRunRequest;
+        artifactDir: string;
+    }): Promise<LocalRunState>;
+    updateRun(args: {
+        runId: string;
+        status: LocalRunStatus;
+        stage: string;
+        message: string;
+        details?: Record<string, unknown>;
+    }): Promise<LocalRunState>;
+    completeRun(report: RunReport, artifactDir: string, reportPath: string): Promise<LocalRunState>;
+    failRun(runId: string, error: string): Promise<LocalRunState>;
+    cancelRun(runId: string): Promise<void>;
+    listRuns(): Promise<LocalRunIndexRecord[]>;
+    getRun(id: string): Promise<LocalRunState>;
+    getRunEvents(id: string): Promise<LocalRunEvent[]>;
+    getRunReport(id: string): Promise<RunReport>;
+    listModels(): Promise<LocalModelRecord[]>;
+    getModel(id: string): Promise<LocalModelRecord>;
+    rebuildIndexes(): Promise<void>;
+}
+export declare function defaultLocalHome(): string;
+export declare function localStorePaths(root: string): {
+    root: string;
+    specsDir: string;
+    runsDir: string;
+    modelsDir: string;
+    datasetsDir: string;
+    catalogDir: string;
+    runsCatalog: string;
+    specsCatalog: string;
+    modelsCatalog: string;
+    datasetsCatalog: string;
+};
+export declare function createLocalStore(root?: string): LocalStore;