프로젝트 소개

이 저장소는 Proxmox VM 및 LXC 컨테이너에서 홈랩 AI/LLM 인프라를 구축하기 위한 Ansible 역할 세트를 제공합니다. 이는 더 큰 ansible-proxmox-apps 컬렉션에서 추출되었으며 AI 스택에 구체적으로 집중합니다. 역할은 다음과 같은 여러 기능 영역으로 구성됩니다: - **LLM serving**: ollama (모델 서버), llama_cpp 및 llama-swap (GPU 계층), llm_router (OpenAI 호환 프런트 도어로서의 LiteLLM 프록시), open_webui (채팅 프런트엔드). - **RAG**: llamaindex (Python + Ollama CPU 전용 임베딩 파이프라인) 및 qdrant_docker (벡터 데이터베이스). - **Agents**: hermes_agent (NousResearch 에이전트 게이트웨이), agent_exec (샌드박스 실행), agentgateway_docker, codex_runner (격리된 Codex CLI 사용자). - **LLM app platforms**: Dify, LangFlow, LangGraph, Langfuse, Arize Phoenix (모두 Docker 기반). - **Ops**: fabric_watchdog (Hermes 게스트에서 에이전트 패브릭을 조사하고 Slack으로 알림을 보내는 systemd 타이머). 개발 도구는 Nix flake 및 direnv를 통해 관리되며, ansible-core, ansible-lint, molecule, sops 및 관련 유틸리티를 제공합니다. 개별 역할에 대해 린팅 및 molecule 기반 테스트(Docker 사용)가 가능합니다. 현재는 역할만 제공되며, 사이트 수준의 플레이북과 인벤토리 로더가 후속 계획으로 예정되어 있습니다. 이 프로젝트는 conventional commits와 git-flow 브랜칭 모델(develop 브랜치)을 사용합니다. Apache 2.0 라이선스 하에 제공됩니다.