Sandbox
@the-ai-merge/multimodal-agents-course

Multimodal MCP agent course with server, API, and UI

This repo is a course for learning how to build a multimodal agent that handles images, audio, video, and text. It pairs a FastMCP server, a Groq-powered agent API, and a React UI with Pixeltable and Opik for data handling and observability.

575 stars148 forksPythonUpdated 8mo ago
Building an MCP Video Agent | Full Course
The Neural Maze10k views • 1 year ago
Who it's for

Builders who want to learn multimodal agent design, MCP servers, and agent observability by building a full example.

What it delivers

You can build and inspect a complete multimodal agent system instead of just connecting to an existing server.

What it does

Multimodal MCP server

Teaches how to build an MCP server for video search and expose tools, resources, and prompts with FastMCP.

Custom agent API and client

Shows how to build a Groq-powered agent with its own MCP client and tool translation layer.

Pixeltable-based data pipeline

Uses Pixeltable for multimodal processing, indexing, and stateful agent data.

Opik observability

Adds prompt versioning, tracing, and monitoring with Opik.

Frontend and full-stack example

Includes a React UI and FastAPI-based backend path for the agent experience.

README

Kubrick Course

logo

Hi Dave...


Learn to build AI Agents that can understand images, text, audio and videos.

A free, Open-source course by The Neural Maze and Neural Bits in collaboration with Pixeltable and Opik


logo

📖 About This Course

Tired of tutorials that just walk you through connecting an existing MCP server to Claude Desktop?

Yeah, us too.

That's why we built Kubrick AI, an MCP Multimodal Agent for video processing tasks. Yes! You read that right.

💡 Agents + Video Processing ... and MCP!

This course is a collaboration between The Neural Maze and Neural Bits (from now on, "The Neural Bros"), and it's built for developers who want to go beyond the basics and build serious, production-ready AI Systems. In particular, you'll:

  • Learn how to build an MCP server for video processing using Pixeltable and FastMCP

  • Design a custom, Groq-powered agent, connected to your MCP server with its own MCP client

  • Integrate your agentic system with Opik for full observability and prompt versioning

🖊️ What you'll learn

  • Learn how to use Pixeltable for multimodal data processing and stateful agents

  • Create complex MCP servers using FastMCP: expose resources, prompts, and tools

  • Apply prompt versioning to your MCP server (instead of defining the prompts in the Agent API)

  • Learn how to implement custom MCP clients for your agents

  • Implement an MCP Tool Agent from scratch, using Llama 4 Scout and Maverick as the LLMs

  • Use Opik for MCP prompt versioning

  • Learn how to implement custom tracing and monitoring with Opik

🚀 No shortcuts. No fluff. Let's learn by doing.


💻 What You'll Do:

Completing this course, you'll learn how to design and enable Agents to understand multimodal data, across images, video, audio, and text inputs, all within a single system.

Specifically, you'll get to:

  • Build a complex Multimodal Processing Pipeline
  • Build a Video Search Engine and expose its functionality to an Agent via MCP (Model Context Protocol)
  • Build a production-ready API to power the Agent.
  • Integrate LLMOps principles and best software engineering practices.
  • Learn about video, embeddings, streaming APIs, Vision Language Models (VLMs), and more.

After completing this course, you'll have built your own Kubrick Agent with a HAL-themed spin-off, to play the role of a new set of eyes and ears:


Getting Started

Kubrick is not a simple tutorial. So, to get this system up and running, there are a few things you need to do first.

We have detailed the steps to get you started in this GETTING_STARTED.md file.

💡 Having Kubrick running is just the first step! Now that you have it up and running, it's time to actually understand how it works (see Course Syllabus).


Watch the Full Video Course

Kubrick Multimodal Agent


🧑‍🎓 Who is this course for?

You'll get the most out of this course by building it yourself, from the ground up. The course components are structured to cover key concepts and demonstrate how to build upon them, ultimately leading to AI Systems.

Target AudienceSkills you'll get
ML/AI EngineersBuild complex MCP Servers, learn to apply AI Models to Video, Images, and Speech.
Software EngineersLearn to connect AI Components with APIs, building end-to-end agentic applications.
Data Engineers/ScientistsLearn to design an AI System, managing Video/Audio/Image data processing and structure.

