FrameFamily

A modular AI ecosystem focused on frame-based image generation, training, and visualization.

Components

• Training
  FrameForge
  AI training, dataset preparation, and orchestration within the Frame ecosystem.

• Viewing
  FrameView
  Visualization, inspection, and analysis of generated frames and training results.

• Generating
  FrameCreate
  Generative image AI of the Frame ecosystem.
  Work in Progress

FrameForge

End-to-end dataset and LoRA training pipeline that turns ZIP uploads into clean, tagged image datasets with a web-first workflow. Best use in combination with Grok Imagine Image to Video.

FrameForge is designed for fictional, stylized, and synthetic content.
Use on real individuals without consent is explicitly discouraged.

Important Notice: FrameForge is currently only for PonyXL training calibrated. More will follow if demand comes.

Features

• Pipeline stages: import → select → crop → tag → train → package.
• Dataset flow: ZIP ingest → capping → selection → crop/flip → autotag → manual tag editing → finalize dataset.
• Training flow: profile-driven configs → run monitoring → LoRA packaging + sample previews.
• Orchestrated services: initiator, orchestrator, finisher, DB broker, webapp.
• Web UI for uploads, queue monitoring, manual tagging, downloads, and train profile editor.
• Queue management with reorderable queued runs.
• Preview generation and result browsing in the UI.
• AutoChar presets with online selection and filtering.
• System status view with service health and progress signals.
• Structured error logging with per-run details in the UI.
• Training integration with (Kohya_ss scripts).

Support and Questions -> Discord https://discord.gg/TB5DHMNa5J

Quick Start

./scripts/setup_all.sh

Open the Web UI at http://localhost:3005.

Prerequisites: Python 3, Node.js + npm, ffmpeg in PATH. GPU recommended for tagging; required for training.

Configuration

Variable	Default	Notes
DB_BROKER_URL	(set by systemd)	Required for webapp DB access.
PORT	3005	Web UI port.
HOST	0.0.0.0	Web UI bind address.

Usage

./.venv/bin/python workflow.py --autotag --gpu

Add --train to run LoRA training.

For UI usage and workflows, see the docs:

• insite-docs/quickstart.md
• insite-docs/ui.md
• insite-docs/workflow.md

Development

• Setup (all-in-one): ./scripts/setup_all.sh
• Services: systemd/frameforge-*.service

Security

FrameForge is intended for local use only. Do not expose it to the public internet.

License

MIT