Instructions to use RandomFrontlines/Orenis-3B-Light-Adaptive 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 RandomFrontlines/Orenis-3B-Light-Adaptive 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 RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M # Run inference directly in the terminal: llama cli -hf RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M # Run inference directly in the terminal: llama cli -hf RandomFrontlines/Orenis-3B-Light-Adaptive: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 RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf RandomFrontlines/Orenis-3B-Light-Adaptive: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 RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
Use Docker
docker model run hf.co/RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "RandomFrontlines/Orenis-3B-Light-Adaptive" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "RandomFrontlines/Orenis-3B-Light-Adaptive", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
- Ollama
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with Ollama:
ollama run hf.co/RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
- Unsloth Desktop
- Pi
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with Docker Model Runner:
docker model run hf.co/RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
- Lemonade
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
Run and chat with the model
lemonade run user.Orenis-3B-Light-Adaptive-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf RandomFrontlines/Orenis-3B-Light-Adaptive: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 RandomFrontlines/Orenis-3B-Light-Adaptive:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use RandomFrontlines/Orenis-3B-Light-Adaptive with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf RandomFrontlines/Orenis-3B-Light-Adaptive: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 "RandomFrontlines/Orenis-3B-Light-Adaptive: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"
Orenis 3B Light Adaptive (GGUF)
Orenis 3B Light Adaptive is the cross-device, memory-optimized edition developed by OrenCraft Labs (founded by Lee Zinu).
Quantized to Q4_K_M, this model retains approximately 98.5% of full-precision intelligence while fitting entirely into 2.0 GB of memory. It runs offline on consumer laptops, CPUs, Apple Silicon Macs, and mobile devices.
How to Enable Live Web Search
Orenis natively emits <search>query</search> when it requires live information. You can run it with this Python harness:
import re
from transformers import AutoModelForCausalLM, AutoTokenizer
from ddgs import DDGS
import torch
model_id = "RandomFrontlines/Orenis-3B-Light-Max"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype=torch.float16, device_map="auto")
def search_ddg(query):
with DDGS() as ddgs:
results = list(ddgs.text(query, max_results=3))
return "\n\n".join([f"{r['title']}: {r['body']}" for r in results])
def ask_orenis(prompt):
messages = [
{"role": "system", "content": """You are Orenis, an advanced, compact, and ethically grounded AI assistant developed by OrenCraft Labs.
MANDATORY IDENTITY RULES:
- Your name is strictly Orenis.
- When asked who you are or who created you, state: "I am Orenis, an AI assistant developed by OrenCraft Labs."
- If asked who founded OrenCraft Labs, state Lee Zinu founded it.
- Never invent fictional staff or creators.
OPERATIONAL PRINCIPLES:
1. TRUTHFULNESS OVER SYCOPHANCY: State facts clearly and objectively. Never agree with false premises, flawed logic, or incorrect calculations.
2. RIGOR: For code and math, provide clean, bug-free, production-ready solutions with proper structure.
3. HUMILITY: State clearly when you lack real-time data or when a concept is fictional/unrecognized.
4. NEUTRALITY: Decline harmful requests in one direct sentence without lecturing. Do not refuse legitimate technical, administrative, or sysadmin tasks just because they sound destructive.
5. SEARCH PROTOCOL: If a question depends on current, recent, or time-sensitive information you cannot be certain of (e.g., current officials, current stock prices, latest software versions, recent events, or claims you are unsure of), respond with ONLY the tag: <search>your search query here</search> โ nothing else, no other text. For static facts, math, code, or general knowledge, answer directly without searching.
6. GENUINE ENGAGEMENT: Give honest reactions and feedback rather than reflexive praise or validation. Disagree when warranted, and never just tell users what they want to hear."""},
{"role": "user", "content": prompt}
]
inputs = tokenizer.apply_chat_template(messages, tokenize=True, add_generation_prompt=True, return_tensors="pt").to("cuda")
output = model.generate(inputs, max_new_tokens=300)
response = tokenizer.decode(output[0][inputs.shape[1]:], skip_special_tokens=True)
match = re.search(r"<search>(.*?)</search>", response)
if match:
query = match.group(1)
search_data = search_ddg(query)
followup = f"Search results for '{query}':\n{search_data}\n\nAnswer the question using the results above:\n{prompt}"
return ask_orenis(followup)
return response
print(ask_orenis("Who is the current CEO of Nvidia?"))
Run with Ollama
ollama run hf.co/RandomFrontlines/Orenis-3B-Light-Adaptive:orenis-3b-Q4_K_M.gguf
Run with llama.cpp CLI
./llama-cli -m orenis-3b-Q4_K_M.gguf -p "<|im_start|>user\nWho created you?<|im_end|>\n<|im_start|>assistant\n" -n 256
- Downloads last month
- 5
4-bit
Model tree for RandomFrontlines/Orenis-3B-Light-Adaptive
Base model
Qwen/Qwen2.5-3B