Nodes/BigPlayer Prompting/BigPlayer KSampler Config
ComfyUI Node

BigPlayer KSampler Config

Let the LLM pick your sampler — from the list that's actually installed

By josh-ent·Created 6 months ago·Updated 6 months ago· 0
BigPlayer KSampler Config
  • session
  • steps
  • cfg
  • sampler_name
  • scheduler
  • denoise
  • comments

BigPlayer KSampler Config folds the fiddliest part of a workflow - picking steps, CFG, sampler, scheduler, denoise - into the same LLM call that writes your prompt. It reads the shared session from BigPlayer Natural Language Root and outputs steps (INT), cfg (FLOAT), sampler_name, scheduler, denoise (FLOAT), and comments. Wire them straight into a KSampler and the whole sampling config is prose-driven.

The mechanism is where this node earns its keep. When the root builds the request, this module resolves the live sampler and scheduler lists from your actual ComfyUI install (comfy.samplers.KSampler.SAMPLERS / SCHEDULERS) and bakes them into the JSON schema as enums. The LLM can only choose a sampler you could genuinely pick in the dropdown - then local validation checks it again. It literally cannot hallucinate res_2m or a sampler you don't have installed. That's also why the list shows the newer *_cfg_pp and seeds_* variants: recent ComfyUI ships them, and this node just passes your environment through.

The settings context

The LLM is told to "choose practical settings that match the user's request, and the chosen model and LoRA preferences where known" and that it "may need to do research" - which, with Grok, means it can actually look things up. The broader knowledge here: sampler/scheduler pairs are architecture-specific. On SDXL-lineage models, DPM++ 2M Karras remains the comfortable default. On flow-matching models, aggressive schedules like Karras and exponential can distort rather than correct, and guidance-distilled models want CFG 1 by default, not 5–7. A good LLM knows the model family and picks accordingly. You still get a veto: don't wire its outputs if you disagree, or edit the prose to say "SDXL, quality-focused, 30 steps."

Troubleshooting

  • "Unsupported sampler" validation error - the provider returned a sampler that isn't in your list. Usually means your ComfyUI changed between the cached response and now. Flip assume_determinism off on the provider node to force a fresh call, and update ComfyUI.
  • Denoise out of range - the schema constrains denoise to 0.0–1.0, steps to 1–10000, and CFG to 0–100, and rejects anything outside. If you see a range error from this node, the provider broke the contract.

Install is the pack install: ComfyUI Manager, search "BigPlayer Prompting", or git clone https://github.com/josh-ent/comfyui-bigplayer-llm-nodes into ComfyUI/custom_nodes, then restart. Deps are httpx and pydantic; no model downloads, but the root needs a working Grok key.

CategoryBigPlayer/Prompting/Capabilities

Inputs (1)

NameTypeDefaultDescription
sessionBIGPLAYER_LLM_SESSIONShared session emitted by a BigPlayer Natural Language Root.

Outputs (6)

NameTypeDescription
stepsINT
cfgFLOAT
sampler_nameeuler,euler_cfg_pp,euler_ancestral,euler_ancestral_cfg_pp,heun,heunpp2,exp_heun_2_x0,exp_heun_2_x0_sde,dpm_2,dpm_2_ancestral,lms,dpm_fast,dpm_adaptive,dpmpp_2s_ancestral,dpmpp_2s_ancestral_cfg_pp,dpmpp_sde,dpmpp_sde_gpu,dpmpp_2m,dpmpp_2m_cfg_pp,dpmpp_2m_sde,dpmpp_2m_sde_gpu,dpmpp_2m_sde_heun,dpmpp_2m_sde_heun_gpu,dpmpp_3m_sde,dpmpp_3m_sde_gpu,ddpm,lcm,ipndm,ipndm_v,deis,res_multistep,res_multistep_cfg_pp,res_multistep_ancestral,res_multistep_ancestral_cfg_pp,gradient_estimation,gradient_estimation_cfg_pp,er_sde,seeds_2,seeds_3,sa_solver,sa_solver_pece,ddim,uni_pc,uni_pc_bh2
schedulersimple,sgm_uniform,karras,exponential,ddim_uniform,beta,normal,linear_quadratic,kl_optimal
denoiseFLOAT
commentsSTRING