Instructions to use cetusian/pocket-atlas-0.8b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use cetusian/pocket-atlas-0.8b with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("cetusian/pocket-atlas-0.8b") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - llama-cpp-python
How to use cetusian/pocket-atlas-0.8b with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="cetusian/pocket-atlas-0.8b", filename="pocket-atlas-f16.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use cetusian/pocket-atlas-0.8b with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf cetusian/pocket-atlas-0.8b:Q4_K_M # Run inference directly in the terminal: llama-cli -hf cetusian/pocket-atlas-0.8b:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf cetusian/pocket-atlas-0.8b:Q4_K_M # Run inference directly in the terminal: llama-cli -hf cetusian/pocket-atlas-0.8b: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 cetusian/pocket-atlas-0.8b:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf cetusian/pocket-atlas-0.8b: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 cetusian/pocket-atlas-0.8b:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf cetusian/pocket-atlas-0.8b:Q4_K_M
Use Docker
docker model run hf.co/cetusian/pocket-atlas-0.8b:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use cetusian/pocket-atlas-0.8b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "cetusian/pocket-atlas-0.8b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cetusian/pocket-atlas-0.8b", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/cetusian/pocket-atlas-0.8b:Q4_K_M
- Ollama
How to use cetusian/pocket-atlas-0.8b with Ollama:
ollama run hf.co/cetusian/pocket-atlas-0.8b:Q4_K_M
- Unsloth Studio new
How to use cetusian/pocket-atlas-0.8b 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 cetusian/pocket-atlas-0.8b 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 cetusian/pocket-atlas-0.8b to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for cetusian/pocket-atlas-0.8b to start chatting
- Pi new
How to use cetusian/pocket-atlas-0.8b with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "cetusian/pocket-atlas-0.8b"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "cetusian/pocket-atlas-0.8b" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use cetusian/pocket-atlas-0.8b 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 "cetusian/pocket-atlas-0.8b"
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 cetusian/pocket-atlas-0.8b
Run Hermes
hermes
- MLX LM
How to use cetusian/pocket-atlas-0.8b with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "cetusian/pocket-atlas-0.8b"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "cetusian/pocket-atlas-0.8b" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cetusian/pocket-atlas-0.8b", "messages": [ {"role": "user", "content": "Hello"} ] }' - Docker Model Runner
How to use cetusian/pocket-atlas-0.8b with Docker Model Runner:
docker model run hf.co/cetusian/pocket-atlas-0.8b:Q4_K_M
- Lemonade
How to use cetusian/pocket-atlas-0.8b with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull cetusian/pocket-atlas-0.8b:Q4_K_M
Run and chat with the model
lemonade run user.pocket-atlas-0.8b-Q4_K_M
List all available models
lemonade list
Pocket Atlas 0.8B
"A towel is about the most massively useful thing an interstellar hitchhiker can have." — Douglas Adams
Pocket Atlas is your towel for ideas.
A fine-tuned Qwen3.5-0.8B that lives on your device and explains anything — clearly, warmly, and precisely. Ask it about quantum decoherence, the social contract, or why your sourdough collapsed. It will tell you what it is, why it matters, how it works, give you an example, and leave you with something worth remembering.
No internet. No cloud. No waiting. Just answers.
The Format
Pocket Atlas answers every question in a consistent 5-part structure:
What it is — the honest one-sentence definition
Why it matters — why any human being should care
How it works — the mechanism, without the jargon
Simple example — something you can picture
Key takeaway — the thing worth remembering
Small enough to run on a MacBook, an iPhone via Ollama, or a Raspberry Pi — and explains the world better than most textbooks.
Files
| File | Size | Quantization | Best for |
|---|---|---|---|
pocket-atlas-q4_k_m.gguf |
493 MB | Q4_K_M | Ollama, phones, low RAM — recommended |
pocket-atlas-q8_0.gguf |
812 MB | Q8_0 | Higher quality, 8 GB+ RAM |
pocket-atlas-f16.gguf |
1.5 GB | F16 | Maximum quality, 16 GB+ RAM |
model.safetensors-* |
1.7 GB | BF16 | MLX / transformers / fine-tuning |
Quick Start
MLX (Apple Silicon — recommended)
pip install mlx-lm
from mlx_lm import load, generate
model, tokenizer = load("cetusian/pocket-atlas-0.8b")
messages = [
{"role": "system", "content": "You explain ideas clearly, warmly, and precisely. Use this format: What it is, Why it matters, How it works, Simple example, Key takeaway."},
{"role": "user", "content": "Explain the Fermi paradox."}
]
prompt = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True, enable_thinking=False)
response = generate(model, tokenizer, prompt=prompt, max_tokens=600, verbose=True)
Transformers
from transformers import AutoModelForCausalLM, AutoTokenizer
import torch
model_id = "cetusian/pocket-atlas-0.8b"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype=torch.bfloat16)
messages = [
{"role": "system", "content": "You explain ideas clearly, warmly, and precisely. Use this format: What it is, Why it matters, How it works, Simple example, Key takeaway."},
{"role": "user", "content": "Explain entropy."}
]
text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
inputs = tokenizer(text, return_tensors="pt")
out = model.generate(**inputs, max_new_tokens=600)
print(tokenizer.decode(out[0][inputs["input_ids"].shape[-1]:], skip_special_tokens=True))
Example Output
Prompt: Explain the Fermi paradox.
What It Is The Fermi paradox is the puzzling observation that, despite the high probability of extraterrestrial civilizations existing, we have found no evidence of them.
Why It Matters It forces us to confront deep questions: Is life rare? Do civilizations destroy themselves? Are we being ignored — or are we simply not listening hard enough?
How It Works Physicist Enrico Fermi reasoned: the universe is 13.8 billion years old, there are hundreds of billions of stars like our Sun, many with Earth-like planets — so where is everyone? The math says they should be everywhere. The silence says otherwise.
Simple Example Imagine a huge party where statistically thousands of people should be in the kitchen, but you walk in and it's completely empty. You start to wonder: did everyone leave early? Was there never a party? Are you the only one who showed up?
Key Takeaway The Fermi paradox isn't a proof that we're alone — it's a proof that something in our assumptions is wrong. Which assumption? That's the question that keeps astronomers up at night.
Prompting Guide
Pocket Atlas understands several modes:
# Standard explanation
"Explain [concept]."
# Explain like I'm 5
"Explain [concept] like I'm 5."
# Analogy only
"Explain [concept] using only an analogy."
# Misconceptions
"What do most people get wrong about [concept]?"
# Real-world applications
"Give 3 surprising real-world applications of [concept]."
Training Details
| Base model | unsloth/Qwen3.5-0.8B |
| Method | LoRA fine-tuning (PEFT) |
| Dataset | cetusian/atlas-pages |
| LoRA rank | 16 |
| LoRA alpha | 16 |
| Target modules | q, k, v, o, gate, up, down proj |
| Sequence length | 2048 |
| Batch size | 64 (2× A100 80GB, torchrun DDP) |
| Epochs | 1 |
| Learning rate | 2e-4 (cosine decay) |
| Optimizer | AdamW 8-bit |
| Precision | bf16 |
| Thinking mode | Disabled — direct answers only |
| Train loss | 2.147 |
Dataset Composition (~18k examples)
| Source | Count | What it teaches |
|---|---|---|
| Atlas Pages — 5-part explanations | ~6,400 | The house format: structured, warm, precise |
| arXiv abstracts | ~8,000 | Technical compression — dense research → plain language |
| XSum news summaries | ~3,000 | Radical brevity — one sentence, complete thought |
Performance
Tested on Apple M-series:
| Device | Framework | Speed | RAM |
|---|---|---|---|
| MacBook (Apple Silicon) | MLX | ~52 tok/s | ~1.6 GB |
Don't panic.
- Downloads last month
- 53
Quantized