docker/compose-for-agents

Docker Desktop 4.43.0+ 또는 Docker Engine이 설치되어 있어야 합니다. 로컬에서 오픈 모델 (open models)을 실행하기 위해 GPU가 장착된 노트북 또는 워크스테이션(예: MacBook)이 필요합니다. GPU가 없는 경우, 대안으로 Docker Offload를 사용할 수 있습니다.

• Linux에서 Docker Engine을 사용하거나 Windows에서 Docker Desktop을 사용하는 경우, Docker Model Runner 요구 사항(특히 GPU 지원 활성화 여부)이 충족되었는지, 그리고 필요한 드라이버가 설치되었는지 확인하십시오.
• Linux에서 Docker Engine을 사용하는 경우, Docker Compose 2.38.1 이상 버전이 설치되어 있는지 확인하십시오.

각 데모는 독립적이며 로컬 또는 클라우드 컨텍스트 (cloud context)에서 실행할 수 있습니다. 모두 다음 두 단계를 통해 설정됩니다.

• 데모 프로젝트의 루트 디렉토리로 이동합니다.
• mcp.env.example 파일이 있는 경우 이를 사용하여 .mcp.env 파일을 생성하고(파일이 없는 경우 데모에 필요한 비밀 정보(secrets)가 없음) 필요한 MCP 토큰을 제공합니다. 그 다음 docker compose up --build를 실행합니다.

데모는 Docker Model Runner로 모델을 로컬에서 실행하는 대신 OpenAI 모델을 사용하는 것을 지원합니다. OpenAI를 사용하려면:

• OpenAI API 키(sk-...)가 포함된 secret.openai-api-key 파일을 생성합니다.
• OpenAI 설정을 사용하여 프로젝트를 시작합니다:

docker compose -f compose.yaml -f compose.openai.yaml up

데모	에이전트 시스템 (Agent System)	모델 (Models)	MCPs	프로젝트 (project)	compose
A2A Multi-Agent Fact Checker	Multi-Agent	OpenAI	duckduckgo	./a2a	compose.yaml
...

이 저장소는 Apache License 2.0 또는 MIT License에 따라 **이중 라이선스 (dual-licensed)**가 적용됩니다. 이 저장소에서 Docker가 기여한 내용을 사용하는 데 있어 두 라이선스 중 하나를 선택할 수 있습니다.

ℹ️

참고: 각 예제 하위에는 자체 LICENSE 파일이 있을 수 있습니다. 이는 해당 특정 예제에 적용되는 제3자 라이선스 요구 사항을 반영하기 위해 제공되며, 이에 따라 준수해야 합니다.

SPDX-License-Identifier: Apache-2.0 OR MIT