Instructions to use stukenov/sozkz-core-llama-30m-kk-base-v1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use stukenov/sozkz-core-llama-30m-kk-base-v1 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="stukenov/sozkz-core-llama-30m-kk-base-v1")# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("stukenov/sozkz-core-llama-30m-kk-base-v1") model = AutoModelForCausalLM.from_pretrained("stukenov/sozkz-core-llama-30m-kk-base-v1", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use stukenov/sozkz-core-llama-30m-kk-base-v1 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "stukenov/sozkz-core-llama-30m-kk-base-v1" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "stukenov/sozkz-core-llama-30m-kk-base-v1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/stukenov/sozkz-core-llama-30m-kk-base-v1
- SGLang
How to use stukenov/sozkz-core-llama-30m-kk-base-v1 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 "stukenov/sozkz-core-llama-30m-kk-base-v1" \ --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": "stukenov/sozkz-core-llama-30m-kk-base-v1", "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 "stukenov/sozkz-core-llama-30m-kk-base-v1" \ --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": "stukenov/sozkz-core-llama-30m-kk-base-v1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use stukenov/sozkz-core-llama-30m-kk-base-v1 with Docker Model Runner:
docker model run hf.co/stukenov/sozkz-core-llama-30m-kk-base-v1
Kazakh LLaMA 30M (Soz)
A LLaMA-architecture language model trained from scratch on Kazakh text, featuring modern design choices: RoPE positional embeddings, SwiGLU activations, RMSNorm, and no bias terms.
Overview
| Property | Value |
|---|---|
| Parameters | ~30M |
| Architecture | LLaMA (RoPE, SwiGLU, RMSNorm, no bias) |
| Vocab size | 50,257 |
| Hidden dim | 384 |
| Layers | 8 |
| Attention heads | 6 |
| Intermediate dim | 1,024 |
| Tied embeddings | Yes |
| Training data | kazakh-clean-pretrain (~80M tokens) |
| Epochs | 8 |
| Learning rate | 6e-4 |
| Weight decay | 0.05 |
| Tokenizer | kazakh-gpt2-50k |
| License | Apache 2.0 |
Design
This model serves as a modern architecture comparison against the GPT-2 30M variant trained on the same data. The LLaMA architecture incorporates several advances: Rotary Position Embeddings (RoPE), SwiGLU feed-forward networks, RMSNorm instead of LayerNorm, and removal of bias terms.
Usage
from transformers import AutoModelForCausalLM, AutoTokenizer
tokenizer = AutoTokenizer.from_pretrained("stukenov/kazakh-gpt2-50k")
model = AutoModelForCausalLM.from_pretrained("stukenov/kazakh-llama-30m")
input_ids = tokenizer("Қазақстан — ", return_tensors="pt").input_ids
output = model.generate(input_ids, max_new_tokens=50, do_sample=True, temperature=0.8)
print(tokenizer.decode(output[0], skip_special_tokens=True))
Training Details
- Trained from scratch using the Soz training pipeline
- Optimizer: AdamW with weight decay 0.05
- Precision: bfloat16
- Hardware: NVIDIA A10 GPUs
Project
Part of the Soz — Kazakh Language Models project, a research effort to build open-source language models for Kazakh.
Citation
@misc{tukenov2026soz,
title={Soz: Small Language Models for Kazakh},
author={Tukenov, Saken},
year={2026},
url={https://huggingface.co/stukenov/kazakh-llama-30m}
}
License
Apache 2.0
- Downloads last month
- -