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 35f4bd48de fix: resolve port conflict (mana-image-gen 3025→3026) and replace APP_URLS with internal routes 
- mana-image-gen: change default port from 3025 to 3026 to avoid conflict with mana-llm
- Dashboard widgets (12): replace APP_URLS.{app}.dev/prod with internal route paths (/todo, /calendar, etc.)
  and remove target="_blank" since all apps are now internal routes in the unified app
- Home page: use goto() for internal apps, keep window.open() only for external apps (matrix, arcade)
- AppRow: remove unused APP_URLS import

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 12:56:37 +02:00
..
app fix: resolve port conflict (mana-image-gen 3025→3026) and replace APP_URLS with internal routes 2026-04-02 12:56:37 +02:00
CLAUDE.md fix: resolve port conflict (mana-image-gen 3025→3026) and replace APP_URLS with internal routes 2026-04-02 12:56:37 +02:00
README.md fix: resolve port conflict (mana-image-gen 3025→3026) and replace APP_URLS with internal routes 2026-04-02 12:56:37 +02:00
requirements.txt fix(mana-notify): resolve BullMQ circular import issue 2026-01-29 22:58:47 +01:00
setup.sh fix: resolve port conflict (mana-image-gen 3025→3026) and replace APP_URLS with internal routes 2026-04-02 12:56:37 +02: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 3026

# 3. Generate an image
curl -X POST http://localhost:3026/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 3026 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