Instructions to use AeroAIAviation/Atlas-2.1-Small with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use AeroAIAviation/Atlas-2.1-Small with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("AeroAIAviation/Atlas-2.1-Small") config = load_config("AeroAIAviation/Atlas-2.1-Small") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use AeroAIAviation/Atlas-2.1-Small 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 AeroAIAviation/Atlas-2.1-Small:Q4_K_M # Run inference directly in the terminal: llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M # Run inference directly in the terminal: llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M
Use Docker
docker model run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use AeroAIAviation/Atlas-2.1-Small with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "AeroAIAviation/Atlas-2.1-Small" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "AeroAIAviation/Atlas-2.1-Small", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_M
- Ollama
How to use AeroAIAviation/Atlas-2.1-Small with Ollama:
ollama run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_M
- Unsloth Desktop
- Pi
How to use AeroAIAviation/Atlas-2.1-Small with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AeroAIAviation/Atlas-2.1-Small"
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "AeroAIAviation/Atlas-2.1-Small" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use AeroAIAviation/Atlas-2.1-Small with Docker Model Runner:
docker model run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_M
- Lemonade
How to use AeroAIAviation/Atlas-2.1-Small with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull AeroAIAviation/Atlas-2.1-Small:Q4_K_M
Run and chat with the model
lemonade run user.Atlas-2.1-Small-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use AeroAIAviation/Atlas-2.1-Small with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AeroAIAviation/Atlas-2.1-Small"
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 AeroAIAviation/Atlas-2.1-Small
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use AeroAIAviation/Atlas-2.1-Small with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AeroAIAviation/Atlas-2.1-Small"
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 "AeroAIAviation/Atlas-2.1-Small" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Install from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M# Run inference directly in the terminal:
llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_MBuild from source code
git clone https://github.com/ggml-org/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-app# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama serve -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M# Run inference directly in the terminal:
./build/bin/llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_MUse Docker
docker model run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_MIntroducing AeroAI's first official 3B parameter model: Atlas-2.1-Small
| AvBench Score | 74.4% |
Available in Q4_K_M and MLX Quantization - BF16 soon
Overview
Atlas-2.1-Small is the compact member of the Atlas-2 family, built off Ministral-3-3B. It is built for aviation Q&A and conversational use, and is small enough to run locally on consumer hardware and edge devices.
| Model | Role | Deployment | Status |
|---|---|---|---|
| Atlas-2-PRO | High-end thinking, aerospace engineering model | Server/hosted cloud | In Development |
| Atlas-2-Medium | Fast thinking, low-end agentic tasks | High compute edge devices | In Development |
| Atlas-2.1-Small | 3B chatbot model | Edge devices | Available |
| Atlas-2-Small | Experimental 2B chatbot model | Edge devices | Available-Previous Gen Model |
Advancements:
- More profound and detailed explanations
- More aviation knowledge
- Response/output formatting with tables, bullet points, bolded words, etc
- Improved message understanding
- Image input support/multimodality
- Model identity understanding
- 3B parameter footprint.
Intended Use
- Aviation question answering (general knowledge, regulations, procedures, terminology)
- Chatbot-style conversational queries
- Local inference on edge devices
Limitations and Safety
Not for commercial operational use. Atlas-2.1-Small is experimental and may produce incorrect, outdated, or fabricated answers.
- Do not use it for flight planning, navigation, aircraft maintenance, or any safety-critical decision.
- Always verify against official sources: FAA publications (14 CFR, AIM, POH/AFM), NOTAMs, and certified instructors.
- Calculations (fuel, weight and balance, performance) must be independently checked.
- Small models may hallucinate, particularly on numeric and regulatory detail.
Quick Start - Ollama
ollama run hf.co/AeroAIAviation/Atlas-2.1-Small:Q4_K_M
Python (Transformers)
pip install -U transformers torch accelerate
from transformers import AutoModelForCausalLM, AutoTokenizer
model_id = "AeroAI/Atlas-2.1-Small"
tok = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, device_map="auto")
messages = [{"role": "user", "content": "What does VFR stand for, and what are basic VFR weather minimums in Class E airspace below 10,000 ft MSL?"}]
inputs = tok.apply_chat_template(messages, add_generation_prompt=True, return_tensors="pt").to(model.device)
out = model.generate(inputs, max_new_tokens=256, temperature=0.7, do_sample=True)
print(tok.decode(out[0][inputs.shape[-1]:], skip_special_tokens=True))
Apple Silicon (MLX)
pip install -U mlx-lm
mlx_lm.generate --model AeroAI/Atlas-2.1-Small --prompt "Explain density altitude." --max-tokens 256
Model Details
| Field | Value |
|---|---|
| Developer | AeroAI |
| Family | Atlas-2 |
| Parameters | 3B |
| Type | Causal language model (chat) |
| Domain | Aviation and aerospace |
| Input / Output | Text and image/ Text |
| Context length | 256,000 |
| Training data | AeroAI Proprietary + Distillation |
| Fine-tuning method | LoRa + FFT |
| License | Apache 2.0 |
Evaluation on AvBench1.0_BENCHMARK
| Category | Score |
|---|---|
| Flight Planning Knowledge | 72.7% |
| Flight Planning Computational Abilities | 52.9% |
| Flight Plan Error Detection | 46.2% |
| Aviation Formulas Knowledge | 61.5% |
| Visual Chart Reading & Interpolation | 83.3% |
| Non-Visual Chart Reading | 100.0% |
| Aerospace Engineering | 100.0% |
| Basic Aviation Math | 100.0% |
| Complex Aviation Math | 66.7% |
| Airframe Systems & Formulas | 90.9% |
| Overall AvBench Score | 74.4% |
Training
Atlas-2.1-Small was trained on a consumer MacBook Pro, using Unsloth studio and a hybrid proprietary harness that shares compute with a free Google Colab space. The model was trained in four stages:
- Base model AvBench testing.
- Model training.
- Model testing.
- Post training/fine tuning and alignment.
Training materials included AeroAI proprietary datasets, along with distilled datasets using Perplexity, OpenAI's ChatGPT, Oscilla, and Anthropic's Claude.
Citation
@misc{aeroai_atlas2.1small,
title = {Atlas-2.1-Small: An Experimental Aviation Chatbot Model},
author = {{AeroAI}},
year = {2026}
}
Contact/Support
Website: https://aeroaiaviation.vercel.app/ Email: aeroaiaviation@icloud.com or aeroaisupport@icloud.com
- Downloads last month
- 371
4-bit
Model tree for AeroAIAviation/Atlas-2.1-Small
Base model
mistralai/Ministral-3-3B-Base-2512


Install (macOS, Linux)
# Start a local OpenAI-compatible server with a web UI: llama serve -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M# Run inference directly in the terminal: llama cli -hf AeroAIAviation/Atlas-2.1-Small:Q4_K_M