Text Generation
Transformers
Safetensors
GGUF
llama-cpp-python
MLX
Korean
English
qwen2
finance
korean
stock-analysis
reasoning
dpo
llama-cpp
apple-silicon
4bit
quantized
vllm
ollama
conversational
text-generation-inference
Instructions to use intrect/VELA with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use intrect/VELA with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="intrect/VELA") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("intrect/VELA") model = AutoModelForCausalLM.from_pretrained("intrect/VELA", device_map="auto") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=256) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - llama-cpp-python
How to use intrect/VELA with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="intrect/VELA", filename="vela-dpo-v6-q4_k_m.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - MLX
How to use intrect/VELA with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("intrect/VELA") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use intrect/VELA 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 intrect/VELA:Q4_K_M # Run inference directly in the terminal: llama cli -hf intrect/VELA:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf intrect/VELA:Q4_K_M # Run inference directly in the terminal: llama cli -hf intrect/VELA:Q4_K_M
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf intrect/VELA:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf intrect/VELA:Q4_K_M
Use Docker
docker model run hf.co/intrect/VELA:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use intrect/VELA with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "intrect/VELA" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "intrect/VELA", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/intrect/VELA:Q4_K_M
- SGLang
How to use intrect/VELA with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "intrect/VELA" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "intrect/VELA", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "intrect/VELA" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "intrect/VELA", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use intrect/VELA with Ollama:
ollama run hf.co/intrect/VELA:Q4_K_M
- Unsloth Desktop
- Pi
How to use intrect/VELA with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "intrect/VELA"
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "intrect/VELA" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use intrect/VELA with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "intrect/VELA"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "intrect/VELA" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "intrect/VELA", "messages": [ {"role": "user", "content": "Hello"} ] }' - Docker Model Runner
How to use intrect/VELA with Docker Model Runner:
docker model run hf.co/intrect/VELA:Q4_K_M
- Lemonade
How to use intrect/VELA with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull intrect/VELA:Q4_K_M
Run and chat with the model
lemonade run user.VELA-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use intrect/VELA with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "intrect/VELA"
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 intrect/VELA
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use intrect/VELA with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "intrect/VELA"
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 "intrect/VELA" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Commit History
-
docs: 벤치마크 섹션 한국어로 변환
Verified signature1bc7a0f -
data: add raw benchmark results JSON (KMMLU + HAE-RAE, 3-model comparison)
Verified signaturede3e104 -
docs: add Korean LLM benchmark results (KMMLU + HAE-RAE, 3-model comparison)
Verified signature4043357
-
fix: replace Qwen default system prompt with VELA identity in chat templates
Verified signature8fa0fb0 -
docs: add llama-cpp-python, vllm, ollama tags for library discovery
Verified signature6eb484c -
docs: add MLX 4-bit format, update quant links in model card
Verified signature8bdb2c7 -
feat: add MLX 4-bit quantized model (Apple Silicon optimized)
Verified signatured7f1985 -
docs: update README to v1.3 (DPO v6)
Verified signaturea8a5cbd -
feat: update to DPO v6 merged model (BF16 safetensors)
Verified signatureffbdde5 -
feat: add DPO v6 GGUF Q4_K_M model
Verified signature2616a76 -
chore: remove v4 GGUF (replacing with v6)
Verified signature4917e1e
-
Update README.md
Verified signature07d2ac1
-
feat: vela-v5-merged 업로드 (SFT merged, rep_penalty=1.05)
Verified signaturea8cb4d0 -
fix: generation_config rep_penalty=1.05, top_k=20, top_p=0.8 (vela-v5-merged)
Verified signaturea0a3973
-
docs: add recommended inference settings and backend configuration guide
Verified signature3e8a713 -
fix: match llama-cpp-python defaults (top_k=40, top_p=0.95, rep_penalty=1.0)
Verified signaturedea4e49
-
fix: rollback generation_config to safe Qwen2.5 defaults (rep_penalty 1.3→1.1)
Verified signaturebfc3043 -
fix: update generation params — repetition_penalty 1.05→1.3, top_k 20→50, top_p 0.8→0.92
Verified signatured4a1479 -
docs: add GitHub framework link and badges
Verified signature67d9f79 -
Update README.md
Verified signature3fbe015 -
docs: add real output example (RT + Quick Assessment + Analysis Report)
Verified signaturec66f3a2
-
docs: update model card with v3 training data (58K SFT, 26K DPO), MLX benchmark, Markdown RT format
Verified signature7f641b5 -
feat: update to DPO v4 merged model (SFT + DPO v4 language leak fix)
Verified signaturec34c4f4 -
Delete vela-q8_0.gguf with huggingface_hub
Verified signatureb4ff857 -
Delete model.safetensors with huggingface_hub
Verified signature843923f -
feat: replace SFT-only GGUF with DPO v4 merged Q4_K_M
Verified signature88a0458 -
Delete vela-q4_k_m.gguf with huggingface_hub
Verified signaturea3cb0d9
-
fix: change tokenizer_class to Qwen2TokenizerFast for vLLM compatibility
Verified signatureecf8e6b
-
docs: update training data distribution with accurate numbers (SFT 36,713 + DPO 24,779)
Verified signatured35ad96 -
feat: add Q8_0 GGUF quantized model (7.6GB)
Verified signatureecb3e2c -
feat: add Q4_K_M GGUF quantized model (4.4GB)
Verified signature7b906a5 -
docs: update model card with GGUF formats, benchmarks, usage examples
Verified signature2448e8a
-
Fix tokenizer_config.json - remove extra_special_tokens list causing vLLM error
Verified signaturef650ef7 -
Fix config.json for vLLM compatibility (remove layer_types, fix rope_parameters)
Verified signature7dc1232 -
Fix year to 2026
Verified signature086591b -
Update model card for DPO v4
Verified signature0330d0c -
Update to DPO v4 merged model
Verified signaturec5f7d77 -
Upload folder using huggingface_hub
Verified signatureee82134 -
initial commit
Verified signaturea713b02