Instructions to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF", filename="LFM2.5-1.2B-Instruct-Q4_K_M.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF 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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
Use Docker
docker model run hf.co/FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with Ollama:
ollama run hf.co/FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
- Unsloth Studio
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF 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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF 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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF to start chatting
- Pi
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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": "FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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 FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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 "FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF: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"
- Docker Model Runner
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with Docker Model Runner:
docker model run hf.co/FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
- Lemonade
How to use FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull FerrellSyntheticIntelligence/Vitalis_LFM2.5_Cortex.GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Vitalis_LFM2.5_Cortex.GGUF-Q4_K_M
List all available models
lemonade list
d2a5f5a bebceb4 d2a5f5a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | """
Ferrell Synthetic Intelligence - Core Component
File: LFMController.py
Description: Dedicated local model execution controller interface linking
VitalisCore and SovereignEngine to local GGUF weights.
"""
import os
import asyncio
import logging
from concurrent.futures import ThreadPoolExecutor
from llama_cpp import Llama
# Configure explicit logging for internal diagnostics
logging.basicConfig(level=logging.INFO, format='%(asctime)s - [LFMController] - %(levelname)s - %(message)s')
logger = logging.getLogger("LFMController")
class LFMController:
def __init__(self, model_path: str = "", n_ctx: int = 4096, n_threads: int = 6, n_gpu_layers: int = -1):
if not model_path:
candidates = [
os.path.expanduser("~/.vitalis/models/LFM2.5-1.2B-Instruct-Q4_K_M.gguf"),
"LFM2.5-1.2B-Instruct-Q4_K_M.gguf",
]
for c in candidates:
if os.path.exists(c):
model_path = c
break
if not model_path:
model_path = candidates[0]
"""
Initializes the low-level Llama model runner.
"""
if not os.path.exists(model_path):
logger.critical(f"Target model weights missing at path: {model_path}")
raise FileNotFoundError(f"Model file target missing: {model_path}")
logger.info(f"Initializing local model instance from {model_path}...")
try:
self.llm = Llama(
model_path=model_path,
n_ctx=n_ctx,
n_threads=n_threads,
n_gpu_layers=n_gpu_layers,
verbose=False
)
logger.info("Model hardware acceleration context successfully initialized.")
except Exception as e:
logger.error(f"Failed to load hardware context for GGUF: {str(e)}")
raise e
# Single-worker ThreadPoolExecutor guarantees synchronous execution calls
# do not disrupt or freeze async orchestration loops in SovereignEngine.
self.executor = ThreadPoolExecutor(max_workers=1)
def execute_raw(self, prompt: str, max_tokens: int = 1024, temperature: float = 0.2, top_p: float = 0.95) -> str:
"""
Synchronous raw execution interface for VitalisCore orchestration.
Processes a prompt directly and returns the clean string token response.
"""
try:
response = self.llm(
prompt=prompt,
max_tokens=max_tokens,
temperature=temperature,
top_p=top_p,
stop=["<|endoftext|>", "###", "Instruction:", "Response:"]
)
output_text = response["choices"][0]["text"].strip()
return output_text
except Exception as e:
logger.error(f"Error encountered during raw execution sequence: {str(e)}")
return f"EXECUTION_ERROR: {str(e)}"
async def generate_async(self, prompt: str, max_tokens: int = 1024, temperature: float = 0.2, top_p: float = 0.95) -> str:
"""
Asynchronous interface wrapper for SovereignEngine retry and validation loops.
Offloads the computation to an isolated executor thread.
"""
loop = asyncio.get_running_loop()
try:
return await loop.run_in_executor(
self.executor,
self.execute_raw,
prompt,
max_tokens,
temperature,
top_p
)
except Exception as e:
logger.error(f"Async worker thread crashed: {str(e)}")
return f"ASYNC_EXECUTION_ERROR: {str(e)}"
def shutdown(self):
"""Cleanly releases pooled threads."""
self.executor.shutdown(wait=True)
|