till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-14 21:41:09 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/services/mana-image-gen
History
Till-JS f4c49fe8f2 fix(mana-notify): resolve BullMQ circular import issue 
Move queue name constants to separate file (queue-names.ts) to avoid
circular dependency between queue.module.ts and processor files.

The @Processor decorator evaluates at module load time, and importing
constants from queue.module.ts created a circular dependency that
resulted in undefined queue names.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 22:58:47 +01:00
..
app fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00
CLAUDE.md fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00
README.md fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00
requirements.txt fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00
setup.sh fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00

README.md

Mana Image Generation Service

Local AI image generation using FLUX.2 klein 4B model via flux2.c.

Features

  • Fast: Sub-second generation on Apple Silicon
  • Efficient: ~4-5 GB RAM (memory-mapped weights)
  • Open: Apache 2.0 license (commercial use)
  • Local: 100% on-device, no API keys needed

Requirements

  • macOS with Apple Silicon (M1/M2/M3/M4)
  • 16 GB RAM minimum
  • ~20 GB disk space (model + binary)
  • Python 3.11+

Quick Start

# 1. Run setup (installs flux2.c + downloads model)
./setup.sh

# 2. Start the service
source .venv/bin/activate
FLUX_BINARY=/opt/flux2/flux FLUX_MODEL_DIR=/opt/flux2/model \
  uvicorn app.main:app --host 0.0.0.0 --port 3025

# 3. Generate an image
curl -X POST http://localhost:3025/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat wearing sunglasses"}' | jq

API

Generate Image

POST /generate
Content-Type: application/json

{
  "prompt": "A beautiful mountain landscape",
  "width": 1024,
  "height": 1024,
  "steps": 4,
  "seed": -1,
  "output_format": "png"
}

Response:

{
  "success": true,
  "image_url": "/images/abc123.png",
  "prompt": "A beautiful mountain landscape",
  "width": 1024,
  "height": 1024,
  "steps": 4,
  "seed": 42,
  "generation_time": 0.85
}

Get Image

GET /images/{filename}

Health Check

GET /health

Model Info

GET /models

Environment Variables

Variable Default Description
PORT 3025 Service port
FLUX_BINARY /opt/flux2/flux flux2.c binary path
FLUX_MODEL_DIR /opt/flux2/model Model weights path
DEFAULT_STEPS 4 Sampling steps
DEFAULT_WIDTH 1024 Default width
DEFAULT_HEIGHT 1024 Default height

Model

FLUX.2 klein 4B by Black Forest Labs (January 2026)

  • 4 billion parameters
  • Apache 2.0 license
  • Optimized for 4 sampling steps
  • Sub-second inference on consumer GPUs

Credits