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