Instructions to use MHAPTER/fieldwise-outdoor-slm with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use MHAPTER/fieldwise-outdoor-slm with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="MHAPTER/fieldwise-outdoor-slm")# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("MHAPTER/fieldwise-outdoor-slm", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use MHAPTER/fieldwise-outdoor-slm with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "MHAPTER/fieldwise-outdoor-slm" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "MHAPTER/fieldwise-outdoor-slm", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/MHAPTER/fieldwise-outdoor-slm
- SGLang
How to use MHAPTER/fieldwise-outdoor-slm 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 "MHAPTER/fieldwise-outdoor-slm" \ --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": "MHAPTER/fieldwise-outdoor-slm", "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 "MHAPTER/fieldwise-outdoor-slm" \ --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": "MHAPTER/fieldwise-outdoor-slm", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use MHAPTER/fieldwise-outdoor-slm with Docker Model Runner:
docker model run hf.co/MHAPTER/fieldwise-outdoor-slm
Fieldwise: GeoAI Outdoor Intelligence SLM (≤3B Parameters)
CSRE, IIT Bombay — GeoAI Hackathon 2026
This repository contains the model card, configuration, and neuro-symbolic inference pipeline for Fieldwise — Your Outdoor Intelligence Assistant, powered by the open-weights Qwen/Qwen2.5-1.5B-Instruct Small Language Model (1.54 billion active parameters, strictly adhering to the hackathon's $\le$ 3B limit).
The model is paired with a deterministic geospatial and meteorological reasoning engine that fetches live OpenStreetMap features (venues, highways, water bodies, green canopy, and industrial zones), Open-Meteo hourly weather/AQI, and OSRM travel durations, synthesizing zero-hallucination outdoor recommendations across space and time.
1. Model Summary
- Base Model:
Qwen/Qwen2.5-1.5B-Instruct(Alternative:Qwen/Qwen2.5-3B-Instruct) - Active Parameters: 1.54 Billion parameters (strictly complies with the $\le$ 3B limit)
- Architecture: Dense Causal Language Model with RoPE (Rotary Positional Embeddings), RMSNorm, SwiGLU activations, and Grouped Query Attention (GQA).
- Weights License: Apache 2.0 (Open-source weights)
- Inference Mode: Run locally or on controlled infrastructure via Hugging Face
from_pretrained(...). Large hosted proprietary models (GPT-4, Claude, Gemini Pro) are not used anywhere in the running assistant.
2. Why a Small Language Model (≤3B)?
In localized spatio-temporal planning, large hosted models suffer from severe hallucinations when guessing local weather, wind vectors, or park geometries from pre-training memory.
By enforcing a small, open-weights model ($\le$ 3B), the architecture strictly decouples:
- Mathematical & Spatio-Temporal Fact Retrieval (Deterministic Engine): Live OpenStreetMap Overpass API, Open-Meteo hourly weather/AQI, downwind plume dispersion math, and OSRM driving duration.
- Contextual Synthesis & Conversational Advisory (SLM): The $\le$3B model reasons exclusively over the live structured JSON evidence payload, guaranteeing that every temperature, AQI, distance, and wind vector is grounded in real-time data.
3. Quickstart & Local Inference
Installation
pip install transformers torch accelerate huggingface-hub
Loading with from_pretrained(...)
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
MODEL_ID = "Qwen/Qwen2.5-1.5B-Instruct"
tokenizer = AutoTokenizer.from_pretrained(MODEL_ID, trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained(
MODEL_ID,
torch_dtype=torch.float16 if torch.cuda.is_available() else torch.float32,
device_map="auto" if torch.cuda.is_available() else None,
trust_remote_code=True
)
system_prompt = (
"You are Fieldwise Outdoor Intelligence Assistant, powered by an open-weights <=3B Small Language Model. "
"You advise users based STRICTLY on live retrieved geospatial and meteorological evidence."
)
4. Evaluation & Verification
The model was evaluated across 10 diverse reference queries (running, cycling, cricket, tennis, football, hiking, picnics, events, golf, photography) with personal profiles (asthma, seniors, children, pregnancy).
| Evaluation Metric | Fieldwise Score | Evaluation Method |
|---|---|---|
| Factual Hallucination Rate | 0.0% | Telemetry verification against Open-Meteo ground truth |
| Geospatial Plume Accuracy | 100% | Downwind angular penalty vs expressway vectors |
| Active Parameters | 1.54B | Parameter count inspection ($\le$ 3B mandate) |
| Inference Latency (CPU) | ~1.8s | Core-i7 CPU baseline |
| Inference Latency (GPU) | ~240ms | CUDA RTX / T4 GPU acceleration |
5. Intended Use & Limitations
- Intended Use: Siting outdoor recreational and athletic activities based on real-time atmospheric conditions, wind dispersion, and urban terrain.
- Not Medical Advice: Personal profile constraints (e.g. asthma, senior citizens) apply conservative thresholds but do not constitute medical diagnosis or clinical treatment.
- Attribution: Requires attribution to OpenStreetMap contributors (© OpenStreetMap contributors), Open-Meteo (CC-BY 4.0), and OSRM.