---
title: "Calfkit — Kafka 기반 분산 AI 에이전트를 마이크로서비스로 구성하는 Python SDK"
published: 2026-02-05T23:10:12.000Z
canonical: https://jeff.news/article/459
---
# Calfkit — Kafka 기반 분산 AI 에이전트를 마이크로서비스로 구성하는 Python SDK

Calfkit은 AI 에이전트를 독립적인 마이크로서비스(채팅, 도구, 라우팅)로 분해하고 Kafka 이벤트 스트림으로 비동기 통신하게 해주는 Python SDK. 각 서비스가 독립 스케일링 가능하고, 기존 데이터 파이프라인에 네이티브로 합류 가능.

- Calfkit이라는 Python SDK가 Show HN에 올라옴. Kafka 기반으로 분산 이벤트 드리븐 AI 에이전트를 마이크로서비스처럼 구성할 수 있게 해주는 도구임

## 기존 AI 에이전트 아키텍처의 문제

- 전통적인 웹앱처럼 에이전트를 만들면 초기 마이크로서비스가 겪었던 문제가 그대로 재현됨:
  - 하나 고치면 다른 에이전트/툴이 깨지는 **강결합(tight coupling)**
  - 모든 에이전트가 한 런타임에 있어서 **스케일링이 한 덩어리**로만 가능
  - 기존 업스트림/다운스트림 시스템과 연결하기 어려운 **사일로 구조**

## Calfkit이 해결하려는 것

- 에이전트를 **독립적인 서비스들로 분해**함 — 채팅, 도구, 라우팅이 각각 별도 서비스로 돌아감
- 각 서비스가 **독립적으로 스케일링** 가능하고, 이벤트 스트림으로 비동기 통신
- 에이전트가 기본적으로 이벤트 스트림을 리슨하므로, 실시간 마켓 피드, IoT 센서, 사용자 활동 스트림 같은 **데이터 스트림 소비가 네이티브 패턴**이 됨
- 도구(tool)는 특정 에이전트에 종속되지 않음. 한 번 배포하면 시스템 내 어떤 에이전트든 발견하고 호출 가능

## 사용 방식

- `pip install calfkit`으로 설치
- 로컬 Kafka 브로커(Docker 필요)를 띄우거나, 베타 중인 Calfkit Cloud(매니지드 브로커)를 사용
- 도구 서비스 → LLM 채팅 서비스 → 에이전트 라우터 서비스 순으로 각각 배포하고, 클라이언트에서 호출하는 구조
- 클라이언트가 호출 시점에 시스템 프롬프트를 오버라이드하거나 사용 가능한 도구를 제한할 수도 있음 (재배포 불필요)

> [!TIP]
> Kafka 기반이라 기존에 Kafka 인프라를 쓰고 있는 팀이라면 AI 에이전트를 기존 파이프라인에 자연스럽게 합류시킬 수 있다는 게 강점. 다만 아직 문서가 부족하고 README가 메인 레퍼런스인 상태임

## 핵심 포인트

- 에이전트를 채팅/도구/라우팅 서비스로 분해하여 독립 배포·스케일링
- Kafka 이벤트 스트림 네이티브로 실시간 데이터 소비가 기본 패턴
- 도구는 에이전트에 종속되지 않아 한 번 배포하면 모든 에이전트가 사용 가능
- 클라이언트가 호출 시점에 시스템 프롬프트와 도구를 오버라이드 가능

## 인사이트

기존 Kafka 인프라를 쓰는 팀이라면 AI 에이전트를 기존 파이프라인에 자연스럽게 합류시킬 수 있다는 게 핵심 가치. 다만 아직 문서가 README 수준.