# Tiny Army — BLS Mini-Code 1.0 ZeroGPU coding sidecar. # # Exposes the SAME Gradio contract as the Mellum2 / Tiny Aya sidecars so the main app's # gradio_client can talk to it unchanged (see app.py:_space_text_stream / _space_text_generate): # /generate_stream(system, user, max_tokens:int, temperature:float) -> str # CUMULATIVE text, streamed # /generate(system, user, max_tokens:int, temperature:float) -> str # final text, one shot # # Model: CohereLabs/BLS-Mini-Code-1.0 — 30B MoE (cohere2_moe), BF16 only upstream (no FP8 # weight published as of 2026-06), so we quantize AT LOAD via bitsandbytes to fit the ZeroGPU # H200 slice. TINY_BLS_QUANT selects 4bit (default, ~18GB) / 8bit (~32GB) / bf16 (~60GB, tight). # # REASONING: BLS-Mini-Code is a Cohere reasoning model. Its chat template, with # add_generation_prompt=True, force-opens <|START_RESPONSE|> (non-reasoning mode) — which makes # the model dump its reasoning as prose into the answer. Instead we open a <|START_THINKING|> # block so it reasons in a dedicated section we DISCARD, and we stream only the clean code from # <|START_RESPONSE|>…<|END_RESPONSE|>. TINY_BLS_THINK_BUDGET extra tokens are reserved for the # (discarded) thinking so the requested max_tokens still applies to the visible code. import os import threading import gradio as gr import spaces import torch from transformers import AutoModelForCausalLM, AutoTokenizer, TextIteratorStreamer MODEL_ID = os.environ.get("TINY_BLS_MODEL", "CohereLabs/BLS-Mini-Code-1.0") QUANT = os.environ.get("TINY_BLS_QUANT", "4bit").strip().lower() GPU_DURATION = int(os.environ.get("TINY_BLS_GPU_DURATION", "120")) THINK_BUDGET = int(os.environ.get("TINY_BLS_THINK_BUDGET", "1024")) START_THINK, END_THINK = "<|START_THINKING|>", "<|END_THINKING|>" START_RESP, END_RESP = "<|START_RESPONSE|>", "<|END_RESPONSE|>" _STRIP = (START_THINK, END_THINK, START_RESP, END_RESP, "<|START_TEXT|>", "<|END_TEXT|>", "<|END_OF_TURN_TOKEN|>") print(f"[bls-code] loading {MODEL_ID} quant={QUANT}", flush=True) _tok = AutoTokenizer.from_pretrained(MODEL_ID) def _load_kwargs(): kw = {"torch_dtype": torch.bfloat16, "device_map": "cuda"} if QUANT == "bf16": return kw from transformers import BitsAndBytesConfig if QUANT == "8bit": kw["quantization_config"] = BitsAndBytesConfig(load_in_8bit=True) else: # 4bit (default) kw["quantization_config"] = BitsAndBytesConfig( load_in_4bit=True, bnb_4bit_quant_type="nf4", bnb_4bit_compute_dtype=torch.bfloat16, bnb_4bit_use_double_quant=True, ) return kw _model = AutoModelForCausalLM.from_pretrained(MODEL_ID, **_load_kwargs()) _model.eval() print("[bls-code] model ready", flush=True) def _build_inputs(system, user): messages = [] if system and system.strip(): messages.append({"role": "system", "content": system.strip()}) messages.append({"role": "user", "content": (user or "").strip()}) text = _tok.apply_chat_template(messages, add_generation_prompt=True, tokenize=False) # The template force-opens <|START_RESPONSE|> (non-reasoning). Swap it for a thinking block # so the model reasons where we can discard it, leaving clean code in the response section. t = text.rstrip() if t.endswith(START_RESP): text = t[: -len(START_RESP)] + START_THINK enc = _tok(text, return_tensors="pt", add_special_tokens=False) return {k: v.to(_model.device) for k, v in enc.items()} def _clean(s): for mark in _STRIP: s = s.replace(mark, "") return s def _split(raw): """Split a (possibly partial) raw decode into (thinking, response, response_started): everything before <|START_RESPONSE|> (or <|END_THINKING|>) is reasoning; the rest, up to <|END_RESPONSE|>, is the answer.""" resp_i = raw.find(START_RESP) if resp_i != -1: think_part, resp, started = raw[:resp_i], raw[resp_i + len(START_RESP):], True else: end_t = raw.find(END_THINK) if end_t != -1: think_part, resp, started = raw[:end_t], raw[end_t + len(END_THINK):], True else: think_part, resp, started = raw, "", False k = resp.find(END_RESP) if k != -1: resp = resp[:k] return _clean(think_part).strip(), _clean(resp).strip(), started def _render(raw, think): """Cumulative output string. think=False → clean answer only (reasoning discarded). think=True → reasoning wrapped in ahead of the answer; the main app strips it for the clean view but shows it in a debug panel (same convention the persona models use), so the user can watch the model reason.""" thinking, resp, started = _split(raw) if not think: return resp if started: return f"\n{thinking}\n\n{resp}".strip() return f"\n{thinking}".strip() def _gen_kwargs(inputs, max_tokens, temperature): temp = float(temperature if temperature is not None else 0.6) kw = dict( **inputs, # Reserve THINK_BUDGET on top so the discarded reasoning doesn't eat the code budget. max_new_tokens=int(max_tokens or 512) + THINK_BUDGET, do_sample=temp > 0, pad_token_id=_tok.pad_token_id or _tok.eos_token_id, ) if temp > 0: kw.update(temperature=temp, top_p=0.95) return kw @spaces.GPU(duration=GPU_DURATION) def generate_stream(system, user, max_tokens, temperature, think=False): """Stream CUMULATIVE output. think=False suppresses reasoning (clean code only); think=True streams the reasoning live wrapped in . The main app diffs successive yields into deltas. On failure, yield the traceback so it isn't a silent empty stream.""" try: inputs = _build_inputs(system, user) # skip_special_tokens=False so we can SEE the thinking/response markers and split on them. streamer = TextIteratorStreamer(_tok, skip_prompt=True, skip_special_tokens=False) kw = _gen_kwargs(inputs, max_tokens, temperature) kw["streamer"] = streamer err = {} def _run(): try: _model.generate(**kw) except Exception: # noqa: BLE001 import traceback err["tb"] = traceback.format_exc() streamer.end() thread = threading.Thread(target=_run) thread.start() acc, emitted = "", False for piece in streamer: acc += piece # When hiding thinking, emit nothing until the response block opens. if not think and not _split(acc)[2]: continue emitted = True yield _render(acc, think) thread.join() if err: yield (_render(acc, think) + "\n[GENERATE ERROR]\n" + err["tb"]) elif not emitted: yield _render(acc, think) or "[EMPTY OUTPUT — no response block produced]" except Exception: # noqa: BLE001 import traceback yield "[SETUP ERROR]\n" + traceback.format_exc() @spaces.GPU(duration=GPU_DURATION) def generate(system, user, max_tokens, temperature, think=False): try: inputs = _build_inputs(system, user) out = _model.generate(**_gen_kwargs(inputs, max_tokens, temperature)) raw = _tok.decode(out[0][inputs["input_ids"].shape[-1]:], skip_special_tokens=False) return _render(raw, think) or "[EMPTY OUTPUT]" except Exception: # noqa: BLE001 import traceback return "[ERROR]\n" + traceback.format_exc() # Minimal UI; the named API endpoints are what the main app consumes. with gr.Blocks(title="BLS Mini-Code 1.0 — Tiny Army sidecar") as demo: gr.Markdown("## BLS Mini-Code 1.0 — ZeroGPU coding sidecar") sys_in = gr.Textbox(label="system", lines=2) usr_in = gr.Textbox(label="user", lines=6) mt_in = gr.Slider(16, 2048, value=512, step=16, label="max_tokens") temp_in = gr.Slider(0.0, 1.5, value=0.6, step=0.05, label="temperature") # 5th input — defaults False so existing 4-arg API callers keep getting clean code. think_in = gr.Checkbox(value=False, label="show thinking (wrap reasoning in )") out = gr.Textbox(label="output", lines=12) with gr.Row(): stream_btn = gr.Button("Stream", variant="primary") once_btn = gr.Button("Generate") stream_btn.click( generate_stream, [sys_in, usr_in, mt_in, temp_in, think_in], out, api_name="generate_stream" ) once_btn.click(generate, [sys_in, usr_in, mt_in, temp_in, think_in], out, api_name="generate") if __name__ == "__main__": demo.queue().launch()