Image-Text-to-Text
GGUF
alpie
169pi
quantized
local-inference
vision-language
multimodal
reasoning
coding
llama.cpp
9b
apache-2.0
conversational
Instructions to use 169Pi/Alpie_Seed_GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use 169Pi/Alpie_Seed_GGUF 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 169Pi/Alpie_Seed_GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf 169Pi/Alpie_Seed_GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf 169Pi/Alpie_Seed_GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf 169Pi/Alpie_Seed_GGUF: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 169Pi/Alpie_Seed_GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf 169Pi/Alpie_Seed_GGUF:Q4_K_M
Use Docker
docker model run hf.co/169Pi/Alpie_Seed_GGUF:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use 169Pi/Alpie_Seed_GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "169Pi/Alpie_Seed_GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "169Pi/Alpie_Seed_GGUF", "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/169Pi/Alpie_Seed_GGUF:Q4_K_M
- Ollama
How to use 169Pi/Alpie_Seed_GGUF with Ollama:
ollama run hf.co/169Pi/Alpie_Seed_GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use 169Pi/Alpie_Seed_GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 169Pi/Alpie_Seed_GGUF:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "169Pi/Alpie_Seed_GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use 169Pi/Alpie_Seed_GGUF with Docker Model Runner:
docker model run hf.co/169Pi/Alpie_Seed_GGUF:Q4_K_M
- Lemonade
How to use 169Pi/Alpie_Seed_GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull 169Pi/Alpie_Seed_GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Alpie_Seed_GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use 169Pi/Alpie_Seed_GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 169Pi/Alpie_Seed_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 169Pi/Alpie_Seed_GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use 169Pi/Alpie_Seed_GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 169Pi/Alpie_Seed_GGUF:Q4_K_M
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 "169Pi/Alpie_Seed_GGUF:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,383 +1,139 @@
|
|
| 1 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
tags:
|
| 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 |
-
With multiple quantization variants, competitive WikiText-2 perplexity results, and real-world inference measurements, Alpie Seed is designed for developers, researchers, and enthusiasts exploring locally deployed AI.
|
| 30 |
-
|
| 31 |
-
---
|
| 32 |
-
|
| 33 |
-
## Highlights
|
| 34 |
-
|
| 35 |
-
| Feature | Result |
|
| 36 |
-
|---|---|
|
| 37 |
-
| Model scale | 8.95B parameters |
|
| 38 |
-
| Mobile inference | iPhone 17 Pro tested |
|
| 39 |
-
| iPhone generation speed | **9.59 tokens/sec** |
|
| 40 |
-
| Mac M2 generation speed | ~14.1 tokens/sec |
|
| 41 |
-
| Lowest reported PPL | **8.8921 (Q4)** |
|
| 42 |
-
| Quantization options | Q2, Q3, Q4 |
|
| 43 |
-
| Model format | GGUF |
|
| 44 |
-
| Inference ecosystem | llama.cpp |
|
| 45 |
-
|
| 46 |
-
### What makes Alpie Seed interesting?
|
| 47 |
-
|
| 48 |
-
- **AI on smartphones:** Successfully executed and benchmarked on an iPhone 17 Pro using Apple Metal.
|
| 49 |
-
- **Local inference:** Run supported model configurations directly on your device after downloading the weights.
|
| 50 |
-
- **Flexible quantization:** Select Q2, Q3, or Q4 according to your available memory.
|
| 51 |
-
- **Competitive language modeling:** Q4 records approximately 1.43% lower mean perplexity than the Qwen Q4 reference in our reported WikiText-2 evaluation.
|
| 52 |
-
- **Developer-friendly:** GGUF distribution for integration with compatible local inference environments.
|
| 53 |
-
|
| 54 |
-
---
|
| 55 |
-
|
| 56 |
-
# 1. Model Information
|
| 57 |
-
|
| 58 |
-
| Attribute | Details |
|
| 59 |
-
|---|---|
|
| 60 |
-
| Model name | Alpie Seed |
|
| 61 |
-
| Organization | 169Pi |
|
| 62 |
-
| Model family | Alpie |
|
| 63 |
-
| Parameter count | Approximately 8.95B |
|
| 64 |
-
| Base model | Qwen3.5-9B |
|
| 65 |
-
| Model architecture | Qwen3.5-based |
|
| 66 |
-
| Distribution format | GGUF |
|
| 67 |
-
| Quantization variants | Q2_K, Q3_K_M, Q4_K_M |
|
| 68 |
-
| Primary inference engine | llama.cpp |
|
| 69 |
-
| Primary evaluation dataset | WikiText-2 |
|
| 70 |
-
| Primary evaluation metric | Mean perplexity |
|
| 71 |
-
| Intended deployment | Desktop and compatible mobile hardware |
|
| 72 |
-
|
| 73 |
-
# 2. Run AI Locally: Desktop to Smartphone
|
| 74 |
-
|
| 75 |
-
One of the primary objectives of Alpie Seed is to make language-model inference accessible on consumer hardware.
|
| 76 |
-
|
| 77 |
-
We evaluated the Q4_K_M configuration across three different hardware environments, including an iPhone 17 Pro.
|
| 78 |
-
|
| 79 |
-
## Hardware performance
|
| 80 |
-
|
| 81 |
-
| Device | Backend | Quantization | Prompt processing | Generation |
|
| 82 |
-
|---|---|---|---:|---:|
|
| 83 |
-
| iPhone 17 Pro | Apple Metal | Q4_K_M | 230.65 tok/s | **9.59 tok/s** |
|
| 84 |
-
| Mac M2 (16 GB) | Apple Metal | Q4_K_M | ~130 tok/s | **~14.1 tok/s** |
|
| 85 |
-
| Windows CPU | CPU | Q4_K_M | 6.40 tok/s | 2.66 tok/s |
|
| 86 |
-
|
| 87 |
-
### iPhone 17 Pro: On-device inference
|
| 88 |
-
|
| 89 |
-
**A model with approximately 8.95 billion parameters, running locally on a smartphone.**
|
| 90 |
-
|
| 91 |
-
Reported benchmark configuration:
|
| 92 |
-
|
| 93 |
-
| Parameter | Value |
|
| 94 |
-
|---|---|
|
| 95 |
-
| Device | iPhone 17 Pro |
|
| 96 |
-
| Backend | Apple Metal |
|
| 97 |
-
| Quantization | Q4_K_M |
|
| 98 |
-
| Model artifact size | 5.62 GB (reported) |
|
| 99 |
-
| Peak memory | 7 GB |
|
| 100 |
-
| GPU layers | 99 |
|
| 101 |
-
| Flash Attention | Enabled |
|
| 102 |
-
| Prompt tokens | 512 |
|
| 103 |
-
| Generation tokens | 128 |
|
| 104 |
-
| Repetitions | 3 |
|
| 105 |
-
| Prompt processing | 230.65 tokens/sec |
|
| 106 |
-
| Token generation | 9.59 tokens/sec |
|
| 107 |
-
| Total test time | 47 seconds |
|
| 108 |
-
|
| 109 |
-
This demonstrates practical local inference on modern mobile hardware, using hardware acceleration rather than relying on a remote inference service.
|
| 110 |
-
|
| 111 |
-
### Mac M2: Apple Silicon inference
|
| 112 |
-
|
| 113 |
-
| Parameter | Value |
|
| 114 |
-
|---|---|
|
| 115 |
-
| Device | Mac M2, 16 GB |
|
| 116 |
-
| Backend | Apple Metal |
|
| 117 |
-
| Quantization | Q4_K_M |
|
| 118 |
-
| Model size | Approximately 5.23 GiB |
|
| 119 |
-
| Memory usage | Approximately 5.5 GB |
|
| 120 |
-
| Prompt processing | Approximately 130 tokens/sec |
|
| 121 |
-
| Generation | Approximately 14.1 tokens/sec |
|
| 122 |
-
|
| 123 |
-
### Windows: CPU inference
|
| 124 |
-
|
| 125 |
-
| Parameter | Value |
|
| 126 |
-
|---|---|
|
| 127 |
-
| Backend | CPU |
|
| 128 |
-
| Quantization | Q4_K_M |
|
| 129 |
-
| Model size | 5.24 GB |
|
| 130 |
-
| Memory usage | Approximately 7 GB |
|
| 131 |
-
| GPU layers | 0 |
|
| 132 |
-
| Prompt processing | 6.40 tokens/sec |
|
| 133 |
-
| Generation | 2.66 tokens/sec |
|
| 134 |
-
| Generation tokens | 128 |
|
| 135 |
-
| Repetitions | 1 |
|
| 136 |
-
|
| 137 |
-
### Benchmark interpretation
|
| 138 |
-
|
| 139 |
-
These results demonstrate that Alpie Seed can operate across different hardware environments, including:
|
| 140 |
-
|
| 141 |
-
- Apple Silicon with Metal acceleration.
|
| 142 |
-
- Modern iPhone hardware with Metal acceleration.
|
| 143 |
-
- CPU-only Windows environments.
|
| 144 |
-
|
| 145 |
-
The reported speeds are hardware-specific measurements and should not be interpreted as guaranteed performance on other devices.
|
| 146 |
-
|
| 147 |
-
Prompt processing and token generation are separate measurements. They should not be directly compared as equivalent throughput metrics.
|
| 148 |
|
| 149 |
---
|
| 150 |
|
| 151 |
-
|
| 152 |
|
| 153 |
-
|
| 154 |
|
| 155 |
-
|
| 156 |
-
|
| 157 |
-
|
| 158 |
-
|
| 159 |
-
|
| 160 |
|
| 161 |
-
##
|
| 162 |
-
|
| 163 |
-
**Q4_K_M — Recommended starting point**
|
| 164 |
-
|
| 165 |
-
Choose Q4 when your device has sufficient available memory and you want a higher-precision quantized representation.
|
| 166 |
-
|
| 167 |
-
**Q3_K_M — Memory-conscious deployment**
|
| 168 |
-
|
| 169 |
-
Choose Q3 when you need to reduce memory requirements while retaining a more substantial representation than Q2.
|
| 170 |
-
|
| 171 |
-
**Q2_K — Lower-memory deployment**
|
| 172 |
-
|
| 173 |
-
Choose Q2 when memory constraints are your primary consideration.
|
| 174 |
-
|
| 175 |
-
These are indicative configuration recommendations, not guaranteed minimum RAM requirements. Actual requirements depend on model file size, context length, KV cache, inference backend, operating-system overhead, and available memory.
|
| 176 |
-
|
| 177 |
-
The iPhone 17 Pro result specifically demonstrates Q4_K_M execution. The Q3 and Q2 mobile memory tiers are recommendations rather than independently verified device benchmarks.
|
| 178 |
-
|
| 179 |
-
---
|
| 180 |
|
| 181 |
-
|
| 182 |
|
| 183 |
-
|
|
|
|
|
|
|
| 184 |
|
| 185 |
-
|
| 186 |
|
| 187 |
-
|
| 188 |
|
| 189 |
-
|
| 190 |
|
| 191 |
-
|
| 192 |
-
|---|---|---:|
|
| 193 |
-
| Qwen reference | BF16 | 9.0251 |
|
| 194 |
-
| Alpie Seed | BF16 | **9.0065** |
|
| 195 |
-
| Qwen reference | Q4 | 9.0215 |
|
| 196 |
-
| Alpie Seed | Q4 | **8.8921** |
|
| 197 |
|
| 198 |
-
##
|
| 199 |
|
| 200 |
-
|
| 201 |
-
|---|---:|
|
| 202 |
-
| Qwen Q4 PPL | 9.0215 |
|
| 203 |
-
| Alpie Seed Q4 PPL | 8.8921 |
|
| 204 |
-
| Absolute PPL difference | 0.1294 |
|
| 205 |
-
| Relative PPL reduction | **1.43%** |
|
| 206 |
|
| 207 |
-
|
| 208 |
-
|
| 209 |
-
### BF16 comparison
|
| 210 |
-
|
| 211 |
-
| Metric | Value |
|
| 212 |
-
|---|---:|
|
| 213 |
-
| Qwen BF16 PPL | 9.0251 |
|
| 214 |
-
| Alpie Seed BF16 PPL | 9.0065 |
|
| 215 |
-
| Absolute PPL difference | 0.0186 |
|
| 216 |
-
| Relative PPL reduction | **0.21%** |
|
| 217 |
-
|
| 218 |
-
Alpie Seed BF16 also records slightly lower mean perplexity than the Qwen BF16 reference.
|
| 219 |
-
|
| 220 |
-
### What do these results indicate?
|
| 221 |
-
|
| 222 |
-
The results show competitive language-modeling performance on WikiText-2.
|
| 223 |
-
|
| 224 |
-
Notably, the Alpie Seed Q4 configuration achieves the lowest mean perplexity among the four reported evaluation artifacts.
|
| 225 |
-
|
| 226 |
-
This is an interesting result because quantization reduces the numerical precision used to represent model weights. However, quantization does not necessarily produce a monotonically increasing perplexity across different model artifacts.
|
| 227 |
-
|
| 228 |
-
**Important evaluation considerations:**
|
| 229 |
-
|
| 230 |
-
- The Alpie BF16 reference checkpoint may not be identical to the source checkpoint used to generate the Q4 GGUF.
|
| 231 |
-
- Cross-model perplexity comparisons should account for tokenizer differences, preprocessing, context length, and evaluation methodology.
|
| 232 |
-
- These results represent the reported WikiText-2 evaluation and do not establish universal superiority.
|
| 233 |
-
- Perplexity does not independently measure reasoning, instruction following, coding, factual accuracy, or general task performance.
|
| 234 |
-
|
| 235 |
-
The results should be interpreted as evidence of competitive language-modeling performance under the reported evaluation conditions.
|
| 236 |
-
|
| 237 |
-
---
|
| 238 |
-
|
| 239 |
-
# 5. Getting Started
|
| 240 |
-
|
| 241 |
-
Alpie Seed GGUF is intended to work with compatible versions of llama.cpp.
|
| 242 |
-
|
| 243 |
-
## Step 1: Install the Hugging Face CLI
|
| 244 |
-
|
| 245 |
-
```bash
|
| 246 |
pip install -U huggingface_hub
|
|
|
|
| 247 |
```
|
| 248 |
|
| 249 |
-
|
| 250 |
-
|
| 251 |
-
Download the repository's GGUF artifacts:
|
| 252 |
-
|
| 253 |
-
```bash
|
| 254 |
-
hf download 169Pi/Alpie_Seed_GGUF \
|
| 255 |
-
--include "*.gguf" \
|
| 256 |
-
--local-dir ./Alpie_Seed
|
| 257 |
-
```
|
| 258 |
-
|
| 259 |
-
Alternatively, select an individual quantization file from the repository.
|
| 260 |
-
|
| 261 |
-
## Step 3: Install llama.cpp
|
| 262 |
-
|
| 263 |
-
Follow the official installation instructions:
|
| 264 |
-
|
| 265 |
-
https://github.com/ggml-org/llama.cpp
|
| 266 |
-
|
| 267 |
-
## Step 4: Run Alpie Seed
|
| 268 |
|
| 269 |
-
```
|
| 270 |
llama-cli \
|
| 271 |
-
|
| 272 |
-
|
| 273 |
```
|
| 274 |
|
| 275 |
-
|
| 276 |
-
|
| 277 |
-
You can now interact with Alpie Seed locally through the terminal.
|
| 278 |
-
|
| 279 |
-
## Mobile deployment
|
| 280 |
-
|
| 281 |
-
Alpie Seed can also be used in compatible mobile inference applications built around llama.cpp or equivalent GGUF-compatible runtimes.
|
| 282 |
-
|
| 283 |
-
For mobile devices:
|
| 284 |
-
|
| 285 |
-
- Select a quantization appropriate for available memory.
|
| 286 |
-
- Ensure that the inference application supports the model architecture.
|
| 287 |
-
- Use hardware acceleration where supported.
|
| 288 |
-
- Adjust context length according to device memory.
|
| 289 |
-
- For multimodal configurations, ensure that the matching projector is loaded.
|
| 290 |
|
| 291 |
-
|
| 292 |
|
| 293 |
-
|
| 294 |
-
|
| 295 |
-
# 6. Multimodal Model Components
|
| 296 |
-
|
| 297 |
-
Where provided in the repository, multimodal configurations may include separate projector artifacts.
|
| 298 |
-
|
| 299 |
-
For vision-language inference, the model and its corresponding multimodal projector must be compatible and loaded together.
|
| 300 |
-
|
| 301 |
-
A standalone text GGUF should not be assumed to support image or video input.
|
| 302 |
|
| 303 |
-
|
| 304 |
|
| 305 |
-
|
| 306 |
-
|
| 307 |
-
# 7. Intended Use Cases
|
| 308 |
|
| 309 |
-
|
| 310 |
|
| 311 |
-
|
| 312 |
-
- On-device language-model inference.
|
| 313 |
-
- Offline-capable AI applications.
|
| 314 |
-
- Mobile AI experimentation.
|
| 315 |
-
- Desktop-based local inference.
|
| 316 |
-
- Quantized model evaluation.
|
| 317 |
-
- Private local text-processing workflows.
|
| 318 |
-
- Research into model quantization and deployment.
|
| 319 |
|
| 320 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 321 |
|
| 322 |
-
|
|
|
|
| 323 |
|
| 324 |
-
#
|
| 325 |
|
| 326 |
-
-
|
| 327 |
-
- Actual memory consumption depends on context length, KV cache, backend, and runtime configuration.
|
| 328 |
-
- Performance varies across processors, GPUs, memory bandwidth, and inference engines.
|
| 329 |
-
- Mobile operating systems may restrict available memory.
|
| 330 |
-
- Recommended Q2/Q3/Q4 memory tiers are estimates, not device-specific guarantees.
|
| 331 |
-
- The reported perplexity evaluation is limited to WikiText-2 and should not be treated as a comprehensive model capability assessment.
|
| 332 |
-
- Multimodal functionality requires compatible projector components and runtime support.
|
| 333 |
-
|
| 334 |
-
---
|
| 335 |
-
|
| 336 |
-
# 9. About 169Pi
|
| 337 |
-
|
| 338 |
-
**169Pi is developing AI systems across multiple layers of the AI technology stack.**
|
| 339 |
-
|
| 340 |
-
Our work spans:
|
| 341 |
-
|
| 342 |
-
- Data and knowledge engineering.
|
| 343 |
-
- Language-model development and evaluation.
|
| 344 |
-
- Reasoning and agentic capabilities.
|
| 345 |
-
- AI orchestration and execution.
|
| 346 |
-
- Application-level AI systems.
|
| 347 |
-
|
| 348 |
-
Alpie is part of our effort to develop and deploy practical AI models and systems.
|
| 349 |
-
|
| 350 |
-
Alpie Seed GGUF represents our focus on making language-model inference more accessible across different hardware environments, including personal computers and mobile devices.
|
| 351 |
-
|
| 352 |
-
We believe AI should not be limited to large-scale cloud infrastructure. Local inference opens opportunities for developers to experiment, build, and deploy AI applications directly on their own hardware.
|
| 353 |
-
|
| 354 |
-
---
|
| 355 |
-
|
| 356 |
-
# 10. Acknowledgements
|
| 357 |
-
|
| 358 |
-
We acknowledge:
|
| 359 |
-
|
| 360 |
-
- The Qwen team for the underlying model family.
|
| 361 |
-
- The llama.cpp community for its contributions to efficient GGUF inference.
|
| 362 |
-
- The Hugging Face community for providing model distribution and developer infrastructure.
|
| 363 |
-
|
| 364 |
-
---
|
| 365 |
-
|
| 366 |
-
# 11. License and Usage
|
| 367 |
-
|
| 368 |
-
Please refer to the repository's `LICENSE` file for the applicable usage and redistribution terms.
|
| 369 |
-
|
| 370 |
-
The underlying base model's licensing conditions must also be respected.
|
| 371 |
-
|
| 372 |
-
---
|
| 373 |
|
| 374 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 375 |
|
| 376 |
-
|
| 377 |
|
| 378 |
-
|
| 379 |
|
| 380 |
-
|
| 381 |
|
| 382 |
-
**
|
| 383 |
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
base_model: 169Pi/Alpie_seed
|
| 4 |
+
library_name: gguf
|
| 5 |
+
pipeline_tag: image-text-to-text
|
| 6 |
tags:
|
| 7 |
+
- alpie
|
| 8 |
+
- 169pi
|
| 9 |
+
- gguf
|
| 10 |
+
- quantized
|
| 11 |
+
- local-inference
|
| 12 |
+
- vision-language
|
| 13 |
+
- multimodal
|
| 14 |
+
- reasoning
|
| 15 |
+
- coding
|
| 16 |
+
- llama.cpp
|
| 17 |
+
- 9b
|
| 18 |
+
- apache-2.0
|
| 19 |
---
|
| 20 |
|
| 21 |
+
<div align="center">
|
| 22 |
|
| 23 |
+
<h1>🌱 Alpie Seed 9B GGUF</h1>
|
| 24 |
|
| 25 |
+
<p><b>Run Alpie Seed locally.</b></p>
|
| 26 |
|
| 27 |
+
<p>
|
| 28 |
+
<a href="https://huggingface.co/169Pi/Alpie_seed"><img src="https://img.shields.io/badge/🤗_Primary_Model-Alpie_Seed_9B-FFD21E?style=for-the-badge&labelColor=1a1a2e" alt="Primary model"></a>
|
| 29 |
+
<a href="https://huggingface.co/169Pi/Alpie_Seed_GGUF"><img src="https://img.shields.io/badge/📦_GGUF-2/3/4--bit-7C3AED?style=for-the-badge&labelColor=1a1a2e" alt="GGUF"></a>
|
| 30 |
+
<a href="https://ollama.com/169pi/alpie-core"><img src="https://img.shields.io/badge/🦙_Ollama-169pi/alpie--core-00C2A8?style=for-the-badge&labelColor=1a1a2e" alt="Ollama"></a>
|
| 31 |
+
</p>
|
| 32 |
|
| 33 |
+
<p>
|
| 34 |
+
<img src="https://img.shields.io/badge/License-Apache_2.0-22C55E?style=flat-square" alt="license">
|
| 35 |
+
<img src="https://img.shields.io/badge/Params-9B-6366F1?style=flat-square" alt="params">
|
| 36 |
+
<img src="https://img.shields.io/badge/Quantization-2--bit_·_3--bit_·_4--bit-F59E0B?style=flat-square" alt="quantization">
|
| 37 |
+
<img src="https://img.shields.io/badge/Runtime-llama.cpp-0EA5E9?style=flat-square" alt="runtime">
|
| 38 |
+
<img src="https://img.shields.io/badge/Modality-Text_·_Image-EC4899?style=flat-square" alt="modality">
|
| 39 |
+
</p>
|
| 40 |
|
| 41 |
+
<p>
|
| 42 |
+
<a href="https://github.com/169Pi"><img src="https://img.shields.io/badge/GitHub-169Pi-181717?style=flat-square&logo=github" alt="GitHub"></a>
|
| 43 |
+
<a href="https://www.linkedin.com/company/169pi"><img src="https://img.shields.io/badge/LinkedIn-169pi-0A66C2?style=flat-square&logo=linkedin&logoColor=white" alt="LinkedIn"></a>
|
| 44 |
+
<a href="https://www.instagram.com/169pi.ai/"><img src="https://img.shields.io/badge/Instagram-169pi.ai-E4405F?style=flat-square&logo=instagram&logoColor=white" alt="Instagram"></a>
|
| 45 |
+
<a href="https://www.youtube.com/@169pi"><img src="https://img.shields.io/badge/YouTube-@169pi-FF0000?style=flat-square&logo=youtube&logoColor=white" alt="YouTube"></a>
|
| 46 |
+
<a href="https://x.com/169Pi_ai"><img src="https://img.shields.io/badge/X-@169Pi__ai-000000?style=flat-square&logo=x&logoColor=white" alt="X"></a>
|
| 47 |
+
</p>
|
| 48 |
|
| 49 |
+
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 50 |
|
| 51 |
---
|
| 52 |
|
| 53 |
+
This repository provides GGUF quantized versions of **Alpie Seed 9B**, the open-weight vision-language model developed by **169Pi AI**. Built for local deployment, these releases make Alpie Seed available in multiple quantization levels, allowing developers and researchers to explore different trade-offs between model size, memory requirements, and inference quality.
|
| 54 |
|
| 55 |
+
## Alpie Seed GGUF Highlights
|
| 56 |
|
| 57 |
+
- Based on [Alpie Seed 9B](https://huggingface.co/169Pi/Alpie_seed), approximately 9B parameters.
|
| 58 |
+
- **2-bit, 3-bit, and 4-bit** quantization options.
|
| 59 |
+
- Designed for local inference, including desktop, workstation, and mobile hardware.
|
| 60 |
+
- Reasoning, coding, and multimodal capabilities inherited from the base model.
|
| 61 |
+
- Apache 2.0 license.
|
| 62 |
|
| 63 |
+
## Quantization Formats
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 64 |
|
| 65 |
+
Different quantization levels provide different trade-offs. The best choice depends on available memory, hardware, context length, and the requirements of the application.
|
| 66 |
|
| 67 |
+
- **2-bit**: lowest memory footprint among the provided formats.
|
| 68 |
+
- **3-bit**: intermediate memory and quality trade-off.
|
| 69 |
+
- **4-bit**: higher-fidelity quantized option.
|
| 70 |
|
| 71 |
+
Actual file sizes and memory requirements depend on the specific GGUF variant and runtime configuration. Refer to the repository's file list for the available artifacts.
|
| 72 |
|
| 73 |
+
## Capabilities
|
| 74 |
|
| 75 |
+
Alpie Seed's capabilities include multi-step reasoning, mathematical problem solving, code generation, explanation and debugging, image understanding and visual reasoning, OCR, chart and document tasks, and long-context use (262K native context in the base model, subject to runtime and memory).
|
| 76 |
|
| 77 |
+
Multimodal and extended-context functionality depends on the compatibility of the selected runtime and the required model assets. A GGUF language-model file alone should not be assumed to provide every vision or video capability.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 78 |
|
| 79 |
+
## Quickstart
|
| 80 |
|
| 81 |
+
Install the Hugging Face CLI and download the repository:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 82 |
|
| 83 |
+
```shell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 84 |
pip install -U huggingface_hub
|
| 85 |
+
hf download 169Pi/Alpie_Seed_GGUF --local-dir ./Alpie_Seed_GGUF
|
| 86 |
```
|
| 87 |
|
| 88 |
+
Select the quantized file that matches your available memory and intended runtime. For a compatible GGUF runtime such as llama.cpp, a basic text-generation example is:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 89 |
|
| 90 |
+
```shell
|
| 91 |
llama-cli \
|
| 92 |
+
-m <path-to-model.gguf> \
|
| 93 |
+
-p "Explain the difference between supervised fine-tuning and reinforcement learning."
|
| 94 |
```
|
| 95 |
|
| 96 |
+
For multimodal inference, use a compatible runtime build and the corresponding vision components or companion files required by the model. Check the repository files and runtime documentation for the supported configuration.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 97 |
|
| 98 |
+
<br>
|
| 99 |
|
| 100 |
+
<div align="center">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 101 |
|
| 102 |
+
<img src="https://img.shields.io/badge/⚡_LOCAL_INFERENCE-7C3AED?style=for-the-badge" alt="Local inference">
|
| 103 |
|
| 104 |
+
</div>
|
|
|
|
|
|
|
| 105 |
|
| 106 |
+
## Local Inference
|
| 107 |
|
| 108 |
+
Alpie Seed has been tested in quantized offline inference environments across desktop, workstation, and mobile hardware. The following are representative hardware measurements, not universal performance guarantees. 🏆 marks the fastest result in each column.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 109 |
|
| 110 |
+
| Hardware | Prompt processing | Generation |
|
| 111 |
+
|:---|:---:|:---:|
|
| 112 |
+
| 🍎 Mac M2, 16 GB |  |  |
|
| 113 |
+
| 🎮 NVIDIA RTX PRO 4500 |  🏆 |  🏆 |
|
| 114 |
+
| 📱 iPhone 17 Pro |  |  |
|
| 115 |
+
| 📱 Samsung Galaxy Z Flip8 |  |  |
|
| 116 |
+
| 💻 Windows CPU-only |  |  |
|
| 117 |
|
| 118 |
+
* Results were obtained under different device and runtime configurations. They should not be compared directly without accounting for differences in prompt length, generation length, context settings, memory reporting, and inference implementation.
|
| 119 |
+
* For benchmark accuracy and the full model evaluation, refer to the [primary Alpie Seed model card](https://huggingface.co/169Pi/Alpie_seed).
|
| 120 |
|
| 121 |
+
## Intended Use and Limitations
|
| 122 |
|
| 123 |
+
The GGUF releases are intended for local experimentation and research, offline and private on-device workflows, coding and reasoning assistants, multimodal application development where supported by the runtime, and evaluation of quantization and deployment trade-offs.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 124 |
|
| 125 |
+
- Quantization can affect model quality and output consistency.
|
| 126 |
+
- Performance varies significantly with hardware and runtime configuration.
|
| 127 |
+
- Long-context capability depends on runtime support and available memory.
|
| 128 |
+
- Vision and video capabilities require compatible multimodal runtime support and the necessary model assets.
|
| 129 |
+
- Local deployment does not remove the need to validate outputs, especially in high-impact applications.
|
| 130 |
|
| 131 |
+
## License
|
| 132 |
|
| 133 |
+
Released under the Apache License 2.0, consistent with the primary Alpie Seed model.
|
| 134 |
|
| 135 |
+
<div align="center">
|
| 136 |
|
| 137 |
+
**Developed by 169Pi AI** 🌱 · [Primary model](https://huggingface.co/169Pi/Alpie_seed) · [GGUF repository](https://huggingface.co/169Pi/Alpie_Seed_GGUF) · [GitHub](https://github.com/169Pi) · [LinkedIn](https://www.linkedin.com/company/169pi) · [Instagram](https://www.instagram.com/169pi.ai/) · [YouTube](https://www.youtube.com/@169pi) · [X](https://x.com/169Pi_ai) · [Ollama](https://ollama.com/169pi/alpie-core)
|
| 138 |
|
| 139 |
+
</div>
|