---
title: "2026-09-16 Factory framework interface skeleton"
description: "Added interfaces only for shared-image API and worker execution."
image: "https://docs.virdx.dev/img/virdx-social-card.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.virdx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026-09-16 Factory framework interface skeleton

## Work Done

At the user's explicit request, changed only interface skeletons in
`~/work/factory-framework`: `base.py`, new `backends.py`, `api.py`, `cli.py`,
package exports and `usage-example/main.py`. All function bodies are docstrings
plus ellipsis, including the example service. No behavior is implemented.

The proposed surface retains BaseService.check/infer and FactoryDeployment.
Deployment.infer dispatches; run_batch executes directly without submission.
InMemoryBackend and ArgoWorkflowsBackend share an execute signature. API and
worker commands load the same consumer registration from the same image.
Constructors must not connect to Argo or load models. This skeleton names Argo
Server URL/token settings; its transport is not implemented.

Validated Python 3.11 grammar, stub-only bodies, and imports through the existing
project Pixi Python. Dependencies, CLI packaging and README remain unchanged.

## Pitfalls

The user twice rejected broad architecture proposals as overengineering.
Do not treat the earlier assessment's job-management APIs, execution context,
identity machinery or staged hardening program as approved scope.
The stub methods are intentionally nonfunctional, not ready for execution.

## Improvements

Continue from the minimal agreed classes and direct wiring. Shared-image API and
worker roles need different commands, not different service implementations or
mandatory separate images. Heavy imports belong inside inference; credentials
are injected at runtime. Implement behavior only when the user requests it.

Source: https://docs.virdx.dev/knowledge/inbox/2026-09-16-infrastructure-factory-framework-interface-skeleton/index.mdx