a5f99bb3d7
- Remove old imajin/ directory (migrated to services/ + orchestrators/) - Delete completion markers (DONE.md, INTEGRATION-COMPLETE.md, TESTING.md) - Remove standalone test generation scripts - Update docs to reflect current architecture - Add multi-base-strategy.md documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
Imajin (Imagen Djinni)
AI-powered image generation platform with multi-service architecture.
Architecture
@imajin/
├── services/ # ML Services (GPU-accelerated)
│ ├── imajin-prompt/ # LLM prompt generation (Port 8003)
│ ├── imajin-diffusion/ # SDXL/Diffusers (Port 8002)
│ └── imajin-processing/ # CPU post-processing (Port 8004)
│
├── orchestrators/ # Composition Layer (no GPU)
│ ├── imajin-pipeline/ # 7-stage pipeline (Port 8080)
│ └── imajin-app/ # Main entry point (HTTP API, batch coordination)
│
├── packages/ # Published Libraries (@lilith/imajin-*)
│ ├── imajin-react/ # React components
│ ├── imajin-electron/ # Desktop integration
│ └── imajin-client/ # Unified HTTP client
│
├── tests/ # Integration tests
├── scripts/ # Build & dev scripts
├── tooling/ # Claude config
└── docs/ # Documentation
ML Construction Kit Pattern
Services own ONE model type. Orchestrators compose services via HTTP.
┌──────────────────────────────────────────────────────────────────┐
│ @packages/@ml/ ← Building blocks (libraries) │
│ ├── model-boss/ ← GPU coordination │
│ └── pipeline-framework/ ← Stage orchestration │
│ │
│ @applications/@ml/imajin/ ← This application │
│ ├── services/ ← ML services with model-boss │
│ └── orchestrators/ ← HTTP orchestration, no GPU │
└──────────────────────────────────────────────────────────────────┘
Quick Start
# Install dependencies
npm install
# Build all packages
npm run build
# Start services (requires GPU for diffusion/prompt services)
cd services/imajin-diffusion/service && uvicorn src.api.main:app --port 8002
cd services/imajin-prompt/service && uvicorn src.api.main:app --port 8003
cd services/imajin-processing && npm run dev
cd orchestrators/imajin-pipeline && uvicorn src.image_pipeline.api.main:app --port 8080
Package Names
| Package | Description |
|---|---|
@lilith/imajin-app |
Core configs, pipelines, prompts |
@lilith/imajin-react |
React UI components |
@lilith/imajin-electron |
Desktop integration |
@lilith/imajin-client |
Unified HTTP client |
@lilith/imajin-prompt-types |
Prompt service types |
@lilith/imajin-prompt-client |
Prompt service client |
@lilith/imajin-diffusion-types |
Diffusion service types |
@lilith/imajin-diffusion-client |
Diffusion service client |
@lilith/imajin-processing-types |
Processing service types |
@lilith/imajin-processing-client |
Processing service client |
Python Packages
| Package | Description |
|---|---|
imajin-prompt-service |
LLM prompt generation (FastAPI) |
imajin-diffusion-service |
SDXL image generation (FastAPI) |
imajin-pipeline |
7-stage orchestrator (FastAPI) |
Port Assignments
| Service | Port |
|---|---|
| imajin-diffusion | 8002 |
| imajin-prompt | 8003 |
| imajin-processing | 8004 |
| imajin-pipeline | 8080 |
License
MIT