ollamadiffuser 1.2.0__tar.gz → 1.2.1__tar.gz

{ollamadiffuser-1.2.0/ollamadiffuser.egg-info → ollamadiffuser-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ollamadiffuser
-Version: 1.2.0
+Version: 1.2.1
 Summary: 🎨 Local AI Image Generation with Ollama-style CLI for Stable Diffusion, FLUX.1, and LoRA support
 Home-page: https://github.com/ollamadiffuser/ollamadiffuser
 Author: OllamaDiffuser Team
@@ -82,6 +82,63 @@ Dynamic: requires-python
 
 ---
 
+## 🔑 Hugging Face Authentication
+
+**Do you need a Hugging Face token?** It depends on which models you want to use!
+
+### 🟢 Models that DON'T require a token:
+- **FLUX.1-schnell** - Apache 2.0 license, ready to use ✅
+- **Stable Diffusion 1.5** - Basic model, no authentication needed ✅
+- **Most ControlNet models** - Generally public access ✅
+
+### 🟡 Models that DO require a token:
+- **FLUX.1-dev** - Requires HF token and license agreement ⚠️
+- **Stable Diffusion 3.5** - Requires HF token and license agreement ⚠️
+- **Some premium LoRAs** - Gated models from Hugging Face ⚠️
+
+### 🚀 Quick Setup
+
+**For basic usage** (no token needed):
+```bash
+# These work immediately without any setup:
+ollamadiffuser pull flux.1-schnell
+ollamadiffuser pull stable-diffusion-1.5
+```
+
+**For advanced models** (token required):
+```bash
+# 1. Set your token
+export HF_TOKEN=your_token_here
+
+# 2. Now you can access gated models
+ollamadiffuser pull flux.1-dev
+ollamadiffuser pull stable-diffusion-3.5-medium
+```
+
+### 🔧 How to get a Hugging Face token:
+
+1. **Create account**: Visit [huggingface.co](https://huggingface.co) and sign up
+2. **Generate token**: Go to Settings → Access Tokens → Create new token
+3. **Accept licenses**: Visit the model pages and accept license agreements:
+   - [FLUX.1-dev](https://huggingface.co/black-forest-labs/FLUX.1-dev)
+   - [Stable Diffusion 3.5](https://huggingface.co/stabilityai/stable-diffusion-3.5-medium)
+4. **Set environment variable**:
+   ```bash
+   # Temporary (current session)
+   export HF_TOKEN=your_token_here
+   
+   # Permanent (add to ~/.bashrc or ~/.zshrc)
+   echo 'export HF_TOKEN=your_token_here' >> ~/.bashrc
+   ```
+
+### 💡 Pro Tips:
+- **Start simple**: Begin with FLUX.1-schnell (no token required, commercial use OK)
+- **Token scope**: Use "read" permissions for downloading models
+- **Privacy**: Your token stays local - never shared with OllamaDiffuser servers
+- **Troubleshooting**: If downloads fail, verify your token and model access permissions
+
+---
+
 ## ✨ Features
 
 - **🚀 Fast Startup**: Instant application launch with lazy loading architecture
@@ -423,7 +480,6 @@ with open("control.jpg", "rb") as f:
 
 - **[GGUF Models Guide](GGUF_GUIDE.md)**: Complete guide to memory-efficient GGUF models
 - **[ControlNet Guide](CONTROLNET_GUIDE.md)**: Comprehensive ControlNet usage and examples
-- **[Installation Guide](INSTALLATION_GUIDE.md)**: Detailed installation instructions
 - **[Website Documentation](https://www.ollamadiffuser.com/)**: Complete tutorials and guides
 
 ## 🚀 Performance & Hardware

{ollamadiffuser-1.2.0 → ollamadiffuser-1.2.1}/README.md

@@ -13,6 +13,63 @@
 
 ---
 
+## 🔑 Hugging Face Authentication
+
+**Do you need a Hugging Face token?** It depends on which models you want to use!
+
+### 🟢 Models that DON'T require a token:
+- **FLUX.1-schnell** - Apache 2.0 license, ready to use ✅
+- **Stable Diffusion 1.5** - Basic model, no authentication needed ✅
+- **Most ControlNet models** - Generally public access ✅
+
+### 🟡 Models that DO require a token:
+- **FLUX.1-dev** - Requires HF token and license agreement ⚠️
+- **Stable Diffusion 3.5** - Requires HF token and license agreement ⚠️
+- **Some premium LoRAs** - Gated models from Hugging Face ⚠️
+
+### 🚀 Quick Setup
+
+**For basic usage** (no token needed):
+```bash
+# These work immediately without any setup:
+ollamadiffuser pull flux.1-schnell
+ollamadiffuser pull stable-diffusion-1.5
+```
+
+**For advanced models** (token required):
+```bash
+# 1. Set your token
+export HF_TOKEN=your_token_here
+
+# 2. Now you can access gated models
+ollamadiffuser pull flux.1-dev
+ollamadiffuser pull stable-diffusion-3.5-medium
+```
+
+### 🔧 How to get a Hugging Face token:
+
+1. **Create account**: Visit [huggingface.co](https://huggingface.co) and sign up
+2. **Generate token**: Go to Settings → Access Tokens → Create new token
+3. **Accept licenses**: Visit the model pages and accept license agreements:
+   - [FLUX.1-dev](https://huggingface.co/black-forest-labs/FLUX.1-dev)
+   - [Stable Diffusion 3.5](https://huggingface.co/stabilityai/stable-diffusion-3.5-medium)
+4. **Set environment variable**:
+   ```bash
+   # Temporary (current session)
+   export HF_TOKEN=your_token_here
+   
+   # Permanent (add to ~/.bashrc or ~/.zshrc)
+   echo 'export HF_TOKEN=your_token_here' >> ~/.bashrc
+   ```
+
+### 💡 Pro Tips:
+- **Start simple**: Begin with FLUX.1-schnell (no token required, commercial use OK)
+- **Token scope**: Use "read" permissions for downloading models
+- **Privacy**: Your token stays local - never shared with OllamaDiffuser servers
+- **Troubleshooting**: If downloads fail, verify your token and model access permissions
+
+---
+
 ## ✨ Features
 
 - **🚀 Fast Startup**: Instant application launch with lazy loading architecture
@@ -354,7 +411,6 @@ with open("control.jpg", "rb") as f:
 
 - **[GGUF Models Guide](GGUF_GUIDE.md)**: Complete guide to memory-efficient GGUF models
 - **[ControlNet Guide](CONTROLNET_GUIDE.md)**: Comprehensive ControlNet usage and examples
-- **[Installation Guide](INSTALLATION_GUIDE.md)**: Detailed installation instructions
 - **[Website Documentation](https://www.ollamadiffuser.com/)**: Complete tutorials and guides
 
 ## 🚀 Performance & Hardware

{ollamadiffuser-1.2.0 → ollamadiffuser-1.2.1}/ollamadiffuser/__init__.py

@@ -4,7 +4,7 @@ OllamaDiffuser - Local AI Image Generation with Ollama-style CLI
 A tool for managing and running Stable Diffusion, FLUX.1, and other AI image generation models locally.
 """
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 __author__ = "OllamaDiffuser Team"
 __email__ = "ollamadiffuser@gmail.com"
 __description__ = "🎨 Local AI Image Generation with Ollama-style CLI for Stable Diffusion, FLUX.1, and LoRA support"

{ollamadiffuser-1.2.0 → ollamadiffuser-1.2.1}/ollamadiffuser/api/server.py

@@ -20,7 +20,9 @@ class GenerateRequest(BaseModel):
     prompt: str
     negative_prompt: str = "low quality, bad anatomy, worst quality, low resolution"
     num_inference_steps: Optional[int] = None
+    steps: Optional[int] = None  # Alias for num_inference_steps for convenience
     guidance_scale: Optional[float] = None
+    cfg_scale: Optional[float] = None  # Alias for guidance_scale for convenience
     width: int = 1024
     height: int = 1024
     control_image_path: Optional[str] = None  # Path to control image file
@@ -232,12 +234,18 @@ def create_app() -> FastAPI:
             # Get current loaded inference engine
             engine = model_manager.loaded_model
             
+            # Handle parameter aliasing - prioritize shorter names for convenience
+            steps = request.steps if request.steps is not None else request.num_inference_steps
+            guidance = request.cfg_scale if request.cfg_scale is not None else request.guidance_scale
+            
             # Generate image
             image = engine.generate_image(
                 prompt=request.prompt,
                 negative_prompt=request.negative_prompt,
-                num_inference_steps=request.num_inference_steps,
-                guidance_scale=request.guidance_scale,
+                num_inference_steps=steps,
+                steps=steps,  # Pass both for GGUF compatibility
+                guidance_scale=guidance,
+                cfg_scale=guidance,  # Pass both for GGUF compatibility
                 width=request.width,
                 height=request.height,
                 control_image=request.control_image_path,