google/adk-python
Google의 오픈소스 Python 프레임워크로 AI 에이전트를 구축, 평가, 배포하는 도구
20,501+150이번 주0 찜
3,654포크430이슈
중간맛 분석
Python 3.10+ 기반의 코드 우선 프레임워크입니다. 핵심은 Workflow (그래프 기반 실행 엔진)과 Task (에이전트 간 위임)로, 라우팅·팬아웃/팬인·루프·재시도·상태 관리·인간 개입 등을 지원합니다. pip install google-adk로 설치 후 adk run 또는 adk web으로 즉시 실행 가능하며, 샘플 코드가 풍부하게 제공됩니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 여러 AI 어시스턴트가 협력하여 복잡한 비즈니스 문제를 해결하는 멀티에이전트 시스템 구축
- 고객 지원·데이터 분석·콘텐츠 생성 등 다단계 작업을 자동화하는 워크플로우 구성
- LLM 기반 에이전트의 동작을 평가하고 배포하는 엔드투엔드 개발 프로세스 관리
핵심 기능
그래프 기반 워크플로우 런타임으로 라우팅, 팬아웃/팬인, 루프, 재시도 지원구조화된 Task API로 에이전트 간 다중 턴 위임 및 제어 가능인간 개입, 동적 노드, 중첩 워크플로우를 통한 유연한 멀티에이전트 협업
대안 대비 차별점
Google이 공식 개발한 오픈소스 프레임워크로, 그래프 기반 워크플로우 런타임과 구조화된 태스크 API를 통해 멀티에이전트 협업을 코드 우선 방식으로 명확하게 제어할 수 있습니다.
준비물
- Python 3.10 이상
바로 시작하기
- 패키지 설치하기
pip install google-adk
- 간단한 에이전트 정의하기 (예: agent.py)
# 필요한 임포트 및 에이전트 코드 작성
from google.adk import Agent
root_agent = Agent(
name="greeting_agent",
model="gemini-2.5-flash",
instruction="You are a helpful assistant. Greet the user warmly.",
)
- 로컬에서 대화형 CLI로 실행하기
adk run path/to/my_agent
- 또는 웹 UI로 실행하기 (다중 에이전트 디렉토리 지원)
adk web path/to/agents_dir
별 추이 · 7일
20,501+150 / 7일
활용성 · 따라 만들기 좋은가
베스트 샘플샘플 점수 76/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/google/adk-python)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기