RagLeap Core v0.10.1 — Windows가 모든 것을 망친 후 44분 만에 두 개의 버전을 배포하다
요약
RagLeap Core v0.10.1 버전이 배포되면서, 특히 Windows 환경에서 발생한 실제 버그를 수정하고 기능을 강화했습니다. 주요 업데이트로는 포트 관리가 설정으로 통합되었고, API 키 로테이션 기능과 브라우저 기반 대시보드 접근 방식이 도입되었습니다. 이는 개발자들이 보다 안정적이고 체계적으로 시스템을 구축할 수 있도록 돕습니다.
핵심 포인트
- 포트 충돌 문제를 해결하고 모든 포트를 설정에서 관리합니다.
- 새로운 `ragleap key --rotate` 명령어로 API 키를 안전하게 순환(Rotate)할 수 있습니다.
- 데스크톱 환경에서는 브라우저 기반 대시보드를 사용하며, 서버/SSH 환경에서도 접근이 가능합니다.
- 로그인 제한 및 Setup 탭 추가로 보안과 시스템 구성 관리가 강화되었습니다.
ragleap-core v0.10.0을 로그인 제한(login throttling), Setup 탭, 그리고 코딩 에이전트를 위한 읽기 전용 스킬과 함께 배포했습니다. 44분 후에는 v0.10.1을 배포했습니다.
왜일까요? Docker Desktop으로 진행한 첫 실제 Windows 테스트 때문입니다.
로컬 PostgreSQL이 이미 포트 5433에 있었습니다. 설치 프로그램이 멈췄습니다. 그게 다였습니다.
이것이야말로 AI 분야에서 얻을 수 있는 가장 솔직한 버그 보고서일 것입니다.
v0.10.0에서 배포된 내용 (강화):
- 로그인 제한(Login throttling): 5분 동안 나쁜 API 키를 10개 사용 → Retry-After와 함께 15분간 429 잠금 적용. TRUSTED_PROXIES를 통해 프록시 인식 가능하며, AUTH_THROTTLE=off로 비활성화 가능
- Setup 탭 + GET /setup/status: 구성되었거나 누락된 항목을 표시하며, 비밀 정보는 절대 보여주지 않고 AI 호출은 없습니다.
- 코딩 에이전트를 위한 읽기 전용 스킬: manifest와 작은 클라이언트(건강 상태, 직원 목록, 질문)로 구성되어 있습니다. 설계상 아무것도 변경할 수 없습니다.
- Ollama 컨텍스트 8192 기본값: 긴 문서가 더 이상 조용히 잘리지 않습니다.
- 설치 프로그램 확인: 무료 디스크 공간 확인(로컬 AI의 경우 4GB / 14GB), Compose 프로젝트 이름이 이미 사용된 경우 거부, Win/Mac에서 실행 중인 Ollama 앱을 사용할 수 있습니다. install.ps1 PowerShell 설치 프로그램 추가
- 보안: 모든 타사 GitHub Action은 정확한 커밋에 고정(pinned)됩니다.
v0.10.1에서 배포된 내용 (Windows 현실):
여기가 진짜입니다.
- 프리 호스트 포트 (Free host ports): 모든 포트는 이제 설정으로 관리됩니다 — APP_PORT 8000, DB_PORT 5433, VOICE_PORT 8766, NEO4J 7475/7688, REDIS 6380. 새 설치 시, 설치 프로그램은 사용 가능한 다음 포트를 선택하고, .env 파일에 기록하며, 대시보드 링크를 위해 이를 사용합니다. 기존 .env 파일은 변경되지 않습니다.
- ragleap key --rotate: 새로운 무작위 API 키를 .env 파일에 작성하고, 앱만 재시작하며, 이전 키가 거부되고 새 키가 승인되는지 확인한 후, 새 링크를 출력합니다. DB는 건드리지 않습니다.
- 출력된 키 대신 브라우저 사용: 데스크톱(Win/Mac/Linux 및 디스플레이가 있는 경우, SSH 아님)에서는 브라우저에서 대시보드를 열고 터미널에 키가 표시되지 않습니다. 서버/SSH/CI 환경에서는 여전히 링크를 출력합니다. 항상 출력하려면 RAGLEAP_NO_BROWSER=1을 사용하세요.
- 수정된 사항 (Fixed): DB 존재 확인이 이름만 같은 모든 Docker 볼륨(관련 없는 설치 포함)과 일치하던 문제가, 이제 이 설정의 볼륨에만 일치하도록 수정되었습니다. API 문서에는 x-api-key 헤더가 필요하다고 명시되어 있습니다 (설계상 401 에러).
솔직한 제한 사항 (Honest limits) (릴리스 노트에 기재):
- Docker Desktop이 설치된 Windows 머신에서 테스트되었으며, Gemini/Ollama/skip 메뉴는 건너뛰도록 설정되었습니다. Ollama은 아직 Windows에서 테스트되지 않았습니다.
- irm ... | iex 한 줄 명령어는 해당 머신에서 실패할 수 있으며, 원인은 알려지지 않았습니다. 두 단계로 사용하세요: $s = irm ; iex $s
- PATH 힌트는 PowerShell이 아닌 bash용으로 작성되었습니다.
- Windows 예약 제외 범위는 busy-port 확인 기능에 의해 감지되지 않습니다.
- 브라우저가 실행되는 동안, 키가 프로세스 목록에 잠시 표시될 수 있습니다.
RagLeap Core란 무엇인가요?
자체 호스팅 AI 비즈니스 OS — 46개의 자율 AI 직원 (9개 코어 + 리크루터, 부동산 에이전트, 법률 접수 등 37개 수직 분야), 그래프 RAG (Neo4j), 다중 채널(WhatsApp/Telegram/Discord/음성), BYOK 19개 제공업체 + Ollama 로컬, MIT 라이선스.
curl -fsSL https://ragleap.com/install.sh | bash
또는 Windows
$s = irm https://ragleap.com/install.ps1; iex $s
18 stars → 20⭐️ 목표
GitHub: github.com/antonyrag/ragleap-core
Website: ragleap.com
공개적으로 빌드 중
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기