Skip to main content

Web UI for FluxFlow text-to-image generation

Project description

FluxFlow UI

Web interface for FluxFlow text-to-image generation and training.

🚧 Model Availability Notice

Training In Progress: FluxFlow models are currently being trained. The UI is fully functional, but trained model checkpoints are not yet available for download.

When Available: Trained checkpoints will be published to MODEL_ZOO.md upon completion of the TRAINING_VALIDATION_PLAN.md.

Current Capabilities: You can use this UI to:

  • Configure and launch training runs with your own datasets
  • Monitor training progress in real-time
  • Test the architecture with your own trained checkpoints

Installation

Production Install

pip install fluxflow-ui

What gets installed:

  • fluxflow-ui - Web interface for training and generation
  • fluxflow-training - Training capabilities (automatically installed as dependency)
  • fluxflow core package (transitively installed)
  • CLI command: fluxflow-ui

Package available on PyPI: fluxflow-ui v0.1.1

Development Install

git clone https://github.com/danny-mio/fluxflow-ui.git
cd fluxflow-ui
pip install -e ".[dev]"

⚠️ Security Warning

FluxFlow UI is designed for local development use only.

  • No authentication or authorization
  • File browser can access entire filesystem
  • Not hardened for production deployment

See SECURITY.md for details on security measures, limitations, and production deployment warnings.

Do not expose this application to the internet without additional security hardening.


Features

  • Training Interface: Configure and monitor training runs
  • Generation Interface: Generate images with various parameters
  • Real-time Progress: Monitor training progress with live updates
  • Model Management: Load and manage checkpoints
  • Interactive Controls: Adjust generation parameters in real-time

Quick Start

Launch the Web UI

FluxFlow UI supports two interfaces:

Flask (Primary - Recommended):

fluxflow-ui

Gradio (Alternative):

python -m fluxflow_ui.app

Then open your browser to http://localhost:7860

Note: Flask is the primary interface with full features. Gradio is provided as an alternative but may have limited functionality.

Features

Training Tab

  • Configure training parameters
  • Start/stop training runs
  • Monitor loss curves and metrics
  • View sample generations during training

Generation Tab

  • Load trained models
  • Generate images from text prompts
  • Adjust sampling parameters
  • Batch generation support

Package Contents

  • fluxflow_ui.tabs - UI tab implementations
  • fluxflow_ui.utils - Config management and training runners
  • fluxflow_ui.templates - HTML templates
  • fluxflow_ui.static - CSS and JavaScript assets

Configuration

The UI runs on http://0.0.0.0:7860 by default. To customize the host and port, modify the main() function in app_flask.py.

Development

Install with development dependencies:

pip install -e ".[dev]"

Links

License

MIT License - see LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fluxflow_ui-0.1.1.tar.gz (41.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fluxflow_ui-0.1.1-py3-none-any.whl (35.6 kB view details)

Uploaded Python 3

File details

Details for the file fluxflow_ui-0.1.1.tar.gz.

File metadata

  • Download URL: fluxflow_ui-0.1.1.tar.gz
  • Upload date:
  • Size: 41.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fluxflow_ui-0.1.1.tar.gz
Algorithm Hash digest
SHA256 555a66543dc1d0ce2a8799317d4f2136671718283c63fe95f77eaeec77ca96a9
MD5 fbcdd07ba77245d4541dac7e185a00bb
BLAKE2b-256 59c53aa91b5a88d3dc8abb5d69a62624d41c2393f799b5da5c09fe5a009d88ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for fluxflow_ui-0.1.1.tar.gz:

Publisher: ci.yml on danny-mio/fluxflow-ui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fluxflow_ui-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: fluxflow_ui-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 35.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fluxflow_ui-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2c4d5850bd16c9dc05fcff848bf726f0904c6f4ad084fda7b02fe68c8227a0d4
MD5 834784b641b8c66c7c5536e7a48c7e58
BLAKE2b-256 9e408558bef041f3bab5dfa5df96e33c66bb79d47b5b34dd00f2421cd914026f

See more details on using hashes here.

Provenance

The following attestation bundles were made for fluxflow_ui-0.1.1-py3-none-any.whl:

Publisher: ci.yml on danny-mio/fluxflow-ui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page