imajin/docs

@image Documentation

AI-powered image generation platform with diffusion models, LLM prompt engineering, and post-processing capabilities.

Architecture Overview

graph TB
    subgraph "Consumer Applications"
        DESKTOP[desktop-chat-app]
        PLATFORM[lilith-platform]
        ERRPAGES[@ui/error-pages]
        SKELETON[@ui/skeleton-anime-girls]
    end

    subgraph "@image Libraries"
        ELECTRON[electron/<br/>@lilith/imagen-electron]
        REACTLIB[react/<br/>@lilith/imagen-react]
        CORE[imagen-app/<br/>@lilith/imagen-app]
    end

    subgraph "Backend Services"
        ASSIST[imagegen-assistant :8003]
        GEN[image-generation :8002]
        PROC[image-processing :8004]
    end

    subgraph "Infrastructure"
        REDIS[(Redis/GPUBoss)]
        GPU[GPU/CUDA]
    end

    DESKTOP --> ELECTRON
    PLATFORM --> REACTLIB
    ERRPAGES & SKELETON --> CORE
    ELECTRON & REACTLIB --> CORE
    CORE --> ASSIST & GEN & PROC
    ASSIST & GEN --> REDIS --> GPU

Key consumers:

• desktop-chat-app - End-user image generation in chat conversations
• lilith-platform - Image generation features + platform-admin for orchestration oversight
• @packages/@ui - Shared UI packages (error-pages, skeleton-anime-girls)

Quick Navigation

Section	Description
Architecture	System design, service topology, data flow
Services	Individual service documentation
Development	Getting started, client libraries, testing
Operations	Configuration, GPU coordination, ports

Components at a Glance

Component	Type	Technology	Purpose
imagen-app	Library	TypeScript	Core orchestration entry point
react/	Library	React	UI components for web consumers
electron/	Library	Electron	Components for desktop consumers
imagegen-assistant	Service	Python/FastAPI	LLM prompt generation
image-generation	Service	Python/FastAPI	Diffusion model image generation
image-processing	Service	NestJS/Sharp	Image post-processing

Existing Documentation

Detailed documentation exists in each service directory:

• image-generation/README.md - Full API reference, models, layouts
• image-generation/INTEGRATION.md - Desktop/Electron integration
• imagegen-assistant/CONFIG.md - Configuration architecture
• imagen-app/services.yaml - Port definitions, environments

Repository Structure

@image/
├── imagen-app/            # Core orchestration entry point
│   └── src/               # @lilith/imagen-app (pipelines, types, clients)
├── react/                 # React components for web consumers
│   └── src/               # @lilith/imagen-react (UI components, hooks)
├── electron/              # Electron components for desktop consumers
│   └── src/               # @lilith/imagen-electron (IPC, service management)
├── image-generation/      # Diffusion model image generation service
│   ├── service/           # Python FastAPI backend
│   ├── types/             # @lilith/image-generation-types
│   └── client/            # @lilith/image-generation-client
├── image-processing/      # Image post-processing service
│   ├── service/           # NestJS backend
│   ├── types/             # @lilith/image-processing-types
│   └── client/            # @lilith/image-processing-client
├── imagegen-assistant/    # LLM prompt generation service
│   ├── service/           # Python FastAPI backend
│   ├── types/             # TypeScript types
│   └── client/            # @lilith/imagegen-assistant-client
├── utils/                 # Shared Python utilities
└── docs/                  # This documentation

Consumer Integration

imagen-app is a library, not a standalone app. Consumers:

Consumer	Uses imagen-app for
desktop-chat-app	Image generation in chat conversations
lilith-platform	Image generation features (SEO pages, content, etc.)
lilith-platform (platform-admin)	Pipeline monitoring & orchestration management
@packages/@ui/error-pages	Generated error page images
@packages/@ui/skeleton-anime-girls	Skeleton loading state images

Getting Started

1. New to the project? Start with Getting Started
2. Integrating imagen-app? See Client Libraries
3. Deploying services? Check Configuration