Instructions to use alpha-ai/Reason-With-Choice-3B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Transformers:
# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("alpha-ai/Reason-With-Choice-3B-GGUF", dtype="auto") - llama-cpp-python
How to use alpha-ai/Reason-With-Choice-3B-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="alpha-ai/Reason-With-Choice-3B-GGUF", filename="Reason-With-Choice-3B.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 alpha-ai/Reason-With-Choice-3B-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf alpha-ai/Reason-With-Choice-3B-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 alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf alpha-ai/Reason-With-Choice-3B-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 alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Ollama:
ollama run hf.co/alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
- Unsloth Studio
How to use alpha-ai/Reason-With-Choice-3B-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 alpha-ai/Reason-With-Choice-3B-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 alpha-ai/Reason-With-Choice-3B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for alpha-ai/Reason-With-Choice-3B-GGUF to start chatting
- Pi
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf alpha-ai/Reason-With-Choice-3B-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": "alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf alpha-ai/Reason-With-Choice-3B-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 alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
Run Hermes
hermes
- Docker Model Runner
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Docker Model Runner:
docker model run hf.co/alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
- Lemonade
How to use alpha-ai/Reason-With-Choice-3B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull alpha-ai/Reason-With-Choice-3B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Reason-With-Choice-3B-GGUF-Q4_K_M
List all available models
lemonade list
Website - https://www.alphaai.biz
Uploaded model
- Developed by: alphaaico
- License: apache-2.0
- Finetuned from model : meta-llama/Llama-3.2-3B-Instruct
- Training Framework: Unsloth + Hugging Face TRL
- Finetuning Techniques: GRPO + Reward Modelling
Overview
Welcome to the next evolution of AI reasoning! Reason-With-Choice-3B is not just another fine-tuned model, it's a game-changer. It doesn't just generate reasoning, it chooses whether reasoning is even necessary before delivering an answer. This self-reflective capability allows it to introspect, analyze, and adapt to the complexity of each question, ensuring the most efficient and insightful response possible.
Think about it: most AI models blindly generate reasoning even when unnecessary, leading to bloated, redundant responses. Not this one. With its built-in decision-making, Reason-With-Choice-3B determines if deep reasoning is needed or if a direct answer will suffice—bringing unparalleled efficiency and intelligence to your AI-driven applications.
Key Highlights
- Reasoning & Self-Reflection: The model first decides if reasoning is necessary and then either provides step-by-step logic or directly answers the question.
- Structured Output: Responses follow a strict format with
<think>,<reflection>, and<answer>sections, ensuring clarity and interpretability. - Optimized Training: Trained using GRPO (Guided Reward Policy Optimization) to enforce structured responses and improve decision-making.
- Efficient Inference: Fine-tuned with Unsloth & Hugging Face's TRL, ensuring faster inference speeds and optimized resource utilization.
Prompt Structure
The model generates responses in the following structured format:
<think>
[Detailed reasoning, if required. Otherwise, this section remains empty.]
</think>
<reflection>
[Internal thought process explaining whether reasoning was needed.]
</reflection>
<answer>
[Final response.]
</answer>
Key Features
- Decision-Making Capability: The model intelligently determines whether reasoning is necessary before answering.
- Improved Accuracy: Training with reward functions ensures adherence to logical response structure.
- Structured Outputs: Guarantees that each response follows a predictable and interpretable format.
- Enhanced Efficiency: Optimized inference with vLLM for fast token generation and low memory footprint.
- Multi-Use Case Compatibility: Can be used for Q&A systems, logical reasoning tasks, and AI-assisted decision-making.
Quantization Levels Available
- q4_k_m
- q5_k_m
- q8_0
- 16-bit (Full Precision, https://huggingface.co/alpha-ai/Reason-With-Choice-3B)
Ideal Configuration for Usage
- Temperature: 0.8
- Top-p: 0.95
- Max Tokens: 1024
Use Cases
Reason-With-Choice-3B is ideal for:
- AI Research: Investigating decision-making and reasoning processes in AI.
- Conversational AI: Enhancing chatbot intelligence with structured reasoning.
- Automated Decision Support: Assisting in structured, step-by-step problem-solving.
- Educational Tools: Providing logical explanations for learning and problem-solving.
- Business Intelligence: AI-assisted decision-making for operational and strategic planning.
Limitations & Considerations
- Domain Adaptation: May require further fine-tuning for domain-specific tasks.
- Inference Time: Increased processing time when reasoning is necessary.
- Potential Biases: Outputs depend on training data and may require verification for critical applications.
License
This model is released under the Apache-2.0 license.
Acknowledgments
Special thanks to the Unsloth team for optimizing the fine-tuning pipeline and to Hugging Face's TRL for enabling advanced fine-tuning techniques.
Security & Format Considerations
This model has been saved in .bin format due to Unsloth's default serialization method. If security is a concern, we recommend converting to .safetensors using:
from transformers import AutoModel
from safetensors.torch import save_file
model = AutoModel.from_pretrained("path/to/model")
state_dict = model.state_dict()
save_file(state_dict, "model.safetensors")
print("Model converted to safetensors successfully.")
Alternatively, GGUF models are available for optimized inference with llama.cpp, exllama, and other runtime frameworks.
Choose the format best suited to your security, performance, and deployment requirements.
- Downloads last month
- 43
4-bit
5-bit
8-bit
Model tree for alpha-ai/Reason-With-Choice-3B-GGUF
Base model
meta-llama/Llama-3.2-3B-Instruct