Instructions to use FLs-AI/FL-9B-4 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use FLs-AI/FL-9B-4 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 FLs-AI/FL-9B-4:Q4_K_M # Run inference directly in the terminal: llama cli -hf FLs-AI/FL-9B-4:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf FLs-AI/FL-9B-4:Q4_K_M # Run inference directly in the terminal: llama cli -hf FLs-AI/FL-9B-4:Q4_K_M
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 FLs-AI/FL-9B-4:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf FLs-AI/FL-9B-4:Q4_K_M
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 FLs-AI/FL-9B-4:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf FLs-AI/FL-9B-4:Q4_K_M
Use Docker
docker model run hf.co/FLs-AI/FL-9B-4:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use FLs-AI/FL-9B-4 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "FLs-AI/FL-9B-4" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "FLs-AI/FL-9B-4", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/FLs-AI/FL-9B-4:Q4_K_M
- Ollama
How to use FLs-AI/FL-9B-4 with Ollama:
ollama run hf.co/FLs-AI/FL-9B-4:Q4_K_M
- Unsloth Studio
How to use FLs-AI/FL-9B-4 with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for FLs-AI/FL-9B-4 to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for FLs-AI/FL-9B-4 to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for FLs-AI/FL-9B-4 to start chatting
- Pi
How to use FLs-AI/FL-9B-4 with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FLs-AI/FL-9B-4:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "FLs-AI/FL-9B-4:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use FLs-AI/FL-9B-4 with Docker Model Runner:
docker model run hf.co/FLs-AI/FL-9B-4:Q4_K_M
- Lemonade
How to use FLs-AI/FL-9B-4 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull FLs-AI/FL-9B-4:Q4_K_M
Run and chat with the model
lemonade run user.FL-9B-4-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use FLs-AI/FL-9B-4 with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FLs-AI/FL-9B-4:Q4_K_M
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 FLs-AI/FL-9B-4:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use FLs-AI/FL-9B-4 with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FLs-AI/FL-9B-4:Q4_K_M
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 "FLs-AI/FL-9B-4:Q4_K_M" \ --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"
| license: apache-2.0 | |
| base_model: Qwen/Qwen3.5-9B-Base | |
| tags: | |
| - cobol | |
| - mainframe | |
| - code | |
| - legacy-modernization | |
| - qwen3_5 | |
| - lora | |
| language: | |
| - en | |
| pipeline_tag: text-generation | |
| # FL-9B-4 | |
| FL-9B-4 is a COBOL / mainframe code model fine-tuned from **Qwen/Qwen3.5-9B-Base** | |
| via supervised fine-tuning (SFT) on a curated COBOL instruction dataset. It targets | |
| legacy-code understanding, COBOL generation, and COBOL-to-Java translation. | |
| - **Base model:** Qwen/Qwen3.5-9B-Base (dense 9B, hybrid linear + full attention) | |
| - **Method:** LoRA SFT (assistant-only masking), ~3 epochs, bf16 | |
| - **Domain:** COBOL, GnuCOBOL, mainframe knowledge, COBOL and Java | |
| ## Benchmark results | |
| All code benchmarks compile and execute generated programs against reference | |
| tests. Evaluated greedy (temperature 0), single sample per task, via vLLM. | |
| "Base" = Qwen/Qwen3.5-9B-Base (no fine-tuning), evaluated with the same harness | |
| and an injected ChatML template, so the delta reflects the SFT alone. | |
| | Benchmark | Metric | Base | **FL-9B-4** | | |
| |---|---|---|---| | |
| | **COBOLEval** | pass@1 | 0.68% | **36.99%** | | |
| | | compile rate | 8.65% | 82.10% | | |
| | | test pass rate | 1.46% | 52.98% | | |
| | **COBOL-JavaTrans (C2J)** | pass@1 | 42.66% | **80.42%** | | |
| | | compile success rate (CSR) | 46.85% | 96.50% | | |
| | **MainframeBench** | MCQ accuracy | 66.23% | **71.26%** | | |
| | | QA - Token F1 | 11.68% | 12.75% | | |
| | | QA - ROUGE-L | 9.33% | 10.29% | | |
| | | Summarization - Token F1 | 23.62% | 27.64% | | |
| | | Summarization - ROUGE-L | 16.38% | 20.25% | | |
| | **CobolCodeBench** | INSTRUCT compile rate | 2.17% | **47.83%** | | |
| | | COMPLETE compile rate | 0.00% | 32.61% | | |
| The fine-tuning produces very large gains on COBOL generation and understanding: | |
| COBOLEval pass@1 rises from ~1% to 37%, COBOL compile rate from 9% to 82%, and | |
| CobolCodeBench COMPLETE from 0% to 33%. COBOL-to-Java translation nearly doubles in | |
| pass@1 (from 43% to 80%). MainframeBench MCQ moves less (from 66% to 71%), since factual | |
| mainframe knowledge is largely already present in the base model. | |
| ### Notes on evaluation | |
| The MainframeBench MCQ, CobolCodeBench INSTRUCT and COMPLETE numbers were produced | |
| after fixing harness-side generation limits (the default 16-token MCQ budget and | |
| 2048-token code budget truncated answers, and single-format `cobc` invocation | |
| rejected valid programs written in a different column format). Fixed evaluation | |
| uses a larger generation budget and tries `variable`, `free` and `fixed` COBOL | |
| formats when compiling. Reported numbers reflect the model's actual capability, | |
| not the truncated defaults. | |
| The strongest results - COBOL-to-Java translation (80% pass@1) and COBOLEval | |
| (82% compile) - show the model reliably produces valid, working COBOL and | |
| translates legacy code into working Java. | |
| ## Intended use | |
| - Translating legacy COBOL programs to Java | |
| - Completing and generating GnuCOBOL programs | |
| - Answering mainframe / COBOL knowledge questions | |
| - Assisting with legacy-code modernization workflows | |
| ## Limitations | |
| - Open-ended QA and summarization scores (Token F1 / ROUGE-L) are modest; the | |
| model is stronger at code generation and translation than at free-form prose. | |
| - COBOL generation quality varies with column-format conventions; generated code | |
| may mix fixed and free formats. | |
| - Not evaluated for safety-critical or production mainframe deployment without | |
| human review. | |
| ## Training | |
| | Setting | Value | | |
| |---|---| | |
| | Base | Qwen/Qwen3.5-9B-Base | | |
| | Method | LoRA (r=32, alpha=64), assistant-only SFT | | |
| | Precision | bf16 | | |
| | Epochs | ~3 | | |
| | Sequence length | 8192 (packed) | | |
| | Hardware | 1x NVIDIA RTX PRO 6000 Blackwell (96 GB) | | |
| | Frameworks | Unsloth + Transformers | | |
| LoRA adapters were applied to attention projections, MLP projections, and the | |
| linear-attention (`in_proj_*`/`out_proj`) modules of the hybrid Qwen3.5 | |
| architecture; the vision tower, MTP head, and router/embedding/LM-head were | |
| excluded. | |
| ## How to use | |
| ```python | |
| from transformers import AutoModelForCausalLM, AutoTokenizer | |
| model_id = "FLs-AI/FL-9B-4" # adjust to your repo | |
| tok = AutoTokenizer.from_pretrained(model_id) | |
| model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype="bfloat16", device_map="auto") | |
| messages = [{"role": "user", "content": "Translate this COBOL program to Java:\n\n<COBOL here>"}] | |
| inputs = tok.apply_chat_template(messages, add_generation_prompt=True, return_tensors="pt").to(model.device) | |
| out = model.generate(inputs, max_new_tokens=2048, temperature=0.0) | |
| print(tok.decode(out[0][inputs.shape[1]:], skip_special_tokens=True)) | |
| ``` |