beclab/Olares

Olares – AI 에이전트를 위한 자체 호스팅 개인용 클라우드 OS

정의 – Olares는 자체 머신을 AI 에이전트와 대규모 언어 모델을 실행하기 위한 프라이빗 클라우드로 전환하는 오픈소스 플랫폼입니다. Kubernetes 기반 스택(K3s, Kubesphere 등)과 즉시 사용 가능한 일련의 시스템 앱(Files, Vault, Market, Dashboard, Control Hub) 및 모든 브라우저에서 접근 가능한 웹 UI를 번들로 제공합니다. 목표는 개인이나 소규모 팀에게 퍼블릭 클라우드 AI 서비스의 편의성을 제공하면서도 모든 데이터와 컴퓨팅을 제어하는 하드웨어에 유지하는 것입니다.

핵심 구성 요소

구성 요소	역할
olaresd(데몬)	서비스, 스토리지, 네트워킹 및 GPU 리소스를 오케스트레이션하는 핵심 시스템 프로세스.
olares-cli	AI 에이전트(예: Lares, OpenClaw)가 플랫폼에 명령을 내릴 수 있도록 하는 에이전트 스킬을 갖춘 명령줄 도구.
앱 디렉토리	클러스터에서 컨테이너로 실행되는 내장 SaaS 스타일 앱(Files, Vault, Market 등).
인프라 계층	컴퓨팅(GPU 풀링, 시간/메모리 슬라이싱), 스토리지(JuiceFS, MinIO, Seafile) 및 네트워킹(Envoy, Tailscale/HeadScale VPN)을 처리합니다.
플랫폼 계층	상위 앱을 지원하는 데이터베이스, 메시지 큐, 운영자와 같은 클라우드 네이티브 서비스.

주요 기능(README에 설명된 대로)

원클릭 로컬 AI – 내장된 Olares Market에서 오픈소스 AI 앱과 모델을 원클릭으로 설치합니다.
GPU 풀링 및 슬라이싱 – 전용, 시간 슬라이스 또는 메모리 슬라이스 옵션으로 노드 간에 가속기를 공유합니다.
통합 파일 및 스토리지 관리 – Files 앱을 통해 로컬 디스크, 동기화 폴더, 클라우드 버킷, SMB/NFS 공유에 액세스합니다. 구성 가능한 백업이 내장되어 있습니다.
프라이빗 네트워킹 및 액세스 제어 – 자동 VPN, 리버스 프록시, HTTPS 엔드포인트. 개별 포트를 수동으로 노출할 필요가 없습니다.
언제 어디서나 액세스 – 웹 UI는 데스크톱, 휴대폰, 태블릿에서 작동합니다.
시스템 앱 제품군 – Files, Vault(비밀 저장소), Market(앱 카탈로그), Dashboard, Control Hub 및 Lares와 같은 AI 중심 에이전트.
에이전트 기반 운영 – AI 에이전트는 CLI의 에이전트 스킬을 통해 플랫폼을 제어할 수 있습니다(예: "이 기기의 구성을 확인해줘").

시작하기

하드웨어 요구 사항 – 4 CPU 코어, ≥8GB RAM, ≥150GB SSD(HDD는 지원되지 않음). GPU는 선택 사항이지만 로컬 모델 가속화에 도움이 됩니다.
설치 – Ubuntu 22.04-25.04 또는 Debian 12/13에서 원라이너를 실행합니다:
```
curl -fsSL https://olares.sh | bash -
```
– 또는 새 설치용 ISO 이미지, 컨테이너 전용 배포용 Docker-Compose를 사용합니다.
첫 번째 AI 작업 – AI 온보딩 가이드에 따라 Router, Lares 어시스턴트 및 로컬 모델을 설정한 다음 대화를 시작합니다(예: "이 기기의 구성을 확인해줘").

일반적인 사용 사례

연구, 파일 처리 및 자동화를 위한 개인 AI 어시스턴트.
데이터를 제3자 서비스로 보내지 않고 생성형 AI(채팅, 이미지/비디오 생성)를 로컬에서 실행.
자체 호스팅 허브에서 홈 오토메이션 및 미디어 스트리밍.
격리된 환경에서 에이전트 애플리케이션 개발, 테스트 및 배포.
로컬 오디오 처리: 전사, 번역, 텍스트 음성 변환.
가족 또는 소규모 팀을 위한 협업 자체 호스팅 워크스페이스(문서, 프로젝트 관리, 커뮤니케이션).
동기화, 백업 및 안전한 액세스를 갖춘 중앙 집중식 개인 데이터 저장소.

아키텍처 개요

Olares는 오픈소스 대안으로 퍼블릭 클라우드 스택(IaaS → PaaS → SaaS)을 미러링합니다:

IaaS 계층 – K3s/Kubesphere가 컴퓨팅, 스토리지 및 네트워킹을 추상화하는 Kubernetes 클러스터를 제공합니다.
PaaS 계층 – 프레임워크 서비스(데이터베이스, 메시지 큐, 운영자)가 클러스터에서 실행되어 상위 앱을 지원합니다.
SaaS 계층 – 시스템 앱(Files, Vault, Market, Dashboard)이 웹 UI와 API를 통해 사용자 지향 기능을 노출합니다. 저장소의 다이어그램은 JuiceFS, MinIO, Envoy, Tailscale 및 LangChain과 같은 구성 요소가 이러한 계층에 어떻게 맞는지 시각화합니다.

커뮤니티 및 기여

Discord 및 포럼 – 지원, 배포 팁 및 워크플로 논의를 위한 주요 장소.
GitHub – 버그/기능 요청용 이슈, 핵심 코드, 문서 또는 새 마켓 앱용 PR.
CLI 에이전트 스킬 – 개발자는 olares-cli를 확장하여 AI 에이전트가 프로그래밍 방식으로 플랫폼을 관리할 수 있도록 할 수 있습니다.
라이선스 – AGPL-3.0. 하위 사용자를 보호하면서 개방형 협업을 장려합니다.

TL;DR

Olares는 Kubernetes 기반 개인용 클라우드 OS로, 자체 하드웨어에서 AI 에이전트와 LLM을 실행할 수 있게 해줍니다. 통합 UI, GPU 풀링, 프라이빗 네트워킹 및 즉시 설치 가능한 AI 앱 마켓플레이스를 제공하여 자체 호스팅 생성형 AI를 개인과 소규모 팀이 사용할 수 있도록 합니다.