localgpt-app/localgpt
Local AI assistant, dreaming explorable worlds.
LocalGPT – AI 우선 3D 월드 빌더 및 로컬 전용 어시스턴트
개요 – Rust 기반의 단일 바이너리 애플리케이션으로 다음 기능을 제공합니다:
- 탐색 가능한 3D 장면 생성: Bevy 게임 엔진을 사용하여 자연어 프롬프트로부터 생성합니다(
localgpt-gen). - 로컬 AI 어시스턴트 실행: 지속적이고 검색 가능한 메모리, 자율적인 백그라운드 작업, 초경량 HTTP API를 갖추고 있습니다(
localgpt).
두 구성 요소 모두 사용자의 기기에서 완전히 실행되며(Docker, Node, Python 불필요), 지정한 모든 LLM(Ollama, LM Studio, OpenAI, Anthropic 등)과 연동할 수 있습니다.
빠른 시작 (사용자용)
# 월드 빌더 바이너리 설치
cargo install localgpt-gen
# 어시스턴트 바이너리 설치
cargo install localgpt
프롬프트 기반 장면 실행:
localgpt-gen "Create a desert scene with pyramids and a UFO hovering above"
채팅 어시스턴트 시작:
localgpt chat # 대화형 REPL
localgpt ask "What is the meaning of life?"
localgpt daemon start # HTTP API + Web UI 실행
핵심 기능
| 구성 요소 | 주요 특징 |
|---|---|
| Gen 모드 | 파라메트릭 프리미티브, PBR 재질, 조명, 동작(궤도, 회전, 경로 추적), 환경음, glTF/GLB 또는 HTML 내보내기, 헤드리스 배치 모드, IDE 통합용 MCP 서버 |
| AI 어시스턴트 | Markdown 기반 지속적 지식 저장소, 전체 텍스트 + 의미론적 검색(SQLite FTS5 + sqlite-vec), 자율 하트비트 작업 큐, 다중 인터페이스(CLI, Web UI, 데스크톱 GUI, 모바일), 샌드박스 실행(Landlock/seccomp, Seatbelt), 프롬프트 주입 방어 |
| LLM 지원 | 모든 로컬 또는 클라우드 제공업체와 호환 – LM Studio, Ollama, Anthropic, OpenAI, xAI, GLM, Vertex AI 및 범용 CLI 제공업체 |
| 보안 | 커널 강제 샌드박스, HMAC 서명 정책 파일, 감사 체인 로그 |
| 확장성 | 스킬 시스템 – 월드 전체를 재사용 가능한 "스킬"로 저장할 수 있으며, 메모리 시스템이 세션을 통해 사용자의 스타일(팔레트, 조명, 템플릿)을 학습합니다 |
일반적인 사용 사례
- 게임 또는 VR을 위한 빠른 프로토타이핑 – 평이한 영어로 장면을 설명하고 즉시 실행 가능한 Bevy 프로젝트를 얻습니다.
- 창의적인 브레인스토밍 – 헤드리스 모드에서 여러 변형을 반복 생성하여 배치 처리나 CI 파이프라인에 활용합니다.
- 개인 지식 어시스턴트 – 메모, 코드 조각, 연구 내용을 로컬의 검색 가능한 메모리에 저장하고 CLI나 HTTP를 통해 쿼리합니다.
- 자동화 – 데몬의 하트비트를 사용하여 사용자 개입 없이 백그라운드 작업(웹 데이터 가져오기, 월드 업데이트 등)을 실행합니다.
작동 원리
- Rust + Tokio – 데몬과 생성기 모두를 위한 비동기 런타임.
- Bevy – 3D 장면을 구성하는 ECS 기반 게임 엔진.
- SQLite – Markdown 메모 저장; FTS5는 키워드 검색,
sqlite-vec은 임베딩 기반 의미론적 검색(fastembed로 생성)에 사용. - Axum – Web UI 및 JSON 엔드포인트를 제공하는 경량 HTTP 서버.
- eframe – 선택적 네이티브 GUI 프론트엔드.
문서 및 커뮤니티
- 전체 문서 – https://localgpt.app/docs
- Discord – https://discord.gg/spKRr6mRyp
- YouTube 데모 – https://www.youtube.com/watch?v=R__tg7YY0T8
- 블로그 게시물 – "스킬로서의 월드" 개념과 4일 밤에 걸친 신속한 개발 이야기를 설명합니다.
라이선스
Apache-2.0 – 개인 및 상업적 용도로 무료 사용 가능.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트