Instructions to use TitleOS/Lightning-1.7B-Q8_0-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="TitleOS/Lightning-1.7B-Q8_0-GGUF", filename="lightning-1.7b-q8_0.gguf", )
output = llm( "Once upon a time,", max_tokens=512, echo=True ) print(output)
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0 # Run inference directly in the terminal: llama-cli -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0 # Run inference directly in the terminal: llama-cli -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
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 TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
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 TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
Use Docker
docker model run hf.co/TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
- LM Studio
- Jan
- vLLM
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "TitleOS/Lightning-1.7B-Q8_0-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "TitleOS/Lightning-1.7B-Q8_0-GGUF", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
- Ollama
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with Ollama:
ollama run hf.co/TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
- Unsloth Studio new
How to use TitleOS/Lightning-1.7B-Q8_0-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 TitleOS/Lightning-1.7B-Q8_0-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 TitleOS/Lightning-1.7B-Q8_0-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for TitleOS/Lightning-1.7B-Q8_0-GGUF to start chatting
- Docker Model Runner
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with Docker Model Runner:
docker model run hf.co/TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
- Lemonade
How to use TitleOS/Lightning-1.7B-Q8_0-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull TitleOS/Lightning-1.7B-Q8_0-GGUF:Q8_0
Run and chat with the model
lemonade run user.Lightning-1.7B-Q8_0-GGUF-Q8_0
List all available models
lemonade list
β‘ Lightning-1.7B
Lightning-1.7B is a high-efficiency utility model designed for edge computing and low-latency workflows. Finetuned from the powerful Qwen3-1.7B base upon the rich NousResearch Hermes-3 dataset, Lightning serves as a bridge between raw analytic logic and creative inference.
While it boasts improved capabilities in logic, Q/A, and coding compared to its base, its true strength lies in its enhanced creativity and utility functions. It is engineered to be the perfect "sidecar" modelβsmall enough to run on-device with minimal memory impact, yet smart enough to handle complex metadata generation tasks.
π Key Features
- Ultra-Lightweight: At 1.7B parameters, it runs efficiently on consumer hardware, laptops, and even mobile devices with minimal VRAM usage.
- Hermes-Powered Creativity: Leveraging the Hermes-3 dataset, Lightning moves beyond robotic responses, offering nuanced understanding for tasks that require a "human touch," such as summarizing tone or generating creative search queries.
- Utility Specialist: Specifically optimized for background tasks like tagging, title generation, and creating search inquiries from conversation context.
- Low Latency: Designed for speed, making it ideal for real-time applications where response time is critical.
π― Use Cases
Lightning-1.7B is best utilized not as a general chatbot, but as a specialized Analytic & Utility Engine:
- Conversation Auto-Titling: accurately summarizing long context windows into punchy, relevant titles.
- Search Query Generation: converting user intent or conversation history into optimized search engine queries.
- Onboard Tagging: analyzing text streams to apply metadata tags (e.g., sentiment, topic, urgency) locally without API calls.
- JSON Formatting: extracting structured data from unstructured text with higher reliability than standard small models.
π» Quickstart
You can run Lightning-1.7B using the transformers library.
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
model_name = "TitleOS/Lightning-1.7B"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(
model_name,
torch_dtype=torch.bfloat16,
device_map="auto"
)
# Example: Generating a search query from a user thought
prompt = """<|im_start|>system
You are a utility AI. Generate a specific Google search query based on the user's confused thought.<|im_end|>
<|im_start|>user
I remember there was this movie about a guy who lives in a computer but doesn't know it, and takes a red pill?<|im_end|>
<|im_start|>assistant
"""
inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
outputs = model.generate(
**inputs,
max_new_tokens=64,
temperature=0.3,
do_sample=True
)
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
# Output: "movie guy lives in computer takes red pill matrix plot"
Merged FP16 and Quantizations:
FP16: https://huggingface.co/TitleOS/Lightning-1.7B
Q4_K_M:https://huggingface.co/TitleOS/Lightning-1.7B-Q4_K_M-GGUF
Q8: https://huggingface.co/TitleOS/Lightning-1.7B-Q8_0-GGUF
π Performance & Benchmarks
Lightning-1.7B punches above its weight class. By sacrificing some breadth of general world knowledge found in larger models, it focuses density on instruction following and creative interpretation.
Logic & Coding: Slight improvement over base Qwen3-1.7B.
Creativity & Nuance: Significant improvement due to Hermes-3 fine-tuning.
Memory Footprint: ~3.5GB VRAM (in FP16), <2GB (in 4-bit/8-bit quant).
π§ Training Details
Base Model: Qwen3-1.7B
Dataset: NousResearch/Hermes-3-Dataset
Fine-tuning Approach: Lora Alpha 32/Lora R 16 focused on preserving the base model's speed while injecting the "Hermes" personality and instruction-following capabilities.
β οΈ Limitations
Knowledge Cutoff: As a small model, Lightning does not possess vast encyclopedic knowledge. It is best used for processing the text given to it in the context window rather than retrieving facts.
Complex Reasoning: While logic is improved, multi-step mathematical reasoning or complex coding challenges should be offloaded to larger models (7B+).
π License
This model is released under the Mozilla Public License 2.0 (MPL-2.0).
Created by TitleOS.
- Downloads last month
- 6
8-bit