Instructions to use SulphurAI/Sulphur-2-base with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use SulphurAI/Sulphur-2-base with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("SulphurAI/Sulphur-2-base", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use SulphurAI/Sulphur-2-base with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf SulphurAI/Sulphur-2-base:BF16 # Run inference directly in the terminal: llama cli -hf SulphurAI/Sulphur-2-base:BF16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf SulphurAI/Sulphur-2-base:BF16 # Run inference directly in the terminal: llama cli -hf SulphurAI/Sulphur-2-base:BF16
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf SulphurAI/Sulphur-2-base:BF16 # Run inference directly in the terminal: ./llama-cli -hf SulphurAI/Sulphur-2-base:BF16
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf SulphurAI/Sulphur-2-base:BF16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf SulphurAI/Sulphur-2-base:BF16
Use Docker
docker model run hf.co/SulphurAI/Sulphur-2-base:BF16
- LM Studio
- Jan
- Ollama
How to use SulphurAI/Sulphur-2-base with Ollama:
ollama run hf.co/SulphurAI/Sulphur-2-base:BF16
- Unsloth Desktop
- Pi
How to use SulphurAI/Sulphur-2-base with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf SulphurAI/Sulphur-2-base:BF16
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "SulphurAI/Sulphur-2-base:BF16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use SulphurAI/Sulphur-2-base with Docker Model Runner:
docker model run hf.co/SulphurAI/Sulphur-2-base:BF16
- Lemonade
How to use SulphurAI/Sulphur-2-base with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull SulphurAI/Sulphur-2-base:BF16
Run and chat with the model
lemonade run user.Sulphur-2-base-BF16
List all available models
lemonade list
- Hermes Agent
How to use SulphurAI/Sulphur-2-base with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf SulphurAI/Sulphur-2-base:BF16
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default SulphurAI/Sulphur-2-base:BF16
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use SulphurAI/Sulphur-2-base with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf SulphurAI/Sulphur-2-base:BF16
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "SulphurAI/Sulphur-2-base:BF16" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
File size: 2,391 Bytes
00058da 078abc7 00058da a3206fc 00058da 65587bb 48ed82a 7f0f97c 3b0b7cf 7b88955 875e886 00058da bde9be6 01bd07a 49effc6 fe3c49b bde9be6 77e7fe6 bde9be6 7f67e70 00058da a55b51b 595997d e353304 b4f451a 00058da | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 | ---
base_model:
- Lightricks/LTX-2.3
library_name: diffusers
pipeline_tag: text-to-video
---
**Sulphur 2**
An uncensored video generation model based on LTX 2.3 supporting both t2v and i2v natively, as well as all of the other ltx 2.3 formats.
Follow us on **[X](https://x.com/FusionCow11)**
Join our **[Discord](https://discord.gg/C3d56f39Ah)**
Support the next version of the project, even just a few dollars would go a long way: **[Kofi](https://ko-fi.com/fusioncow)**
As a note, official inference for the model is coming soon.
---
**Get Started:**
To get started with the model, I recommend downloading either of the dev versions, (fp8mixed or bf16) and downloading the distill lora provided. By the way, I'm aware the workflows contain sulphur_final right now, just use the lora or use the full models, don't use both at the same time.
This model contains a **prompt enhancer**. The easiest way to get started with the prompt enhancer is by using it on lmstudio. The way to accomplish this is by going to your model folder inside lmstudio, then opening it up in your file explorer. Create a folder named "Sulphur", then a folder inside that called "promptenhancer". Inside that folder, place the gguf file and the mmproj file. Once you've done that, you should be able to load the prompt enhancer in lmstudio. There is no system prompt for it, just send the text (and an image) you'd like to be enhanced.
*As a note, this readme will contain better setup instructions and how to train on top of the model soon.
---
**Links**
- **([CivitAI Base Model](https://civitai.red/models/2594061/sulphur-2-base))** -
- **([CivitAI Quant Model](https://civitai.red/models/2630742))** -
**Credits**
- **([TenStrip](https://huggingface.co/TenStrip))** — Testing & model merging ([His i2v merge of sulphur 2, highly recommend for i2v](https://huggingface.co/TenStrip/LTX2.3-10Eros))
- **@s1lv3rc01n** — Testing & model merging/quantizing ([silveroxides](https://huggingface.co/silveroxides))
- **@mov7162** — Musubi Tuner guidance
- And many others, if you'd like to be on the credits and I didn't place you here, message me I likely assumed you didn't want to be here.
**Funders**
- Anonymous funder #1 — Supported the original Sulphur
- Anonymous funder #2 — Made Sulphur 2 possible; this model wouldn't exist without them
---
Thank you to everyone who contributed. |