Regardless of your experience or title, this course aims to unpack complex topics in practical terms and concepts you could understand, learn, and apply - helping you to build a complete AI system.

🎓 Prerequisites

In this section, we outlined a few requirements and nice-to-haves to improve your learning experience while taking this course.

CategoryLabelDescription
Programming Skills (Beginner)RequirementUnderstanding of Programming in general, and the Python language syntax.
AI/ML Concepts (Beginner)Nice to HaveUnderstanding the basic concepts behind AI, AI Models, and AI Systems.
LLMs, MCP, AgentsNice to HavePerfect if you know about them, not a problem if you don't. We'll teach and explain it step by step.
Laptop/PC with any OSRequirementAI Models inference requires compute. To overcome that, we'll mainly use API based models.

The overall level of this course is Beginner/Intermediate, but don't worry. We'll aim to explain every component step by step designed for a larger audience.

💰 What's the cost?

This course and its materials are open-source and completely free, thanks to our sponsors, Pixeltable and Opik!

You'll be able to run Kubrick examples while staying at a minimum cost. That's because we'll use OpenAI and Groq for our LLM and VLM calls, which offer freemium plans as such:

ProviderFree Credits
OpenAI$5 on first sign-up
Groq500,000 tokens/day

[!NOTE]
In this setup, for running the Kubrick Agent example, the freemium plans are enough.

📚 Course Syllabus

The Kubrick Agent open-source course consists of five comprehensive modules, covering concepts, system design, tooling, and hands-on implementation.

To get the most out of this course, we recommend:

  • Clone this repository.
  • Follow the Get Started Sections of each module.
  • Read the module articles to understand each component.
  • Follow the Video Lessons for hands-on implementation.
  • Set up the code and run the project.
Module No.In-depth Lesson (Link)Lesson Summary (3min)DescriptionCode
0Get a SummaryCourse introduction and overview. Outlining the basic componentsN/A
1Get a SummaryDiving into the core components of the multimodal processing pipeline, covering video, images, text, and audio data.kubrick-mcp
2Get a SummaryBuilding the Kubrick MCP Server with FastMCP. Covering MCP protocol (transport, communication), capabilities, tools, resources, and prompts. Adding Opik Integration and MCP Inspector for efficient debugging and local testing.kubrick-mcp
3Get a SummaryBuilding the Kubrick MCP Agent from scratch. Memory layer implementation with Pixeltable and MCP Client with FastMCP. Understanding how to translate MCP Tools into specific provider tools (Groq)kubrick-api
4Get a SummaryBuilding the Groq Agent, covering the React UI - FastAPI API communication and adding LLMOps observability and conversation tracing with Opik (by Comet)kubrick-api
5Get a SummaryComplete Round-up of the free, open-source Kubrick Course.N/A

Sponsors

Pixeltable Opik

Pixeltable
is the only Python framework that provides incremental storage, transformation, indexing, and orchestration of your multimodal data.

Opik
LLM Evaluation platform helps you build, evaluate, and optimize LLM systems that run better, faster, and cheaper

Authors

Miguel Otero Pedrido
Miguel Otero Pedrido

AI / ML Engineer


LinkedIn

Alex Razvant
Alex Razvant

AI / ML Engineer


LinkedIn

Find us on

PublicationDescriptionSubscribe
Neural Bits Logo

Neural Bits

Learn about industry standards and production-ready AI Engineering.Subscribe Now
The Neural Maze Logo

The Neural Maze

Learn to build AI Systems that actually work, from principles to production. Delivered every Wednesday.Subscribe Now

Files in the repo

Repository payload17 top-level entries
  • .vscode
  • kubrick-api
  • kubrick-mcp
  • kubrick-ui
  • static
  • tutorials
  • .dockerignore
  • .env.example
  • .gitattributes
  • .gitignore
  • .python-version
  • docker-compose.dev.yml
  • docker-compose.yml
  • GETTING_STARTED.md
  • LICENSE
  • Makefile
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tutorials & guides

shareAI-lab/
learn-claude-code

Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1

77k
luongnv89/
claude-howto
luongnv89/claude-howtoTutorials & Guides

A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.

41k
agentskills/
agentskills
agentskills/agentskillsTutorials & Guides

Specification and documentation for Agent Skills

25k