dwgx/WindsurfAPI

해결하는 문제

WindsurfAPI는 Windsurf(이전의 Codeium/Devin Desktop)의 내부 프로토콜을 표준이고 호환 가능한 API로 변환함으로써, Claude, GPT, Gemini, DeepSeek 등 100개 이상의 AI 모델에 접근할 수 있는 방법을 제공합니다. 이를 통해 사용자는 공식 Windsurf IDE를 사용하지 않고도 이러한 모델을 자신의 SDK나 AI 에이전트(Claude Code, Cline, Cursor 등) 내에서 사용할 수 있습니다.

작동 방식

이 프로젝트는 프로토콜 번역 계층으로 작동합니다. OpenAI, Anthropic, Gemini API 형식과 호환되는 HTTP 엔드포인트를 노출합니다. 요청이 수신되면 WindsurfAPI는 이를 Windsurf에서 사용하는 내부 gRPC 프로토콜로 변환하고, 로컬 언어 서버(LS) 바이너리를 통해 Windsurf 클라우드로 전송한 후, 응답을 요청된 표준 형식으로 다시 변환합니다. 또한 로드 밸런싱, 레이트 제한, 장애 대응을 처리하기 위해 계정 풀을 관리합니다.

대상 사용자

• 개발자: 자신의 애플리케이션에서 표준 API를 통해 고성능 AI 모델을 사용하고 싶은 분들.
• AI 에이전트 사용자 (예: Claude Code, Cline, Cursor): 기존 워크플로우에 Windsurf의 모델 접근 기능을 통합하고 싶은 분들.
• 자체 호스팅 사용자: 여러 선도적인 LLM에 대한 통합 게이트웨이를 찾는 분들.

주요 특징

• 다중 API 호환성: 동시에 OpenAI, Anthropic, Gemini API 표준을 지원합니다.
• 광범위한 모델 지원: Claude, GPT, Gemini의 다양한 버전과 SWE와 같은 전문 모델을 포함해 100개 이상의 모델에 접근할 수 있습니다.
• 계정 관리: 자동 풀링, 레이트 제한 격리, 장애 내성 기능을 갖춘 내장형 계정 풀링 기능.
• 런타임 의존성 없음: 순수 Node.js로 구현되어 npm 런타임 의존성이 전혀 필요하지 않습니다.
• 세션 관리: 응답 API에 서버 측 세션 저장소를 포함하여 대화 상태를 유지하고 전체 기록을 다시 전송하지 않아도 됩니다.