huggingface/smol-course

A course on aligning smol models.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 6 minutes ago
Added to GitGenius on September 9th, 2026
Created on November 25th, 2024
Open Issues & Pull Requests: 97 (+0)
GitHub issues: Enabled
Number of forks: 2,278
Total Stargazers: 6,743 (+0)
Total Subscribers: 47 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 5.6 hours
Mean response time: 4.6 days
90th percentile: 18.7 days
Tracked items: 46

How this project is maintained

92% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Three people close 83% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 39
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 485 days
Stale 30+ days: 39
Stale 90+ days: 38

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • question (2)
  • documentation (1)
  • good first issue (1)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Smol Course is a practical educational resource for learning to align language models for specific use cases.

The course addresses the challenge of customizing language models without requiring extensive computational resources or paid services. It teaches alignment techniques through hands-on exercises built around SmolLM3 and SmolVLM2 models, with minimal GPU requirements. The skills covered—instruction tuning, evaluation, preference alignment using algorithms like DPO, and vision language model adaptation—apply to both small and larger models. The course emphasizes that small language models suit domain-specific applications where efficiency, customization, local deployment, and cost control matter more than general-purpose capabilities.

Developers should choose this course if they want to fine-tune models on local machines without cloud dependencies or significant hardware investment. It works well for teams building domain-specific applications, academic researchers exploring cutting-edge techniques with lower logistical overhead, and anyone prioritizing privacy by keeping data local. The course assumes basic familiarity with machine learning, Python, PyTorch, and the transformers library. It is structured as a peer-reviewed, community-driven resource where learners submit work for review and can contribute models to a leaderboard.

The project maintains active engagement through an open pull request model where contributors read material, complete exercises, add examples, and submit models for community evaluation. The course roadmap shows completed modules on instruction tuning, evaluation, and preference alignment, with additional modules on reinforcement learning and synthetic data generation planned for future release.