Antigravity-Model-Reset-Timer: LLM API 할당량 관리를 위한 경량 데스크톱 앱

섹션별 상세

Target Timestamp Architecture는 기존 타이머 앱들이 백그라운드 루프를 사용하여 CPU와 배터리를 소모하는 문제를 해결한다. 절대적인 미래 만료 시간을 UTC로 계산하여 MongoDB에 저장하고, GUI가 활성화될 때만 OS 하드웨어 클록과 비교하여 남은 시간을 계산한다. 이 방식은 백그라운드 CPU 점유율을 0%에 가깝게 유지하며 시스템 재부팅 후에도 타이머가 정확히 유지되는 장점이 있다.

Electron의 무거운 리소스 사용을 피하기 위해 Python 기반의 PyWebView를 사용하여 네이티브 OS 창을 래핑했다. 백엔드는 Django와 Djongo를 사용하여 상태 관리를 수행하며, 프런트엔드는 프레임워크 오버헤드가 없는 Vanilla JS와 HTML로 구성하여 반응성이 뛰어난 UI를 제공한다. 이는 Python 커뮤니티에서 Electron을 대체할 수 있는 가벼운 데스크톱 앱 구축 사례를 제시한다.

프로젝트는 향후 Google AI Studio나 Anthropic API의 할당량을 직접 폴링하는 자동 텔레메트리 기능을 계획하고 있다. 또한 자율 에이전트가 로컬 REST/WebSocket IPC를 통해 자신의 '연료 상태'인 API 할당량을 읽고 워크플로를 스스로 조절할 수 있는 기능을 목표로 한다. 현재 VS Code 확장 프로그램이나 CLI 플러그인으로의 이식 작업에 참여할 기여자를 찾고 있다.

용어 해설

타겟 타임스탬프 아키텍처(Target Timestamp Architecture): — 미래의 특정 만료 시점을 고정된 타임스탬프로 저장하고 현재 시간과의 차이만 계산하는 설계 방식이다. 지속적인 백그라운드 루프나 크론잡 없이도 정확한 남은 시간을 추적할 수 있어 CPU 자원과 배터리 소모를 획기적으로 줄인다.
파이웹뷰(PyWebView): — Python 객체를 JavaScript와 연결하여 웹 기술(HTML/JS/CSS)로 데스크톱 GUI를 만들 수 있게 해주는 경량 라이브러리이다. Electron과 달리 시스템 네이티브 창을 활용하므로 메모리 점유율이 낮고 실행 파일 크기가 작다.
API 텔레메트리(API Telemetry): — 원격 API 서비스로부터 사용량, 남은 할당량, 리셋 시간 등의 데이터를 자동으로 수집하고 전송하는 기술이다. LLM 개발 시 여러 모델의 API 제한 상태를 실시간으로 모니터링하여 워크플로 중단을 방지하는 데 필수적이다.

코드 예제

bash

git clone https://github.com/PeterJFrancoIII/Antigravity-Model-Reset-Timer.git
cd Antigravity-Model-Reset-Timer
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

프로젝트 복제 및 가상 환경 설정과 의존성 설치 과정

python

python3 launcher.py

애플리케이션 실행 명령

기술

Python
Django
MongoDB
PyWebView
Vanilla JS

활용 사례

LLM API 할당량 실시간 모니터링
AI 에이전트의 자율적 사용량 제어
경량 데스크톱 API 대시보드 구축

언급된 리소스

GitHubAntigravity-Model-Reset-Timer GitHub Repository