Instructions to use yusuf3416/Aeon-Q4 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use yusuf3416/Aeon-Q4 with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="yusuf3416/Aeon-Q4", filename="Aeon-Q4.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 yusuf3416/Aeon-Q4 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 yusuf3416/Aeon-Q4:Q4_K_M # Run inference directly in the terminal: llama cli -hf yusuf3416/Aeon-Q4:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf yusuf3416/Aeon-Q4:Q4_K_M # Run inference directly in the terminal: llama cli -hf yusuf3416/Aeon-Q4: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 yusuf3416/Aeon-Q4:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf yusuf3416/Aeon-Q4: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 yusuf3416/Aeon-Q4:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf yusuf3416/Aeon-Q4:Q4_K_M
Use Docker
docker model run hf.co/yusuf3416/Aeon-Q4:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use yusuf3416/Aeon-Q4 with Ollama:
ollama run hf.co/yusuf3416/Aeon-Q4:Q4_K_M
- Unsloth Studio
How to use yusuf3416/Aeon-Q4 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 yusuf3416/Aeon-Q4 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 yusuf3416/Aeon-Q4 to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for yusuf3416/Aeon-Q4 to start chatting
- Pi
How to use yusuf3416/Aeon-Q4 with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf yusuf3416/Aeon-Q4: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": "yusuf3416/Aeon-Q4:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use yusuf3416/Aeon-Q4 with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf yusuf3416/Aeon-Q4: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 yusuf3416/Aeon-Q4:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use yusuf3416/Aeon-Q4 with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf yusuf3416/Aeon-Q4: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 "yusuf3416/Aeon-Q4: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 yusuf3416/Aeon-Q4 with Docker Model Runner:
docker model run hf.co/yusuf3416/Aeon-Q4:Q4_K_M
- Lemonade
How to use yusuf3416/Aeon-Q4 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull yusuf3416/Aeon-Q4:Q4_K_M
Run and chat with the model
lemonade run user.Aeon-Q4-Q4_K_M
List all available models
lemonade list
Aeon-Q4 : GGUF
Aeon Q4 is a Turkish-focused fine-tune of meta-llama/Llama-3.1-8B-Instruct, trained with Unsloth and QLoRA on a Turkish SFT (Supervised Fine-Tuning) dataset, then converted to GGUF format for fast local inference.
- What it is: an 8B parameter Turkish instruction-tuned chat model
- How it was trained: QLoRA fine-tuning with Unsloth + TRL
SFTTrainer - Why GGUF: quantized for efficient CPU/GPU inference via
llama.cppandOllama - Where to use it:
llama.cpp,llama-cli,llama-mtmd-cli, orOllama
⚠️ Alpha / Research Preview — This is an early research checkpoint (Stage 1 SFT, ~end of epoch 1/3), released for community testing and feedback rather than production use. Several known weaknesses (hallucination, inconsistent JSON schema output, multi-character dialogue degradation) have not yet been addressed — see Known Limitations below.
Model Details
| Property | Value |
|---|---|
| Base model | Llama 3.1 8B Instruct |
| Training method | QLoRA (Unsloth + TRL SFTTrainer) |
LoRA rank (r) |
16 |
| LoRA alpha | 32 |
| Max sequence length | 128k |
| Effective batch size | 16 |
| Optimizer | AdamW 8-bit |
| Scheduler | Cosine |
| Total steps | ~5292 (3 epochs) |
| Hardware | T4 (Google Colab) |
| Quantization | Q4_K_M (GGUF) |
Training Summary
Aeon Q4 was fine-tuned on a Turkish identity/instruction-following SFT dataset using QLoRA to keep memory usage low enough for a single T4 GPU. Training used an 8-bit AdamW optimizer with a cosine learning-rate schedule and gradient checkpointing (via Unsloth) to enable a large effective context window. This release corresponds to a checkpoint taken near the end of the first epoch of a planned three-epoch Stage 1 run; evaluation was performed every 150 steps (eval_steps=150).
Usage
| Use case | Command |
|---|---|
| Text only LLMs | llama-cli -hf yusuf3416/Aeon-Q4 --jinja |
| Multimodal models | llama-mtmd-cli -hf yusuf3416/Aeon-Q4 --jinja |
Available Model Files
| File | Quantization |
|---|---|
meta-llama-3.1-8b-instruct.Q4_K_M.gguf |
Q4_K_M |
Additional quantization variants (Q4_0, Q5_K_M, Q8_0, etc.) may be added later.
Ollama
An Ollama Modelfile is included for easy deployment:
ollama create aeon-q4 -f Modelfile
ollama run aeon-q4
Training Metrics
The charts below track key metrics throughout Stage 1 SFT training (eval_steps=150).
Eval Loss
Evaluation loss showed a consistent downward trend across checkpoints, decreasing from roughly 1.36 at step 150 to roughly 1.05 at step 1950, without visible signs of overfitting at this stage of training.
Train Loss
Gradient Norm
Learning Rate
Evaluation loss showed a consistent downward trend across checkpoints, from ~1.36 (step 150) to ~1.05 (step 1950).
Current Strengths
- Turkish fluency: More natural, idiomatic Turkish phrasing compared to the base model's out-of-the-box Turkish output.
- Instruction following: Improved adherence to Turkish-language prompts and formatting requests.
- Identity consistency: The "Aeon Q4" persona remained stable and resisted adversarial jailbreak attempts even across extended contexts.
- Stable optimization: Smooth, monotonic loss decrease with no divergence or instability observed during Stage 1.
Known Limitations
Comprehensive inference testing surfaced the following weaknesses, which are targeted for Stage 2 training:
- Hallucination: Tendency to fabricate information when asked about nonexistent entities (confirmed as a greedy-decoding issue).
- Strategic math: Failure on math problems requiring correct method selection.
- JSON schema inconsistency: Output doesn't always conform to the requested schema.
- Multi-character dialogue: Loss of coherence in longer/complex multi-character dialogue.
Planned Improvements (Roadmap)
- Targeted data and training adjustments to reduce hallucination
- Reasoning-focused SFT to improve strategic math and multi-step problem solving
- Stricter JSON-schema adherence training
- Extended multi-turn / multi-character dialogue training
- Turkish-language benchmark evaluation before the next public checkpoint
Evaluation
No formal benchmark results are available yet for this alpha checkpoint. Planned evaluations for upcoming releases include:
- MMLU
- TruthfulQA
- GSM8K
- IFEval
- MT-Bench (Turkish)
This section will be updated as benchmark results become available.
License
This model is released under the Llama 3.1 Community License, inherited from the base model meta-llama/Llama-3.1-8B-Instruct. Use of this model is subject to Meta's Llama 3.1 license terms and acceptable use policy.
Acknowledgements
Thanks to the teams and projects that made this work possible:
- Meta for the Llama 3.1 base model
- Unsloth for fast, memory-efficient fine-tuning
- Hugging Face TRL for the
SFTTrainer - Hugging Face for model hosting and tooling
- llama.cpp and Ollama for inference support
Training Details
This model was trained 2x faster using Unsloth.
Citation
If you use Aeon-Q4 in your research, applications, or derivative work, please cite:
@software{aeonq4,
author = {Yusuf},
title = {Aeon-Q4: Turkish QLoRA Fine-Tuning of Llama 3.1 8B Instruct},
year = {2026},
publisher = {Hugging Face},
url = {https://huggingface.co/yusuf3416/Aeon-Q4}
}
- Downloads last month
- 780
4-bit
Model tree for yusuf3416/Aeon-Q4
Base model
meta-llama/Llama-3.1-8B