Paperclip (60K Stars) — AI 에이전트들이 기다려온 오픈 소스 OS

저는 소규모 AI 팀을 운영해 왔습니다. 연구, 글쓰기, 콘텐츠 제작을 수행하는 몇 명의 에이전트(agents)들로 구성된 팀입니다. 가장 큰 도전 과제는 AI 자체가 아니었습니다. 바로 AI를 관리하는 것이었습니다.

어떤 에이전트가 무엇을 하고 있는가? 누가 API 비용을 폭증시켰는가? 누군가 작업 중에 막혀 있는가? 저는 에이전트들이 실제로 일하는 시간보다 이들을 오케스트레이션(orchestrating)하는 데 더 많은 시간을 쓰고 있었습니다.

그러다 Paperclip을 발견했고, 그것이 모든 것을 바꾸어 놓았습니다.

Paperclip란 무엇인가?

Paperclip은 스스로를 AI 기업을 위한 오픈 소스 OS(open-source OS)라고 부릅니다. 60,000개 이상의 GitHub stars를 보유한, 아무도 이야기하지 않지만 가장 인기 있는 솔루션입니다.

다음과 같이 생각하면 쉽습니다:

• Asana/Trello → 하지만 인간이 아닌 AI 에이전트(agents)를 위해 설계됨
• AWS Budgets → 하지만 에이전트별, 프로젝트별로 설정 가능하며 강제 중단(hard stops) 기능 포함
• PagerDuty → 하지만 에이전트의 하트비트(heartbeats) 및 자동 복구(auto-recovery)를 위한 기능
  이 모든 것이 하나의 오픈 소스 패키지에 담겨 있습니다.

3가지 핵심 기능

1. 하트비트 엔진 (Heartbeat Engine)

에이전트들이 항상 온라인 상태인 것은 아닙니다. Paperclip은 작업이 있을 때 에이전트를 깨우고, 먼저 예산을 확인하며, 비밀 정보(secrets)를 주입하고, 실행을 모니터링합니다. 만약 에이전트가 작업 도중 충돌(crash)한다면? 자동 복구(Auto-recovery)가 이루어집니다.

2. 예산 제어 (Budget Control)

예산의 세분화(granularity): 회사 → 에이전트 → 프로젝트 → 작업 → 제공자(Provider) → 모델(Model). 예산이 초과되면: 에이전트 일시 중지 + 대기 중인 작업 취소. 예상치 못한 청구서를 방지합니다.

3. 원자적 작업 체크아웃 (Atomic Task Checkout)

하나의 작업에는 항상 하나의 에이전트만 배정됩니다. 두 명의 에이전트가 동일한 작업을 수행하는 일은 절대 없습니다. 작업에는 목표 계보(goal lineage)가 포함되어 있어, 에이전트는 자신이 왜 이 일을 하고 있는지 항상 알고 있습니다.

시작하기

npx paperclipai onboard --yes

또는 로컬에 클론하여 실행하세요:

git clone https://github.com/paperclipai/paperclip
cd paperclip
pnpm install
...

스택(Stack): Node.js 20+, React, PostgreSQL, MIT License
GitHub: github.com/paperclipai/paperclip (60k+ stars)

만약 당신이 3개 이상의 AI 에이전트를 관리하면서 Paperclip을 사용하지 않고 있다면, 오케스트레이션에 너무 많은 시간을 허비하고 있는 것입니다. 저는 이 사실을 고생하며 배웠으니, 여러분은 그러지 않기를 바랍니다.