README.md

---
title: README
emoji: 🧠
colorFrom: gray
colorTo: blue
sdk: static
pinned: false
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/62d648291fa3e4e7ae3fa6e8/zayI0eWSVI6Ylp8TlU22L.png
---

![youtube_banner](https://cdn-uploads.huggingface.co/production/uploads/62d648291fa3e4e7ae3fa6e8/ZWnCgabBLnGLVLIMa6R65.png)

# Welcome to The Context Course

**The Context Course** is a free, hands-on course on doing machine learning with agent context. You'll learn to train models, optimize inference, and build datasets — all by defining agent context with `SKILLS.md`, Plugins, MCP, Subagents, and Hooks.

Whether you use Claude Code, Codex, or OpenCode, this course will teach you to give agents the right knowledge, tools, and structure to do real ML work.

## How to join the course

First, you need to join this org to get info about the course:

<div style="width: 100%; border: 1px solid #ccc; padding: 20px; margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); background-image: linear-gradient(to bottom, #2d2d2d, #1a1a1a); border-radius: 8px;">
  <h2 style="color: #e0e0e0; margin-bottom: 10px;">🚀 Ready to start? Enroll now — it's free.</h2>
  <a href="https://hf-learn.short.gy/join-context-course" style="display: inline-block; padding: 10px 20px; background-color: #4a9eff; color: white; text-decoration: none; border-radius: 5px; font-weight: bold; transition: background-color 0.3s ease;" onmouseover="this.style.backgroundColor='#3a8eef'" onmouseout="this.style.backgroundColor='#4a9eff'">Join the Course</a>
</div>

Our first livestream will be May 12th, so sign up on YouTube. 

<a href="https://youtube.com/live/269l_UN3qRI?feature=share" style="text-decoration: none; color: inherit; display: block; width: 100%; margin: 20px 0;">
  <div style="padding: 15px; border-radius: 8px; background-image: linear-gradient(to bottom, #ffe0e0, #ffcccc); box-shadow: 1px 1px 3px rgba(0,0,0,0.1); border: 2px solid #e74c3c; display: flex; justify-content: space-between; align-items: center; transition: all 0.3s ease;" onmouseover="this.style.transform='scale(1.02)'; this.style.boxShadow='2px 2px 8px rgba(0,0,0,0.2)';" onmouseout="this.style.transform='scale(1)'; this.style.boxShadow='1px 1px 3px rgba(0,0,0,0.1)';">
    <div>
      <h3 style="margin-top: 0; color: #000000;">🔴 Launch Live Stream & AMA</h3>
      <p style="color: #000000;">Weekly live AMA sessions covering course material, Q&A, and deep dives into ML with context engineering. First session: <b>May 12th</b>.</p>
    </div>
  </div>
</a>

## Deep Dive Projects

The course includes three hands-on ML projects that you'll tackle using agent context:

- **Pre-training** — Run and monitor pre-training experiments with agent-driven research workflows.
- **Post-training** — Fine-tune and evaluate chat models using a compact nano benchmark.
- **Inference** — Optimize local inference with llama.cpp, getting a GGUF model to run as fast as possible.

Each project is designed to be completed with a code agent — you'll define the context that makes it work.

## Interactive Quizzes

Each unit includes quizzes to test your understanding. Complete them to track your progress and earn your certificate.

## Supported Agents

This course works with multiple code agents. Instructions are provided for all three:

- **Pi**: Lean and Open Source agent.
- **Claude Code**: Anthropic's code agent (CLI & desktop)
- **Codex**: OpenAI's multi-agent CLI
- **OpenCode**: Open source agent from opencode.ai

If you use Cursor or GitHub Copilot, the concepts still transfer — their MCP and extension UX just isn't covered step-by-step.

## Prerequisites

- Basic familiarity with Python and the command line
- A [Hugging Face account](https://huggingface.co/join)
- At least one code agent installed (Claude Code, Codex, or OpenCode)

## Contribute

This course is open source and contributions are welcome!

- Found a bug or want to improve content? Open an issue or PR on [GitHub](https://github.com/huggingface/context-course).
- Want to add a full section or unit? Open an issue first to discuss with the team.

## Questions?

Open a [community discussion](https://huggingface.co/organizations/context-course/discussions) on the org page, or ask during the weekly live AMA.

<div style="width: 100%; border: 1px solid #ccc; padding: 20px; margin: 20px auto; box-shadow: 2px 2px 5px rgba(0, 0, 0, 0.1); background-image: linear-gradient(to bottom, #2d2d2d, #1a1a1a); border-radius: 8px;">
  <h2 style="color: #e0e0e0; margin-bottom: 10px;">📚 Start Learning</h2>
  <a href="https://huggingface.co/learn/context-course/unit0/introduction" style="display: inline-block; padding: 10px 20px; background-color: #4a9eff; color: white; text-decoration: none; border-radius: 5px; font-weight: bold; transition: background-color 0.3s ease;" onmouseover="this.style.backgroundColor='#3a8eef'" onmouseout="this.style.backgroundColor='#4a9eff'">Access the Full Course</a>
</div>