Instructions to use OttoCapi/Potodoo-V1-135M-Instruct with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use OttoCapi/Potodoo-V1-135M-Instruct with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="OttoCapi/Potodoo-V1-135M-Instruct", filename="potodoo_v1.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use OttoCapi/Potodoo-V1-135M-Instruct 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 OttoCapi/Potodoo-V1-135M-Instruct:F16 # Run inference directly in the terminal: llama cli -hf OttoCapi/Potodoo-V1-135M-Instruct:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf OttoCapi/Potodoo-V1-135M-Instruct:F16 # Run inference directly in the terminal: llama cli -hf OttoCapi/Potodoo-V1-135M-Instruct:F16
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 OttoCapi/Potodoo-V1-135M-Instruct:F16 # Run inference directly in the terminal: ./llama-cli -hf OttoCapi/Potodoo-V1-135M-Instruct:F16
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 OttoCapi/Potodoo-V1-135M-Instruct:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf OttoCapi/Potodoo-V1-135M-Instruct:F16
Use Docker
docker model run hf.co/OttoCapi/Potodoo-V1-135M-Instruct:F16
- LM Studio
- Jan
- vLLM
How to use OttoCapi/Potodoo-V1-135M-Instruct with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "OttoCapi/Potodoo-V1-135M-Instruct" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "OttoCapi/Potodoo-V1-135M-Instruct", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/OttoCapi/Potodoo-V1-135M-Instruct:F16
- Ollama
How to use OttoCapi/Potodoo-V1-135M-Instruct with Ollama:
ollama run hf.co/OttoCapi/Potodoo-V1-135M-Instruct:F16
- Unsloth Studio
How to use OttoCapi/Potodoo-V1-135M-Instruct 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 OttoCapi/Potodoo-V1-135M-Instruct 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 OttoCapi/Potodoo-V1-135M-Instruct to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for OttoCapi/Potodoo-V1-135M-Instruct to start chatting
- Atomic Chat new
- Docker Model Runner
How to use OttoCapi/Potodoo-V1-135M-Instruct with Docker Model Runner:
docker model run hf.co/OttoCapi/Potodoo-V1-135M-Instruct:F16
- Lemonade
How to use OttoCapi/Potodoo-V1-135M-Instruct with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull OttoCapi/Potodoo-V1-135M-Instruct:F16
Run and chat with the model
lemonade run user.Potodoo-V1-135M-Instruct-F16
List all available models
lemonade list
Potodoo-V1-135M-Instruct
A tiny, efficient, and quirky instruction-following AI fine-tuned by Otto. Potodoo is built on the SmolLM-135M base model and optimized for edge devices, laptops, and mobile phones.
π Model Details
- Model Name: Potodoo-V1-135M-Instruct
- Base Model: HuggingFaceTB/SmolLM-135M-Instruct
- Parameters: 135 Million
- Architecture: Llama-based (SmolLM)
- Training Method: LoRA (Low-Rank Adaptation) + Full Merge
- Training Epochs: 10 epochs
- Final Training Loss: ~1.13
- Quantization: F16 (269MB) / Q4_K_M (~100MB)
- Context Length: 2048 tokens
- License: CC BY-NC 4.0 (Non-Commercial)
π― Use Cases
Potodoo is designed for:
- β Local chat applications on low-end hardware
- β Educational projects and research
- β Mobile and embedded AI assistants
- β Coding help and explanations
- β Fun conversations with a quirky personality
- β Capybara facts (obviously π¦«)
Hardware Requirements
Potodoo runs on minimal hardware:
- RAM: 2GB+ (F16) or 512MB+ (Q4_K_M)
- CPU: Any modern x86_64 or ARM processor
- GPU: Not required (but supported via Metal/CUDA)
- Storage: ~100-300MB
Will probrably run on:
- iPhone X and newer
- Android phones with 8-core CPUs
- Laptops with 8GB RAM (Windows, macOS, Linux)
- Raspberry Pi 4/5
π How to Use
Using Ollama
ollama run potodoo-135m-instruct
Using LM Studio
Download the GGUF file
Load it in LM Studio
Start chatting!
Using llama.cpp
./main -m potodoo_v1_f16.gguf -p "Hello, Potodoo!" -n 128
π Training Details
Dataset
Custom curated dataset with 150 examples
Focus on corporate-quirky conversational tone
ChatML format with <|im_start|> and <|im_end|> tokens
Training Configuration
Framework: Unsloth + Hugging Face Transformers
LoRA Rank: 16
LoRA Alpha: 16
Target Modules: q_proj, k_proj, v_proj, o_proj, gate_proj, up_proj, down_proj
Batch Size: 4 (with gradient accumulation)
Learning Rate: 2e-4 with cosine scheduler
Warmup Steps: 10
Optimizer: AdamW 8-bit
Precision: FP16 (mixed precision training)
Performance
Training Loss: Started at ~2.5, ended at ~1.13
Training Time: ~10-12 minutes on NVIDIA T4 GPU
Convergence: Excellent for model size
π§ Model Architecture
SmolLM-135M Architecture:
βββ Hidden Size: 576
βββ Intermediate Size: 1536
βββ Num Attention Heads: 8
βββ Num KV Heads: 4 (GQA)
βββ Num Hidden Layers: 30
βββ Vocab Size: 49,152
βββ RoPE Theta: 10,000
βββ RMS Norm Epsilon: 1e-06
π Limitations
Size: At 135M parameters, this is a very small model. It may struggle with:
- Complex reasoning tasks
- Long-context understanding
- Highly technical or specialized knowledge
- Multi-step problem solving
Language: Primarily trained on English data
Knowledge Cutoff: Inherits base model's knowledge (2024)
Bias: May exhibit biases present in training data
βοΈ License
This model is released under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. You are free to:
- β Share β copy and redistribute the material in any medium or format
- β Adapt β remix, transform, and build upon the material
- β Use for personal, educational, and research purposes
Under the following terms:
- π Attribution β You must give appropriate credit to the original creator
- π« NonCommercial β You may not use the material for commercial purposes
Commercial use is strictly prohibited. This includes but is not limited to:
- Selling access to this model
- Using it in commercial products or services
- Training other models on this fine-tuned version
- Any form of monetization
For commercial licensing inquiries, please contact the author.
π¨βπ» Author
Otto11X Fine-tuned as part of a school project on edge AI and model optimization
π Acknowledgments
- Base Model: HuggingFaceTB/SmolLM-135M-Instruct by Hugging Face
- Training Framework: Unsloth for fast fine-tuning
- Conversion: llama.cpp for GGUF conversion
Random Fun Facts
- Potodoo was trained in less than 15 minutes
- The model is smaller than most smartphone photos
- It can run on a phone from 2017
- The name "Potodoo" comes from potato, as it can run in a potato! Get it? Hahaha... It was bullsh-t wasnt it?
- Training involved exactly 150 examples of corporate-quirky conversation
- The final loss of 1.13 is considered excellent for a 135M parameter model
Built with β€οΈ and a lot of debugging in Google Colab
- Downloads last month
- 47
16-bit
Model tree for OttoCapi/Potodoo-V1-135M-Instruct
Base model
HuggingFaceTB/SmolLM-135M