Name	Name	Last commit message	Last commit date
parent directory ..
bootstrap	bootstrap
core	core
engine	engine
feedback	feedback
frontend	frontend
samplers	samplers
storage	storage
updaters	updaters
README.md	README.md
__init__.py	__init__.py
frontend_trace.py	frontend_trace.py
main.py	main.py

Name

Last commit message

Last commit date

App Folder

This folder contains the running StableSteering application.

Structure

main.py FastAPI entry point. Builds app state, exposes HTML pages and JSON APIs, accepts frontend trace events, serves runtime diagnostics, and renders saved session trace reports.
frontend_trace.py Shared schema for browser-submitted trace events.
bootstrap/ Startup and model-preparation helpers.
core/ Shared configuration, schemas, logging, and tracing utilities.
engine/ The orchestration and image-generation layer.
feedback/ Feedback normalization logic.
frontend/ HTML templates and static browser assets.
samplers/ Candidate proposal strategies.
storage/ Local SQLite persistence plus artifact/trace directories.
updaters/ Steering-state update strategies.

main.py creates the FastAPI app and runtime services.
frontend/ renders the prompt-first setup page, including the editable per-session YAML block.
engine/orchestrator.py coordinates experiment, session, round, baseline or incumbent carry-forward, and feedback lifecycle.
engine/generation.py resolves the active generation backend and applies the per-session generation settings.
storage/repository.py persists experiments, sessions, rounds, artifacts, and trace data references.
frontend/ submits async jobs, shows progress, and posts browser events back to the backend.