{"id":30858554,"url":"https://github.com/docker/cagent","last_synced_at":"2026-02-24T18:04:16.750Z","repository":{"id":313046228,"uuid":"1048418394","full_name":"docker/cagent","owner":"docker","description":"Docker's Agent Builder and Runtime","archived":false,"fork":false,"pushed_at":"2025-09-03T16:32:10.000Z","size":12195,"stargazers_count":28,"open_issues_count":30,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-03T16:39:26.818Z","etag":null,"topics":["agents","ai"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/docker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-01T12:14:45.000Z","updated_at":"2025-09-03T16:37:41.000Z","dependencies_parsed_at":"2025-09-03T16:49:39.954Z","dependency_job_id":null,"html_url":"https://github.com/docker/cagent","commit_stats":null,"previous_names":["docker/cagent"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/docker/cagent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fcagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fcagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fcagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fcagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docker","download_url":"https://codeload.github.com/docker/cagent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fcagent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274046000,"owners_count":25212982,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai"],"created_at":"2025-09-07T14:13:20.459Z","updated_at":"2026-02-16T11:17:10.855Z","avatar_url":"https://github.com/docker.png","language":"Go","readme":"# 🤖 Docker `cagent` 🤖\n\n\u003e Build, run, and share AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration.\n\n![cagent in action](docs/demo.gif)\n\n## What is Docker `cagent`?\n\nDocker `cagent` lets you create and run intelligent AI agents that collaborate to solve complex problems — no code required. Define agents in YAML, give them tools, and let them work.\n\n```yaml\nagents:\n  root:\n    model: openai/gpt-5-mini\n    description: A helpful AI assistant\n    instruction: |\n      You are a knowledgeable assistant that helps users with various tasks.\n      Be helpful, accurate, and concise in your responses.\n    toolsets:\n      - type: mcp\n        ref: docker:duckduckgo\n```\n\n```sh\ncagent run agent.yaml\n```\n\n## Key Features\n\n- **Multi-agent architecture** — Create teams of specialized agents that delegate tasks automatically\n- **Rich tool ecosystem** — Built-in tools + any [MCP](https://modelcontextprotocol.io/) server (local, remote, or Docker-based)\n- **AI provider agnostic** — OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, [Docker Model Runner](https://docs.docker.com/ai/model-runner/), and more\n- **YAML configuration** — Declarative, versionable, shareable\n- **Advanced reasoning** — Built-in think, todo, and memory tools\n- **RAG** — Pluggable retrieval with BM25, embeddings, hybrid search, and reranking\n- **Package \u0026 share** — Push agents to any OCI registry, pull and run them anywhere\n\n## Install\n\n**Docker Desktop** (4.49+) — cagent is pre-installed. Just run `cagent`.\n\n**Homebrew** — `brew install cagent`\n\n**Binary releases** — Download from [GitHub Releases](https://github.com/docker/cagent/releases).\n\nSet at least one API key (or use [Docker Model Runner](https://docs.docker.com/ai/model-runner/) for local models):\n\n```sh\nexport OPENAI_API_KEY=sk-...        # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.\n```\n\n## Quick Start\n\n```sh\n# Run the default agent\ncagent run\n\n# Run from the agent catalog\ncagent run agentcatalog/pirate\n\n# Generate a new agent interactively\ncagent new\n\n# Run your own config\ncagent run agent.yaml\n```\n\nMore examples in the [`examples/`](examples/README.md) directory.\n\n## Documentation\n\n📖 **[Full documentation](https://docker.github.io/cagent/)**\n\n- [Installation](https://docker.github.io/cagent/#getting-started/installation) · [Quick Start](https://docker.github.io/cagent/#getting-started/quickstart)\n- [Agents](https://docker.github.io/cagent/#concepts/agents) · [Models](https://docker.github.io/cagent/#concepts/models) · [Tools](https://docker.github.io/cagent/#concepts/tools) · [Multi-Agent](https://docker.github.io/cagent/#concepts/multi-agent)\n- [Configuration Reference](https://docker.github.io/cagent/#configuration/overview)\n- [TUI](https://docker.github.io/cagent/#features/tui) · [CLI](https://docker.github.io/cagent/#features/cli) · [MCP Mode](https://docker.github.io/cagent/#features/mcp-mode) · [RAG](https://docker.github.io/cagent/#features/rag)\n- [Model Providers](https://docker.github.io/cagent/#providers/overview) · [Docker Model Runner](https://docker.github.io/cagent/#providers/dmr)\n\n## Contributing\n\nRead the [Contributing guide](https://docker.github.io/cagent/#community/contributing) to get started. We use `cagent` to build `cagent`:\n\n```sh\ncagent run ./golang_developer.yaml\n```\n\n## Telemetry\n\nWe collect anonymous usage data to improve the tool. See [Telemetry](https://docker.github.io/cagent/#community/telemetry).\n\n## Community\n\n[Docker Community Slack](http://dockr.ly/comm-slack) · [#cagent channel](https://dockercommunity.slack.com/archives/C09DASHHRU4)\n","funding_links":[],"categories":["Go","Personal Assistants \u0026 Conversational Agents"],"sub_categories":["Chatbots"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker%2Fcagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocker%2Fcagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker%2Fcagent/lists"}