JARVIS

Claude Code로 Ubuntu VPS를 텍스트나 음성으로 관리하는 Telegram 봇. 위험한 명령을 확인하는 ‘소크라테스 게이트’ 탑재.

JARVIS MK1 Lite는 Ubuntu VPS의 Claude Code SDK에 안전하게 접근할 수 있게 해 주는 미니멀한 Telegram 봇(aiogram)입니다. 위험한 명령은 ‘Socratic Gate’를 거칩니다. 위험도는 네 단계(SAFE / MODERATE / DANGEROUS / CRITICAL)이며, CRITICAL 명령에는 정확한 확인 문구가 필요합니다. 음성 메시지는 Telegram Premium으로 텍스트로 변환되고, 봇은 실행 전에 확인 질문을 합니다. 버전 1.3.x는 운영 VPS에서 가동되었으며(CHANGELOG에 2026-02-09 장애와 그 수정 내용이 기록되어 있습니다), 기능을 줄인 공개 버전을 MIT 라이선스로 게시했습니다.

과제

SSH를 열지 않고 휴대폰으로 서버를 관리하고 에이전트 작업을 실행하며, 파괴적인 명령이 실수로 실행되는 것을 막는 것.

주요 기능

• Telegram ID 허용 목록에서만 접근 가능, 요청 속도 제한(토큰 버킷)
• Socratic Gate: 명령 위험도 평가와 확인. V2는 2단계 의도 확인(음성 메시지에는 Claude Haiku의 확인 질문, 텍스트는 선택 사항)
• Telegram Premium(Telethon)을 통한 음성 메시지와 원형 영상 메시지 지원
• 파일 처리: PDF와 텍스트(PyMuPDF), 파일 회신, Telegram 제한에 맞춘 긴 답변의 스마트 분할
• 만료와 LRU 방식 제거를 지원하는 세션, /status, /metrics, /new 명령, 모델 전환
• 운영 환경 구성: 구조화된 로그(structlog), 헬스체크, systemd 유닛과 설치 스크립트

기계 번역입니다. 현재 검수 중입니다.