Instructions to use vrishv/Viveka-34M with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use vrishv/Viveka-34M with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="vrishv/Viveka-34M")# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("vrishv/Viveka-34M") model = AutoModelForCausalLM.from_pretrained("vrishv/Viveka-34M", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use vrishv/Viveka-34M with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "vrishv/Viveka-34M" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "vrishv/Viveka-34M", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/vrishv/Viveka-34M
- SGLang
How to use vrishv/Viveka-34M 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 "vrishv/Viveka-34M" \ --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": "vrishv/Viveka-34M", "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 "vrishv/Viveka-34M" \ --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": "vrishv/Viveka-34M", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use vrishv/Viveka-34M with Docker Model Runner:
docker model run hf.co/vrishv/Viveka-34M
Viveka-34M (विवेक)
Viveka is Sanskrit for discernment: telling what is right from what only looks right.
A small English language model trained from scratch (its own tokenizer, random start) on free Colab T4 GPUs. Its strength is judging: given a few versions of a sentence, it tells which one makes the most sense.
Model
| Design | Llama-style (rotary positions, SwiGLU, RMSNorm), 8 layers, width 512, 33.9M numbers |
| Tokenizer | its own byte-level BPE, 16,000 word pieces |
| Context | 256 word pieces |
| Training | 45 minutes from scratch, then 150 more minutes at a lower learning rate (one T4 each) |
| Stored as | half precision, 68 MB |
Training text
| Source | Licence |
|---|---|
| FineWeb-Edu (educational web pages) | ODC-BY |
| Project Gutenberg books | public domain |
| English Wikipedia | CC BY-SA |
| IAM handwriting texts (first 45 minutes only, 10%) | non-commercial research |
Because of the IAM texts, this model is non-commercial (CC BY-NC 4.0).
Results
On 20 fresh everyday sentences that no version trained on (lower is better):
| Perplexity per word | Sense test | |
|---|---|---|
| First Viveka-34M | 233.8 | 12 / 12 |
| This version | 176.9 | 12 / 12 |
The sense test asks it to pick the sensible sentence ("She drank a glass of cold water." over "...cold window.").
Use
from transformers import AutoTokenizer, AutoModelForCausalLM
tok = AutoTokenizer.from_pretrained('vrishv/Viveka-34M')
lm = AutoModelForCausalLM.from_pretrained('vrishv/Viveka-34M', dtype='float32')
x = tok('The cat sat on the', return_tensors='pt')
print(tok.decode(lm.generate(**x, max_new_tokens=20, do_sample=True, top_k=40)[0]))
Limitations
Very small: it knows grammar and common phrases but little about the world. It is meant for judging sentences, not chatting or facts. English only; it may repeat biases or old-fashioned language from its training text.
About the maker
Viveka was built by Vrishvardhan Sharma (vrishv), a 9-year-old self-taught builder from India. His other work:
- GitaVardhan: a free, offline Bhagavad Gita app in 13 Indian languages, and a pocket-sized voice-controlled Gita device he designed, wired and coded himself.
- Sanskrit Vardhan: an app for learning Sanskrit through the Bhagavad Gita, with word-by-word meanings and step-by-step Pāṇinian derivations. Launched on 20 October 2026 by Prof. Shrinivasa Varakhedi, Vice-Chancellor of Central Sanskrit University.
- Kannada, Tamil and Telugu Vardhan: apps that teach everyday spoken Kannada, Tamil and Telugu.
- Hindi Vardhan (hindivardhan.in): a dictionary of pure, Sanskrit-rooted Hindi. Over 6,000 borrowed words in everyday Hindi, each with native alternatives checked against five classical Sanskrit dictionaries.
- AksharaVardhan: a handwriting reader that runs on an ordinary computer.
He has memorised the Bhagavad Gita and Pāṇini's Aṣṭādhyāyī, won national Sanskrit recitation competitions, and speaks six languages. More at vrishvardhan.in.
CC BY-NC 4.0 © 2026 Vrishvardhan Sharma.
- Downloads last month
- 60