OpenCopilot
Open (formerly Squarelab / OpenChat) · 코딩 · 생산성 · 챗봇
OpenCopilot은 제품 API를 AI 코파일럿으로 바꾸는 오픈소스 프레임워크다. OpenAPI 정의를 넘기면 사용자는 자연어로 업무를 끝낸다.
OpenCopilot 소개
About
OpenCopilot이란
OpenCopilot은 자체 서버에 올려 쓰는 AI 코파일럿 프레임워크다. API 정의를 읽고 필요한 엔드포인트를 판단해 파라미터를 채운 뒤, 결과를 채팅 답변으로 돌려준다. MIT 라이선스라 상용 제품에 넣어도 사용자 수만큼 비용이 붙지 않는다.
겨냥하는 문제는 분명하다. 화면 조작을 새로 배우기 싫은 사용자다. 누군가 "내보내기가 깨졌으니 티켓 만들어줘"라고 입력하면 코파일럿이 티켓 생성 엔드포인트를 골라 제목을 채우고 호출한다. 기존 API는 그대로 두고 그 위에 자연어 층을 얹는 구조다.
한계도 기능만큼 중요하다. 저장소는 2025년 3월에 아카이브됐고 README에는 "No longer maintained"만 남아 있다. 보안 패치가 나오지 않는다. API가 커지면 JSON 변환기를 직접 작성해야 하고, 설치는 Docker와 로그를 읽을 줄 아는 개발자를 전제로 한다.
시작하기
- 저장소를 복제하고
llm-server폴더의.env에 있는OPENAI_API_KEY자리표시자를 본인 키로 바꾼다. - 리눅스에서는
make install, Apple Silicon 맥에서는make install-arm을 실행한다. 콘솔은http://localhost:8888에서 열린다. - Swagger OpenAPI 3.0 정의를 불러오고 OpenCopilot이 검증한 액션 목록을 확인한다.
- 호출이 연달아 필요한 작업은 코파일럿 플로우를 그린 다음 위젯 스니펫을 앱에 붙인다.
제품 정보
OpenCopilot의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- SaaS 기업의 백엔드 개발자
- 혼자 MVP를 만드는 창업자
- 데이터 보관 규정이 있는 팀
작업
- 기존 REST API를 채팅 비서로 바꾸기
- 새로 만들기 전에 자연어 동작 검증하기
- 반복 문의 줄이기
활용 상황
- 사내 관리 도구
- 신제품에 코파일럿 붙이기
- 도구 호출형 에이전트의 원리 익히기
주요 기능
OpenAPI 명세 불러오기
Swagger OpenAPI 3.0 파일을 올리면 OpenCopilot이 각 작업을 모델이 고를 수 있는 액션으로 바꾼다. 변환 전에 스키마를 검증하는데, 엉성한 명세는 잘못된 호출을 낳기 때문이다. 문서화된 API에서 작동하는 코파일럿까지 가는 가장 짧은 길이 일괄 불러오기다.
자연어로 API 호출
코파일럿은 요청을 읽고 API 호출이 필요한지 판단한 뒤 엔드포인트를 고르고 문맥에서 요청 본문을 만든다. "내보내기 오류 때문에 새 티켓 만들어줘"라고 하면 제목 항목이 알아서 채워진다. 응답은 생 JSON이 아니라 읽을 수 있는 문장으로 돌아온다.
여러 단계 작업을 위한 시각적 플로우
단순한 요청은 설정 없이 처리된다. 복잡한 요청은 안 된다. 코파일럿 플로우가 그 자리를 메운다. 시각 편집기에서 순서를 그리면 모델은 호출 순서를 추측하지 않고 정해진 단계를 따른다.
임베드형 채팅 위젯
위젯은 저장소에 함께 들어 있고 script 태그 하나나 프런트엔드 코드 몇 줄로 붙는다. 사용자가 보는 부분이며, API 코파일럿은 자체 로그인과 권한 뒤에 남는다.
Docker 기반 셀프 호스팅 배포
모든 구성이 Docker Compose로 돈다. 설치, 마이그레이션, 로그 확인, 재시작, 완전 삭제는 Make 대상으로 처리한다. ARM 이미지가 있어 Apple Silicon 노트북에서도 돌아간다. API 키와 대화 로그, 고객 데이터는 직접 관리하는 인프라에 머문다.
TypeScript SDK와 백엔드 API
백엔드는 8888번 포트에서 대기하며 자체 엔드포인트도 노출한다. 스크립트나 다른 서비스에서 코파일럿을 조작할 수 있다. 별도 TypeScript SDK는 같은 호출을 프런트엔드용으로 감싸므로 셀프 호스팅 AI 코파일럿을 기본 위젯 밖에서도 쓸 수 있다.
장단점
장점
- MIT 라이선스라 사용자당 과금도 메시지당 과금도 없다. 사용량이 늘어도 비용이 예측된다.
- Swagger OpenAPI 불러오기 덕분에 엔드포인트를 모델에 설명하는 수작업이 거의 사라진다.
- 셀프 호스팅이라 고객 대화와 API 자격 증명이 자체 네트워크 안에 남는다.
- 코파일럿 플로우는 요청과 엔드포인트를 단순 대응시키는 방식이 실패하는 다단계 작업을 처리한다.
- 위젯과 대시보드, 백엔드가 한 저장소에 있어 데모 전에 연결 코드를 쓸 필요가 없다.
단점
- 프로젝트가 아카이브되어 유지보수가 없다. 보안 패치도 없고 의존성이 깨져도 고쳐 줄 사람이 없다.
- API가 크면 JSON 변환기를 직접 써야 한다. 불러오기만 하면 된다는 약속은 작은 규모에서만 성립한다.
- 설치에 Docker 활용 능력, OpenAI 키, 명령줄 사용 경험이 필요하다.
- 오픈소스 저장소와 나란히 있던 클라우드 버전은 종료됐다. 지금은 오래된 이슈를 읽는 것이 지원의 전부다.
자주 묻는 질문
기존 제품 API 앞에 채팅 인터페이스를 붙이는 도구다. OpenAPI 정의를 읽고 사용자 요청에 따라 엔드포인트를 골라 결과를 임베드형 채팅 위젯 안에 글로 돌려준다.
관련 콘텐츠
OpenCopilot와 관련된 도구, 스킬, 아티클을 살펴보세요.
OpenCopilot 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.