shader-agent

Shader Agent는 셰이더 생성, 검토, 검증 및 내보내기를 위해 재현 가능하고 오프라인으로 작동하는 워크플로우가 필요한 크리에이터와 유지관리자를 위해 설계된 로컬 우선 소프트웨어 툴킷입니다. 이 도구는 Python CLI, 로컬 Web UI, FTS5를 지원하는 SQLite 기반 참조 검색, 라이선스 인식 필터링, 렌더 검증 게이트, 그리고 Shadertoy, WebGL, LÖVE 2D 및 오프라인 비디오 제작과 같은 플랫폼에 맞춤화된 내보내기 헬퍼를 결합합니다. 이 툴은 기본적으로 외부 API 키 없이도 결정론적인 GLSL 초안 생성을 지원합니다. 선택 사항인 AI 생성 기능은 환경 변수나 세션 전용 UI 입력을 통해 활성화할 수 있으며, OpenAI 호환, OpenAI, Anthropic, Gemini 및 Ollama 제공업체를 지원합니다. 사용자는 모델, 기본 URL, 재시도, 캐시 및 동시성 등의 AI 설정을 환경 변수를 통해 구성할 수 있으며, 실제 키를 커밋해서는 안 됩니다. 주요 기능으로는 JSONL로부터 셰이더 메타데이터/코드 수집, 렌더 피드백을 통한 다중 후보 반복 생성, 구문, mainImage 형태, 라이선스 준수 및 스모크 테스트를 위한 프리플라이트 체크, 그리고 Shadertoy 및 LÖVE 2D와 호환되는 내보내기 패키지가 포함됩니다. Web UI는 라이브 WebGL 미리보기, 편집 가능한 코드, 비파괴적 반복을 위한 노드 그래프, 그리고 설정 가능한 FPS, 해상도 및 믹싱을 통한 프레임 또는 비디오 내보내기 컨트롤을 제공합니다. 또한 프로젝트화된 출력물, 참조 감사, /search, /export, /repair-ai와 같은 명령어를 포함하는 CLI 채팅 모드를 제공합니다. 아키텍처는 모듈식으로 구성되어 있습니다: 커맨드 라인 진입점인 cli.py, 로컬 서버를 위한 webapp.py, 오케스트레이션을 위한 agent.py, 저장 및 검색을 위한 store.py, 제공업체 라우팅을 위한 llm.py, 검증 게이트를 위한 quality.py, 그리고 플랫폼별 어댑터를 위한 targets/로 나뉩니다. 이 프로젝트는 Bilibili와 YouTube에 게시된 22편의 셰이더 기반 VFX 비디오 제작에 사용되어, 단순한 실험을 넘어선 장기적인 실무 활용 가능성을 입증했습니다. 테스트에는 유닛 테스트, 수락 스크립트 및 브라우저 UI 검증이 포함됩니다. ufbx와 같은 서드파티 컴포넌트는 MIT 라이선스 하에 번들로 제공됩니다. 보안 가이드는 API 키, 프라이빗 프롬프트, 생성된 미디어 및 데이터베이스를 공개 이슈나 PR에 포함하지 않을 것을 강조합니다. 로드맵에는 공개 저장소 게시, CI 배지 추가, 스크린샷/GIF 호스팅, 렌더 검증 개선, 그리고 무거운 테스트와 빠른 PR 체크의 분리가 포함되어 있습니다. MIT 라이선스로 배포됩니다.