Kotlin 기반 AI 에이전트 프레임워크로 JVM, 안드로이드, iOS에서 타입 안전한 에이전트를 구축하세요
중간맛 분석
JetBrains의 인큐베이터 프로젝트로, Kotlin 2.2 이상과 JDK 17 이상에서 작동합니다. Spring Boot와 Ktor 같은 프레임워크와 통합되며, 여러 LLM 제공자(OpenAI, Anthropic, DeepSeek, Ollama 등)를 지원합니다. 에이전트 상태 복구, 토큰 최적화 히스토리 압축, OpenTelemetry 모니터링, MCP/ACP 프로토콜 지원이 포함되어 있습니다. Maven Central에서 라이브러리를 가져올 수 있으며, Gradle/Maven 모두 지원하고, 데모 코드는 에 제시되어 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- Spring Boot 또는 Ktor 애플리케이션에 지능형 에이전트 기능을 내장할 때
- 복잡한 멀티스텝 AI 워크플로우와 외부 API 통합이 필요한 백엔드 시스템 개발
- 안드로이드 및 iOS 애플리케이션에 AI 에이전트 기능을 추가할 때
핵심 기능
대안 대비 차별점
JVM/Kotlin 개발자를 위한 type-safe DSL과 Spring Boot/Ktor 통합으로, Python 중심 AI 프레임워크와 달리 기업형 Java 애플리케이션과의 네이티브 통합을 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- JDK 17 이상
- Kotlin 2.3.10 이상
- OpenAI, Anthropic, Google 등 LLM 제공자의 API 키(선택에 따라)
바로 시작하기
-
JDK 17 이상과 Kotlin 2.3.10 이상을 설치합니다.
-
build.gradle.kts에 Koog 의존성을 추가합니다(Gradle Kotlin DSL).
dependencies {
implementation("ai.koog:koog-agents:1.2.0")
implementation("ai.koog:koog-agents-additions:1.2.0-beta")
}
또는 build.gradle에 추가합니다(Gradle Groovy).
dependencies {
implementation 'ai.koog:koog-agents:1.2.0'
implementation 'ai.koog:koog-agents-additions:1.2.0-beta'
}
- Maven을 사용하는 경우
pom.xml에 다음을 추가합니다.
<dependency>
<groupId>ai.koog</groupId>
<artifactId>koog-agents-jvm</artifactId>
<version>1.2.0</version>
</dependency>
<dependency>
<groupId>ai.koog</groupId>
<artifactId>koog-agents-additions-jvm</artifactId>
<version>1.2.0-beta</version>
</dependency>
-
저장소 설정에
mavenCentral()이 포함되어 있는지 확인합니다. -
OpenAI(또는 다른 LLM 제공자) API 키를 환경 변수로 설정합니다.
export OPENAI_API_KEY="your-api-key"
- 다음 Kotlin 코드를 작성하고 실행합니다.
import ai.koog.agents.*
import kotlinx.coroutines.runBlocking
fun main() = runBlocking {
val apiKey = System.getenv("OPENAI_API_KEY")
val agent = AIAgent(
promptExecutor = MultiLLMPromptExecutor(OpenAILLMClient(apiKey)),
systemPrompt = "You are a helpful assistant. Answer user questions concisely.",
llmModel = OpenAIModels.Chat.GPT4o
)
val result = agent.run("Hello! How can you help me?")
println(result)
}
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try JetBrains/koog
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「백엔드·DB」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/JetBrains/koog)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기