Instructions to use iamabhayaditya/EfficientMath-AI with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use iamabhayaditya/EfficientMath-AI with PEFT:
Task type is invalid.
- Transformers
How to use iamabhayaditya/EfficientMath-AI with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="iamabhayaditya/EfficientMath-AI")# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("iamabhayaditya/EfficientMath-AI") model = AutoModelForCausalLM.from_pretrained("iamabhayaditya/EfficientMath-AI", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use iamabhayaditya/EfficientMath-AI 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 iamabhayaditya/EfficientMath-AI:Q4_K_M # Run inference directly in the terminal: llama cli -hf iamabhayaditya/EfficientMath-AI:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf iamabhayaditya/EfficientMath-AI:Q4_K_M # Run inference directly in the terminal: llama cli -hf iamabhayaditya/EfficientMath-AI: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 iamabhayaditya/EfficientMath-AI:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf iamabhayaditya/EfficientMath-AI: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 iamabhayaditya/EfficientMath-AI:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf iamabhayaditya/EfficientMath-AI:Q4_K_M
Use Docker
docker model run hf.co/iamabhayaditya/EfficientMath-AI:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use iamabhayaditya/EfficientMath-AI with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "iamabhayaditya/EfficientMath-AI" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "iamabhayaditya/EfficientMath-AI", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/iamabhayaditya/EfficientMath-AI:Q4_K_M
- SGLang
How to use iamabhayaditya/EfficientMath-AI 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 "iamabhayaditya/EfficientMath-AI" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "iamabhayaditya/EfficientMath-AI", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "iamabhayaditya/EfficientMath-AI" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "iamabhayaditya/EfficientMath-AI", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Ollama
How to use iamabhayaditya/EfficientMath-AI with Ollama:
ollama run hf.co/iamabhayaditya/EfficientMath-AI:Q4_K_M
- Unsloth Desktop
- Docker Model Runner
How to use iamabhayaditya/EfficientMath-AI with Docker Model Runner:
docker model run hf.co/iamabhayaditya/EfficientMath-AI:Q4_K_M
- Lemonade
How to use iamabhayaditya/EfficientMath-AI with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull iamabhayaditya/EfficientMath-AI:Q4_K_M
Run and chat with the model
lemonade run user.EfficientMath-AI-Q4_K_M
List all available models
lemonade list
- Atomic Chat
File size: 2,811 Bytes
9cc09c6 968153d 12ca67d 968153d 12ca67d 968153d 12ca67d 968153d 9cc09c6 12ca67d 9cc09c6 968153d 434243a 968153d 5441ab7 968153d 9cc09c6 968153d 9cc09c6 968153d 9cc09c6 968153d | 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 | ---
base_model: meta-llama/Meta-Llama-3.1-8B
library_name: peft
license: llama3.1
datasets:
- openai/gsm8k
language:
- en
metrics:
- accuracy
- perplexity
pipeline_tag: text-generation
tags:
- llama.cpp
- unsloth
- transformers
- math
- custom-instruction
- LoRA
---
# ๐งฎ EfficientMath-AI (Llama 3.1 8B)
## ๐ Project Overview
EfficientMath-AI is a parameter-efficient fine-tuned (PEFT) version of Meta's **Llama-3.1-8B**, specifically optimized to solve multi-step, grade-school math word problems. It was trained using LoRA (Low-Rank Adaptation) and compressed into a 4-bit quantized GGUF format, allowing it to perform high-level mathematical reasoning efficiently on standard CPU hardware.
**Creator:** Abhay Aditya
**Live Interactive Demo:** [EfficientMath-AI Web App](https://huggingface.co/spaces/iamabhayaditya/EfficientMath-AI)
## ๐ง Model Details
* **Base Model:** `meta-llama/Meta-Llama-3.1-8B`
* **Fine-Tuning Method:** LoRA (Rank = 16, Alpha = 16) via Unsloth
* **Dataset:** GSM8K (Grade School Math 8K)
* **Quantization:** `Q4_K_M` (4-bit GGUF)
* **Parameters:** 8 Billion
* **Deployment Context:** Designed for high-speed, CPU-only inference via `llama.cpp`.
* ๐ **Model Impact Note:** While the sidebar tracks the rolling 30-day window,EfficientMath-AI has accumulated 85+ total lifetime downloads since its release on March 24, 2026!
## ๐ Evaluation & Performance
The model was evaluated against a rigorous test split of the GSM8K dataset, focusing on strict numeric extraction and step-by-step reasoning coherence.
* **Overall Accuracy:** 66%
* **Training Hardware:** Single NVIDIA T4 GPU (Free Tier)
* **Inference Hardware Requirement:** ~8GB RAM (Basic CPU)

### Diagnostic Insights:
1. **Perplexity:** The model exhibits a tightly clustered, low perplexity distribution (between 2.5 and 4.0), demonstrating high confidence and fluency in generating mathematical syntax.
2. **Complexity Ceiling:** The model achieves near 80% accuracy on short word problems, maintaining a concise and highly accurate "Chain of Thought" without hallucinating verbose responses. Like many 8B class models, accuracy scales inversely with prompt length on highly complex, multi-paragraph logic puzzles.
## ๐ป Usage Example (Python)
If you wish to run this model locally, you can use `llama-cpp-python`:
```python
from llama_cpp import Llama
llm = Llama(
model_path="Meta-Llama-3.1-8B.Q4_K_M.gguf",
n_ctx=2048,
n_threads=4
)
output = llm(
"Below is a math word problem. Solve it step by step and provide the final answer.\n\n### Problem:\nIf the cost of 18 apples is 90 rupees, what is the cost of 24 apples?\n\n### Solution:\n",
max_tokens=256,
temperature=0.2,
stop=["<|eot_id|>"]
)
print(output["choices"][0]["text"]) |