Field notes
OpenFace is easier to operate when you understand why its parts exist. These pieces begin with a problem, follow the design decision, and end with links into the reference atlas and practical guides.
Start with the idea
OpenFace v0.6.0: measure the surface, preserve the evidence
How one PostgreSQL event ledger makes views, completed downloads, and active likes measurable, while calmer navigation, tablet-safe Spaces, MCP setup guidance, and a saved logo exploration keep the visible surface reviewable.
OpenFace v0.5.0: move state to a safer operating boundary
How PostgreSQL-backed pipeline state, explicit legacy migration, fail-closed upgrades, clearer repository previews, and parallel validation turn an upgrade into an operator-controlled change.
OpenFace v0.4.0: connect safely, operate auditably
How a stateless MCP boundary, preview-confirmed operations, package adapters, high availability, and an administrator console turn agent access into an auditable platform surface.
OpenFace v0.3.0: make every transition legible
How metric-backed discovery, immediate navigation feedback, Space readiness, readable code, and one shared identity make the hub feel faster without hiding the evidence.
OpenFace v0.2.0: from repository files to a delivery control plane
How Pages, Pipelines, protected environment settings, portable Automations, and exact-head review evidence turn repositories into an auditable delivery workflow.
OpenFace v0.1.0: from repositories to a local AI community
A guided tour of the first public release: repository-backed catalogs, Docker Spaces, GPU workers, auditable automation, and screenshot-driven quality.
Why a local AI hub?
Why the project treats Git repositories and Docker processes as the durable foundation, rather than recreating a cloud catalog in miniature.
Put another set of eyes before merge
How a coordinator, specialist accounts, SHA-bound review, and fail-closed auto-merge form one auditable maintenance conversation.
A Space is an app and a repository
Why a Dockerfile is the useful common denominator for Gradio, static sites, Next.js, Streamlit, FastAPI, and Node.js.
Prefer facts over narrative? Enter the Knowledge atlas or use local search from the navigation bar.