cagent <\/strong>is Docker\u2019s open-source multi-agent runtime that orchestrates AI agents through declarative YAML configuration. Rather than managing Python environments, SDK versions, and orchestration logic, developers define agent behavior in a single configuration file and execute it with \u201ccagent run\u201d.\u00a0<\/p>\n Some of the key features of Docker cagents:<\/p>\n The core value proposition is simple: declare what your agent should do, and cagent handles your execution. Each agent operates with isolated context, specialized tools via the Model Context Protocol (MCP), and configurable models. Agents can delegate tasks to sub-agents, creating hierarchical teams that mirror human organizational structures.<\/p>\n GitHub Models is a suite of developer tools that take you from AI idea to deployment, including a model catalog, prompt management, and quantitative evaluations.GitHub Models provides rate-limited free access to production-grade language models from OpenAI (GPT-4o, GPT-5, o1-preview), Meta (Llama 3.1, Llama 3.2), Microsoft (Phi-3.5), and DeepSeek models.The advantage with GitHub Models are you need to Authenticate only once via GitHub Personal Access Tokens and you can plug and play any models of your choice supported by GitHub Models.<\/p>\n You can browse to GitHub Marketplace at https:\/\/github.com\/marketplace<\/a> to see the list of all models supported. Currently GitHub supports all the popular models and the list continues to grow. Recently, Anthropic Claude models were also added.<\/p>\n Figure 1.1: GitHub Marketplace displaying list of all models available on the platform<\/em><\/p>\n\n GitHub has designed its platform, including GitHub Models and GitHub Copilot agents, to support production-level agentic AI workflows, offering the necessary infrastructure, governance, and integration points.GitHub Models employs a number of content filters<\/a>. These filters cannot be turned off as part of the GitHub Models experience. If you decide to employ models through Azure AI <\/a>\u00a0or a paid service, please configure your content filters to meet your requirements.<\/p>\n To get started with GitHub Models, visit https:\/\/docs.github.com\/en\/github-models\/quickstart<\/a> which contains detailed quick start guides.\u00a0<\/p>\n GitHub Models OpenAI-compatible API allows straightforward integration with cagent by treating it as a custom OpenAI provider with modified base URL and authentication.<\/p>\n In this article, we will create and deploy a PodCast Generator agent using Github models and show you how easy it is to deploy and share AI agents by deploying it to Docker Hub registry. It is necessary to create a fine-grained personal access token by navigating to this url: https:\/\/github.com\/settings\/personal-access-tokens\/new<\/a>\u00a0\u00a0<\/p>\n Figure 1.2: Generating a new personal access token (PAT) from GitHub developer settings.<\/em><\/p>\n I will showcase a simple podcast generator agent, which I created months ago during my testing of Docker cagent. This Agent\u2019s purpose is to generate podcasts by sharing blogs\/articles\/youtube videos.<\/p>\n Below Podcastgenerator yaml file describes a sophisticated multi-agent workflow for automated podcast production, leveraging GitHub Models and MCP tools (DuckDuckGo) for external data access. The DuckDuckGo MCP server runs in an isolated Docker container managed by the MCP gateway. To learn more about docker MCP server and MCP Gateway refer to official product documentation at https:\/\/docs.docker.com\/ai\/mcp-catalog-and-toolkit\/mcp-gateway\/<\/a>.\u00a0 Note:<\/strong> Since we are using DuckDuckGo MCP server, make sure to add and install this MCP server from MCP catalog on your docker desktop<\/em><\/p>\n Make sure to update your GitHub PAT token and Run the below command to run your agent from the root folder where your cagent binaries reside.<\/p>\n Run the below command to push your agent as a docker image to your favorite registry to share it with your team.<\/p>\n You can see your published images inside your repositories as shown below.\u00a0<\/p>\n Congratulations! Now we have our first AI Agent created using cagent and deployed to Docker Hub.<\/p>\n Run the below command to pull your docker image agent, created by your teammate, which gets the agent yaml file and saves it in the current directory.<\/p>\n Alternatively, you can run the same agent directly without pulling the image by using the below command.<\/p>\n Note:<\/strong> Above Podcastgenerator example agent has been added to Docker\/cagent GitHub repository under examples folder. Give it a try and share your experience. https:\/\/github.com\/docker\/cagent\/blob\/main\/examples\/podcastgenerator_githubmodel.yaml<\/a><\/p>\n The traditional AI development workflow locks you into specific providers, requiring separate API keys, managing multiple billing accounts, and navigating vendor-specific SDKs. cagent with GitHub Models fundamentally changes this equation by combining Docker\u2019s declarative agent framework with GitHub\u2019s unified model marketplace. This integration grants you true vendor independence\u2014a single GitHub Personal Access Token provides access to models from OpenAI, Meta, Microsoft, Anthropic, and DeepSeek, eliminating the friction of managing multiple credentials and authentication schemes.<\/p>\n The future of AI development isn\u2019t about choosing a vendor and committing to their ecosystem. Instead, it\u2019s about building systems flexible enough to adapt as the landscape evolves, new models emerge, and your business requirements change. cagent and GitHub Models make that architectural freedom possible today.<\/p>\n What are you waiting for? Start building now with the power of cagent and GitHub Models and share your story with us.<\/p>\n To learn more about docker cagent, read the product documentation from https:\/\/docs.docker.com\/ai\/cagent\/<\/a><\/p>\n\n
What are GitHub Models?<\/strong><\/h2>\n
![\"image3](\"https:\/\/www.docker.com\/app\/uploads\/2025\/12\/image3-2.png\" "\\"-")
\n <\/div>\nConfiguring cagent with GitHub Models<\/strong><\/h2>\n
![\"image1](\"https:\/\/www.docker.com\/app\/uploads\/2025\/12\/image1-2.png\" "\\"-")
\n <\/div>\nPrerequisites<\/strong><\/h3>\n
\n
C:Dockercagent<\/code>. Run .cagent-exe \u2013help<\/code> to see more options.<\/li>\n<\/ol>\nDefine your agent<\/strong><\/h3>\n
The root agent uses sub_agents: [\u201cresearcher\u201d, \u201cscriptwriter\u201d] to create a hierarchical structure where specialized agents handle domain-specific tasks.\u00a0<\/p>\nsunnynagavo55_podcastgenerator.yaml<\/strong><\/h4>\n
\n#!\/usr\/bin\/env cagent run\n\nagents:\n root:\n description: \"Podcast Director - Orchestrates the entire podcast creation workflow and generates text file\"\n instruction: |\n You are the Podcast Director responsible for coordinating the entire podcast creation process.\n\n Your workflow:\n 1. Analyze input requirements (topic, length, style, target audience)\n 2. Delegate research to the research agent which can open duck duck go browser for researching\n 3. Pass the researched information to the scriptwriter for script creation\n 4. Output is generated as a text file which can be saved to file or printed out\n 5. Ensure quality control throughout the process\n\n Always maintain a professional, engaging tone and ensure the final podcast meets broadcast standards.\n model: github-model\n toolsets:\n - type: mcp\n command: docker\n args: [\"mcp\", \"gateway\", \"run\", \"--servers=duckduckgo\"]\n sub_agents: [\"researcher\", \"scriptwriter\"]\n researcher:\n model: github-model\n description: \"Podcast Researcher - Gathers comprehensive information for podcast content\"\n instruction: |\n You are an expert podcast researcher who gathers comprehensive, accurate, and engaging information.\n\n Your responsibilities:\n - Research the given topic thoroughly using web search\n - Find current news, trends, and expert opinions\n - Gather supporting statistics, quotes, and examples\n - Identify interesting angles and story hooks\n - Create detailed research briefs with sources\n - Fact-check information for accuracy\n\n Always provide well-sourced, current, and engaging research that will make for compelling podcast content.\n toolsets:\n - type: mcp\n command: docker\n args: [\"mcp\", \"gateway\", \"run\", \"--servers=duckduckgo\"]\n scriptwriter:\n model: github-model\n description: \"Podcast Scriptwriter - Creates engaging, professional podcast scripts\"\n instruction: |\n You are a professional podcast scriptwriter who creates compelling, conversational content.\n\n Your expertise:\n - Transform research into engaging conversational scripts\n - Create natural dialogue and smooth transitions\n - Add hooks, sound bite moments, and calls-to-action\n - Structure content with clear intro, body, and outro\n - Include timing cues and production notes\n - Adapt tone for target audience and podcast style\n - Create multiple format options (interview, solo, panel discussion)\n\n Write scripts that sound natural when spoken and keep listeners engaged throughout.\n toolsets:\n - type: mcp\n command: docker\n args: [\"mcp\", \"gateway\", \"run\", \"--servers=filesystem\"]\nmodels:\n github-model:\n provider: openai\n model: openai\/gpt-5\n base_url: https:\/\/models.github.ai\/inference\n env:\n OPENAI_API_KEY: ${GITHUB_TOKEN} \n\n<\/pre>\n<\/div>\n![\"image4](\"https:\/\/www.docker.com\/app\/uploads\/2025\/12\/image4-2.png\" "\\"-")
Running your Agent on Local Machine<\/strong><\/h3>\n
\ncagent run .\/sunnynagavo55_podcastgenerator.yaml\n\n<\/pre>\n<\/div>\n
Pushing your Agent as Docker Image<\/strong><\/h3>\n
\ncagent push Sunnynagavo55\/Podcastgenerator\n<\/pre>\n<\/div>\n
![\"image2](\"https:\/\/www.docker.com\/app\/uploads\/2025\/12\/image2-2.png\" "\\"-")
Pulling your Agent as Docker Image on a different machine<\/strong><\/h3>\n
\ncagent pull Sunnynagavo55\/Podcastgenerator\n<\/pre>\n<\/div>\n
\ncagent run Sunnynagavo55\/Podcastgenerator\n<\/pre>\n<\/div>\n
Conclusion<\/strong><\/h2>\n
Resources<\/strong><\/h3>\n