multimodal-agents-course

the-ai-mergeApache-2.0更新放缓

一个基于 MCP 协议的多模态 AI Agent 教程项目,让 Agent 能看图听声,用 Pixeltable 做嵌入存储、Groq 和 OpenAI 驱动推理。

An MCP Multimodal AI Agent with eyes and ears!

暂无版本583star149fork同步于 2026-11-07 07:31 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/the-ai-merge/multimodal-agents-course.git
cd multimodal-agents-course
硬件要求按 README 说明

README 未说明具体显存或 GPU 要求;课程主要调用 OpenAI 和 Groq 的 API 模型推理,因此任意操作系统的笔记本或 PC 即可运行

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

一门免费开源课程,教你从零构建能理解图像、文本、音频和视频的 MCP 多模态 AI Agent

一个基于 MCP 协议的多模态 AI Agent 教程项目,让 Agent 能看图听声,用 Pixeltable 做嵌入存储、Groq 和 OpenAI 驱动推理。

核心能力

  • 用 Pixeltable 搭建多模态数据处理流水线
  • 用 FastMCP 构建视频搜索 MCP 服务器并暴露工具、资源和提示词
  • 从零实现自定义 MCP 客户端与 Groq 驱动的工具调用 Agent
  • 用 Opik 做提示词版本管理、追踪与可观测性
  • 搭建 FastAPI 后端与 React 前端的完整 Agent 应用

容易踩的坑

启动前需按 GETTING_STARTED.md 完成配置,README 未给出完整依赖安装命令;需自行注册 OpenAI 和 Groq 获取 API Key,免费额度分别为 $5 和每天 50 万 tokens;项目不是简单教程,需按各模块的 Get Started 步骤分别配置

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    📖 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


    🧑‍🎓 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 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

    Find us on

    PublicationDescriptionSubscribe
    Neural BitsLearn about industry standards and production-ready AI Engineering.
    The Neural Maze Learn to build AI Systems that actually work, from principles to production. Delivered every Wednesday.