Metadata-Version: 2.4
Name: NectarGraphix
Version: 0.1.0
Summary: Image generation studio
Author-email: Headlessripper <zashiron.inc@gmail.com>
License: Nectar-X-Studio Proprietary License (Zashiron License v1.2)
        Copyright © 2025 Zashiron. All rights reserved.
        
        1. Definitions
        “Software” means the computer program known as Nectar-X-Studio (AI Studio),
        including all executable code, source code, scripts, assets, documentation,
        updates, and related materials provided by Zashiron.
        
        “Licensee” (or “You”) means any person or legal entity authorized by Zashiron
        to use the Software under this License.
        
        “Use” means to install, execute, access, or otherwise interact with the Software.
        
        2. Grant of License
        Subject to the terms of this License, Zashiron grants You a non-exclusive,
        non-transferable, revocable license to install and use one copy of the Software
        for personal, educational, or approved commercial purposes.
        All other rights are reserved by Zashiron.
        
        3. Commercial Use
        You may use the Software for commercial purposes only if you have obtained an
        official commercial license or written authorization from Zashiron, and comply
        with all fees and conditions. Unauthorized commercial use is strictly prohibited.
        
        4. Restrictions
        You may not:
        - Copy, modify, or create derivative works of the Software.
        - Distribute, sublicense, rent, lease, lend, or resell the Software.
        - Circumvent or bypass licensing or activation mechanisms.
        - Remove or alter any copyright or proprietary notices.
        - Use the Software for illegal, unethical, or competing purposes.
        
        5. Ownership
        All rights, title, and interest in the Software remain the exclusive property of Zashiron.
        
        6. Updates and Support
        Zashiron may, at its discretion, provide updates, patches, or enhancements.
        Such updates remain governed by this License.
        
        7. Termination
        This License is effective until terminated. Upon termination, You must cease use
        and destroy all copies of the Software.
        
        8. Disclaimer of Warranties
        The Software is provided “AS IS”, without warranties of any kind, express or implied.
        
        9. Limitation of Liability
        In no event shall Zashiron be liable for any direct, indirect, incidental, or
        consequential damages arising from use or inability to use the Software.
        
        10. Governing Law
        This License is governed by the laws of the Republic of South Africa.
        
        11. Commercial Licensing Inquiries
        For enterprise or commercial licensing:
        Zashiron Licensing Department
        Email: Zashiron.inc@gmail.com
        Website: https://github.com/Zashiron
        
        12. Acknowledgment
        By installing or using the Software, You agree to be bound by this License.
        
        13. Anti-Decompilation Clause
        You expressly agree not to reverse engineer, decompile, disassemble, decrypt,
        modify, or otherwise attempt to derive the source code or algorithms of the Software,
        except where such activity is expressly permitted by law. Any unauthorized attempt
        constitutes a material breach and may result in termination and legal action.
        
        14. Data Privacy
        Zashiron is committed to protecting your privacy. We do not collect or store any personal data without your consent. Any data collected during the use of the Software is used solely for the purpose of providing and improving the Software.
        By using the Software, You acknowledge that You have read, understood, and agree to be bound by the terms of this License.
Project-URL: Homepage, https://github.com/headlessripper/Nectar-X-Studio
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6
Requires-Dist: requests
Requires-Dist: huggingface_hub
Requires-Dist: numpy
Requires-Dist: torch
Requires-Dist: tensorboard
Requires-Dist: transformers
Requires-Dist: diffusers
Requires-Dist: Pillow
Requires-Dist: PyQt6-WebEngine
Dynamic: license-file

# NectarGraphix

**NectarGraphix** is a powerful, local image generation studio powered by Stable Diffusion. Run cutting-edge AI models directly on your hardware—no cloud dependency, no usage limits. Generate stunning visuals from text prompts with full control over models, settings, and outputs.

![NectarGraphix Demo](https://via.placeholder.com/800x400/FFD700/000000?text=NectarGraphix+Demo) <!-- Replace with your actual screenshot -->

## ✨ Features

- **Local Stable Diffusion**: Run models like SDXL, SD 1.5, or custom fine-tunes offline.
- **Intuitive UI**: Drag-and-drop interface for prompts, images, and settings.
- **Model Management**: Download, switch, and organize models seamlessly.
- **Advanced Controls**: Negative prompts, samplers, CFG scale, steps, and resolution tweaking.
- **Batch Generation**: Create multiple images at once.
- **Hardware Optimization**: GPU/CPU detection with automatic optimizations (CUDA, ROCm, DirectML).
- **Extensions Support**: Compatible with popular LoRAs, ControlNet, and embeddings.

## 💻 Requirements

- **OS**: Windows 10+, macOS 10.15+, Linux (Ubuntu 20.04+ recommended)
- **Python**: 3.10 or 3.11
- **GPU** (recommended):
  - NVIDIA: 4GB+ VRAM (GTX 1060 or newer)
  - AMD: ROCm-compatible (RX 5000+)
  - Apple Silicon: M1/M2/M3/M4
- **RAM**: 8GB+ (16GB recommended for larger models)
- **Disk**: 10GB+ free space for models and outputs

## 🚀 Quick Start

### 1. Clone & Install
git clone https://github.com/yourusername/NectarGraphix.git
cd NectarGraphix
pip install -r requirements.txt


### 2. Download Models
Launch once to auto-download a starter model (SD 1.5), or place models in `models/Stable-diffusion/`:

models/
├── Stable-diffusion/
│ └── v1-5-pruned-emaonly.safetensors
├── Lora/
└── VAE/


Popular sources: [Civitai](https://civitai.com), [Hugging Face](https://huggingface.co)

### 3. Run the App

python app.py

Or use the one-click launcher: `launch.bat` (Windows) / `launch.sh` (Linux/macOS).

The UI opens at `http://127.0.0.1:7860`.

## ⚙️ Configuration

Edit `config.yaml` for custom defaults:

webui:
port: 7860
share: false # Enable public URL (ngrok)
models:
default: "v1-5-pruned-emaonly.safetensors"
hardware:
gpu: auto # cuda, rocm, directml, cpu


## 📸 Example Usage

1. Enter prompt: `A cyberpunk cityscape at sunset, neon lights, highly detailed, 8k`
2. Negative prompt: `blurry, lowres, text, watermark`
3. Set: Steps=30, CFG=7, Sampler=Euler a, Size=512x512
4. Hit **Generate** → Save or upscale results.

## 🛠️ Troubleshooting

| Issue | Solution |
|-------|----------|
| Out of VRAM | Reduce resolution or use `--medvram` flag |
| No GPU detected | Install CUDA 12.1+ or check `python detect_hardware.py` |
| Slow generation | Enable xformers: `pip install xformers` |
| Model not loading | Verify .safetensors checksum on Civitai |

**Logs**: Check `logs/app.log` for errors.

## 🤝 Contributing

1. Fork the repo
2. Create feature branch: `git checkout -b feature/amazing-ui`
3. Commit changes: `git commit -m 'Add dark mode toggle'`
4. Push: `git push origin feature/amazing-ui`
5. Open a Pull Request

See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## 📄 License

MIT License. See [LICENSE](LICENSE) for details.

## 🙌 Support the Project

- ⭐ Star on GitHub
- Share your generations on socials with #NectarGraphix
- Buy me a coffee: [ko-fi.com/yourusername](https://ko-fi.com/yourusername)

---

**Built with ❤️ for local AI creators**
