papacr0w's picture
Ship user-facing docs: model card, benchmarks with evidence, spec sheet, portable usage and safety pages
a0101b6 verified
|
Raw
History Blame Contribute Delete
2.19 kB

Usage Guide

Everything below assumes you downloaded this repo folder, so the GGUF and the Modelfile sit together in your working directory.

Verify your download (optional, 10 seconds)

sha256sum telos-coder-14b-cpt2020-q4_k_m.gguf

Compare against checksums.sha256. A match means you hold the exact bytes the provenance chain describes.

Ollama

ollama create flywheel-local-coder-14b -f Modelfile
ollama run flywheel-local-coder-14b

That gives you interactive chat. Ollama also exposes an OpenAI-compatible API the moment the model is created, so any tool that speaks the OpenAI chat format can use the model locally:

curl http://127.0.0.1:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"flywheel-local-coder-14b","messages":[{"role":"user","content":"Write a Python function that merges overlapping intervals."}]}'

Point your editor plugin, agent framework, or script at http://127.0.0.1:11434/v1 with model name flywheel-local-coder-14b and you have a private, zero-cost coding endpoint.

llama.cpp

Interactive chat, one command:

llama-cli -m telos-coder-14b-cpt2020-q4_k_m.gguf -cnv

Deterministic completion (the exact configuration our receipts use):

llama-completion -m telos-coder-14b-cpt2020-q4_k_m.gguf --temp 0 --seed 7 -n 256 -p "your prompt"

At temperature 0 with a fixed seed, reruns are byte-identical. That is not a nicety: it is what lets a benchmark number on the benchmarks page be re-checked by someone who is not us.

Tool calling

The model supports tool/function calling through Ollama's OpenAI-compatible endpoint: pass a tools array in the request as you would with any OpenAI-style API.

Tips

  • Give it the full contract. The model was benchmarked on prompts that state every rule (exact exception messages, edge cases, output format). It rewards precise asks.
  • Pair it with your tests. Its natural habitat is a propose-then-verify loop: let it write, run your tests, keep what passes.
  • 32,768-token context: enough for a large file plus conversation, not an entire repository. Feed it the relevant slice.