Repository navigation
v1.0.0
Release Notes — Distillery v1.0.0
Release date: 2026-08-11
Tag: v1.0.0
Commit: 38ddbcf
Go version: 1.26.5
The first stable release of Distillery — No-Code Fine-Tuning (Task-to-Model Platform).
Distillery is a single-binary MVP of the "define a task, get a model" pipeline:
task definition → dataset curation → automatic base-model selection → managed
fine-tuning → one-click deployment → portable export → continuous
improvement loop. It runs the same way on the desktop or in a container, with
no third-party Go dependencies (standard library only).
Note on scope: GPU fine-tuning, model serving, and the frontier-model
synthetic-data bootstrap are simulated in this release so the full product
flow can be exercised end-to-end without GPUs or API keys. The
internal/infra/simulationpackage is the seam where real implementations
can be swapped in.
Highlights
Task management
- Create tasks in plain English and pick a type: classification, extraction,
or generation. - Task list with per-task dataset/training/deployment state.
Dataset curation
- Paste
input -> outputexample pairs directly. - Bulk import via CSV upload (
input/outputcolumns). - Generate synthetic variations to bootstrap a seed set.
- Automatic deduplication, low-quality row flagging, and live
label-balance / dataset-readiness checks. - Inline edit and delete of individual examples.
Fine-tuning
- Automatic right-sized base-model selection from a curated catalog.
- Simulated LoRA/QLoRA fine-tune with live progress.
- Every completed run is kept as a numbered version.
- Any version can be deployed; deploying an older version acts as an
instant rollback.
Deploy & test
- One-click deploy a model as an API endpoint.
- Deployment issues an API key shown exactly once; predictions require
Authorization: Bearer <key>orX-API-Key: <key>. Only the SHA-256 hash
is persisted. - Single-prediction testing inline.
- Batch inference: upload a CSV/text file of inputs, download a CSV of
predictions. - Portable export package: Dockerfile + manifest + adapter placeholder
to self-host anywhere. - Redeploying (including rollback) issues a fresh key and invalidates the
previous one.
Feedback loop
- Log production mispredictions and fold them back into the dataset ahead
of the next retrain.
Web UI
- Embedded single-page UI (vanilla JS, no build step).
- Tabs: Tasks, Dataset, Fine-Tuning, Deploy & Test, Feedback Loop, API Docs.
- Built-in favicon/logo assets.
Architecture
Clean / ports-and-adapters architecture; dependency direction flows inward
and internal/domain has no external dependencies.
cmd/server/main.go wiring / composition root
internal/domain/ entities + repository & service interfaces (ports)
internal/usecase/ application/business logic
internal/repository/memory/ in-memory store + JSON snapshot persistence
internal/infra/simulation/ simulated fine-tuning, inference, export, etc
internal/delivery/http/ HTTP handlers + router (Go 1.22 stdlib ServeMux)
web/ embedded single-page UI
No third-party Go dependencies — builds anywhere with no go.sum/network
access required.
Distribution
Desktop
make run
# or
go build -o distillery ./cmd/server && ./distillery
Opens http://localhost:8080 automatically; data persists to
./data/distillery.json.
Container
make docker-build
make docker-run
# or
docker build -t distillery .
docker run --rm -p 8080:8080 -v distillery-data:/data distillery
PORT, DATA_PATH, and OPEN_BROWSER are configurable env vars.
API
All endpoints under /api/v1. Representative endpoints:
POST /api/v1/tasks
GET /api/v1/tasks/{taskID}
POST /api/v1/tasks/{taskID}/examples
POST /api/v1/tasks/{taskID}/examples/import
PUT /api/v1/tasks/{taskID}/examples/{exampleID}
DELETE /api/v1/tasks/{taskID}/examples/{exampleID}
POST /api/v1/tasks/{taskID}/examples/synthetic
GET /api/v1/tasks/{taskID}/dataset/stats
POST /api/v1/tasks/{taskID}/training
GET /api/v1/training/{jobID}
POST /api/v1/tasks/{taskID}/deploy
POST /api/v1/tasks/{taskID}/training/{jobID}/deploy
POST /api/v1/inference/{deploymentID}/predict
POST /api/v1/inference/{deploymentID}/batch
GET /api/v1/tasks/{taskID}/export
POST /api/v1/tasks/{taskID}/feedback
POST /api/v1/tasks/{taskID}/feedback/fold
GET /healthz
Included components
cmd/server— composition root + startup wiring.internal/domain— entities, errors, and interface definitions
(TaskRepository,FineTuner,InferenceEngine,Exporter,
SyntheticGenerator, etc.).internal/usecase— application logic (task, dataset, training,
deployment, feedback) with unit tests and mocks.internal/repository/memory— in-memory store with JSON snapshot
persistence and repository tests.internal/infra/simulation— simulated trainer, inference engine,
exporter, synthetic generator, and model selector adapters.internal/delivery/http— HTTP handlers, DTOs, and stdlib router.web/— embedded UI (HTML/CSS/JS) andembed.go.
Testing
- Unit tests across usecases and repositories (mocks for domain ports).
make testrunsgo vet ./...andgo build ./....
Known simplifications (MVP)
- Single-node persistence (JSON snapshot guarded by an in-process mutex);
not suitable for horizontally-scaled multi-instance deployment. - The task-management API (
/api/v1/tasks/...) has no auth — add
middleware ininternal/delivery/http/router.gobefore exposing beyond
localhost. - Training and inference are simulated; swap adapters in
internal/infra/simulationto integrate real GPU jobs and model servers.
Upgrading
This is the initial release; no upgrade path is required. To start from a
clean state, delete data/distillery.json.