Instructions to use Turhan123/astra-meal-parser-gguf with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use Turhan123/astra-meal-parser-gguf with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="Turhan123/astra-meal-parser-gguf", filename="astra-meal-parser-1.5b-q4_k_m.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf:Q4_K_M # Run inference directly in the terminal: llama cli -hf Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf:Q4_K_M # Run inference directly in the terminal: llama cli -hf Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Turhan123/astra-meal-parser-gguf:Q4_K_M
Use Docker
docker model run hf.co/Turhan123/astra-meal-parser-gguf:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use Turhan123/astra-meal-parser-gguf with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Turhan123/astra-meal-parser-gguf" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Turhan123/astra-meal-parser-gguf", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Turhan123/astra-meal-parser-gguf:Q4_K_M
- Ollama
How to use Turhan123/astra-meal-parser-gguf with Ollama:
ollama run hf.co/Turhan123/astra-meal-parser-gguf:Q4_K_M
- Unsloth Studio
How to use Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Turhan123/astra-meal-parser-gguf to start chatting
- Pi
How to use Turhan123/astra-meal-parser-gguf with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Turhan123/astra-meal-parser-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": "Turhan123/astra-meal-parser-gguf:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use Turhan123/astra-meal-parser-gguf with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Turhan123/astra-meal-parser-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 "Turhan123/astra-meal-parser-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 Turhan123/astra-meal-parser-gguf with Docker Model Runner:
docker model run hf.co/Turhan123/astra-meal-parser-gguf:Q4_K_M
- Lemonade
How to use Turhan123/astra-meal-parser-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Turhan123/astra-meal-parser-gguf:Q4_K_M
Run and chat with the model
lemonade run user.astra-meal-parser-gguf-Q4_K_M
List all available models
lemonade list
llm.create_chat_completion(
messages = [
{
"role": "user",
"content": "What is the capital of France?"
}
]
)🥗 Astra Meal Parser — GGUF
Quantized GGUF builds of a meal-parsing model that reads a free-text meal description in Turkish or English and returns a structured list of food items and their amounts. The model only parses; calories and macros are computed downstream from a nutrition table + calculator (see the full model card for the design).
Available files
| File | Base | Size | License | Notes |
|---|---|---|---|---|
astra-meal-parser-1.5b-q4_k_m.gguf |
Qwen2.5-1.5B | ~1.0 GB | Apache 2.0 | Recommended / deployed — faster on CPU, trained on the expanded dataset |
astra-meal-parser-q4_k_m.gguf |
Qwen2.5-3B | ~1.9 GB | Qwen Research | Legacy / archive |
The 1.5B build is the recommended one: it is roughly twice as fast on CPU and matches or exceeds the 3B build in accuracy while covering a larger food set.
Evaluation (1.5B)
Held-out set of 149 meal descriptions (TR / EN / mixed), zero overlap with training. Parsing scores the model output; nutrition metrics reflect the full pipeline (parser + 144-food nutrition table + calculator).
| Metric | Value |
|---|---|
| Item Precision / Recall / F1 | 100% / 99% / 99% |
| Parse failures | 0 / 149 |
| Calorie MAPE | 1.9% |
| Protein / Carbs / Fat MAE | 0.3 g / 1.0 g / 0.3 g |
Calorie MAPE by language: Turkish 2.2%, English 1.6%, Mixed 1.1%.
Output format
{"items": [{"name": "string", "amount": "string"}]}
No prose, no markdown, no macros.
System prompt
You are a meal parser. Extract every food item and its amount from the user's meal
description (Turkish or English). Return ONLY a strict JSON object of the form
{"items": [{"name": string, "amount": string}]}. No macros, no calories, no
conversational text, no markdown, only valid JSON.
Usage
Ollama
FROM ./astra-meal-parser-1.5b-q4_k_m.gguf
TEMPLATE """{{ if .System }}<|im_start|>system
{{ .System }}<|im_end|>
{{ end }}{{ if .Prompt }}<|im_start|>user
{{ .Prompt }}<|im_end|>
{{ end }}<|im_start|>assistant
{{ .Response }}<|im_end|>
"""
SYSTEM """You are a meal parser. Extract every food item and its amount from the user's meal description (Turkish or English). Return ONLY a strict JSON object of the form {"items": [{"name": string, "amount": string}]}. No macros, no calories, no conversational text, no markdown, only valid JSON."""
PARAMETER temperature 0
PARAMETER stop "<|im_end|>"
ollama create astra-parser -f Modelfile
ollama run astra-parser "2 yumurta, 100g tavuk göğsü ve 1 muz"
llama.cpp
huggingface-cli download Turhan123/astra-meal-parser-gguf \
astra-meal-parser-1.5b-q4_k_m.gguf --local-dir .
llama-server -m astra-meal-parser-1.5b-q4_k_m.gguf -c 2048
llama-cpp-python
from llama_cpp import Llama
llm = Llama(model_path="astra-meal-parser-1.5b-q4_k_m.gguf", n_ctx=2048, chat_format="chatml")
SYSTEM = (
"You are a meal parser. Extract every food item and its amount from the user's "
"meal description (Turkish or English). Return ONLY a strict JSON object of the form "
'{"items": [{"name": string, "amount": string}]}. '
"No macros, no calories, no conversational text, no markdown, only valid JSON."
)
out = llm.create_chat_completion(
messages=[{"role": "system", "content": SYSTEM},
{"role": "user", "content": "2 yumurta, 100g tavuk göğsü ve 1 muz"}],
temperature=0, max_tokens=256, stop=["<|im_end|>"],
)
print(out["choices"][0]["message"]["content"])
Limitations
Parsing only — calorie/macro accuracy depends on the accompanying nutrition table and calculator. Vague portions are resolved with default serving sizes. See the full model card for the complete list.
License
- 1.5B build (recommended): derived from Qwen2.5-1.5B-Instruct, Apache 2.0.
- 3B build (legacy): derived from Qwen2.5-3B-Instruct, subject to the Qwen Research License.
- Downloads last month
- 195
4-bit
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="Turhan123/astra-meal-parser-gguf", filename="", )