StarNion이란?

목차

개요

StarNion은 완전히 자체 호스팅(self-hosted)되는 개인용 AI 어시스턴트 플랫폼입니다. 모든 데이터와 AI 인터랙션이 여러분의 인프라에서 실행되며, 어떠한 데이터도 외부 서버로 전송되지 않습니다.

클라우드 AI 서비스의 편리함을 유지하면서도, 개인 정보와 데이터 주권을 완전히 제어할 수 있도록 설계되었습니다.


핵심 개념

개인 AI 에이전트

StarNion의 AI 에이전트는 단순한 챗봇 이상입니다. Vercel AI SDK v5를 기반으로 멀티 LLM 백엔드를 사용하여 복잡한 작업을 단계적으로 처리하는 지능형 에이전트입니다.

  • 멀티 LLM 지원: Anthropic Claude · Google Gemini · OpenAI · GLM (Z.AI) · Ollama
  • 스킬 시스템: 24+ 내장 스킬 — 가계부, 일기, 목표, 웰니스, 검색 등
  • RAG 기반 메모리를 통한 대화 컨텍스트 관리
  • 페르소나: 맥락별 AI 성격 설정 가능

프라이버시 우선

내 데이터 = 내 인프라에만 저장
  • 모든 대화 기록은 나의 PostgreSQL 데이터베이스에 저장
  • LLM API 호출 시 필요 최소한의 정보만 전송
  • 파일, 이미지, 오디오는 나의 MinIO 스토리지에 보관
  • 타사 분석 서비스나 트래킹 코드 없음

자체 호스팅

내 서버에서 실행 = 완전한 제어권
  • starnion dev 한 명령으로 전체 스택 실행
  • 클라우드, 온프레미스, 홈 서버 어디서나 운영 가능
  • Ollama를 통한 로컬 AI 모델 지원 (인터넷 불필요)
  • 데이터 백업과 마이그레이션을 직접 제어

주요 기능

기능 설명
멀티 LLM Anthropic Claude · Gemini · OpenAI · GLM · Ollama
웹 UI Next.js 16 기반 24+ 기능 페이지
텔레그램 Telegram 봇을 통한 AI 채팅
다국어 UI 4개 언어 (한국어 · 영어 · 일본어 · 중국어)
가계부 자연어로 수입/지출 기록 및 조회
예산 관리 월별 예산 설정 + 초과 알림
일기 AI 보조 일기 작성 + 감정 추적
목표 관리 개인 목표 설정 및 체크인
디데이 중요한 날짜 카운트다운
메모 태그 필터링이 있는 빠른 메모
데이터 가든 활동 데이터 시각화 정원
마음 정원 기분/웰니스 체크인
리포트/통계 자동 주기 요약 및 차트
페르소나 맥락별 AI 성격 설정
스킬 관리 AI 도구 스킬 활성화/비활성화
웹 검색 AI 기반 실시간 웹 검색
AI 기억 모든 데이터에 걸친 시맨틱(RAG) 메모리
파일 관리 문서·이미지·오디오 업로드 및 분석
알림 센터 사용자별 크론 작업 (예산 알림, 일일 요약 등)
사용량 분석 LLM 토큰 사용량 및 비용 추적

아키텍처

┌──────────────────────┐   ┌──────────────────────┐
│   Web UI (Next.js)   │   │   Telegram Bot        │
│   localhost:3893     │   │   (polling)           │
└──────────┬───────────┘   └──────────┬────────────┘
           │                          │
           ▼                          ▼
┌──────────────────────────────────────────────────┐
│              Go Gateway  :8080                    │
│  REST API  ·  WebSocket  ·  크론 스케줄러         │
│                  │ gRPC (스트리밍)                │
└──────────────────┼───────────────────────────────┘
                   ▼
┌──────────────────────────────────────────────────┐
│           TypeScript Agent  :50051                │
│  AI SDK v5  ·  멀티 LLM  ·  스킬  ·  RAG 메모리  │
└──────────────────┬───────────────────────────────┘
                   ▼
         PostgreSQL 16 + pgvector
                   │
                   ▼
              MinIO (S3)

컴포넌트 설명

컴포넌트 역할 기술 스택
Web UI 웹 인터페이스 + 인증 Next.js 16 · React 19 · TypeScript · NextAuth v5
Gateway REST API · WebSocket · Telegram · 크론 Go 1.22+ · Echo v4
Agent AI 엔진 · gRPC 서버 · 스킬 실행 TypeScript · AI SDK v5 · gRPC
PostgreSQL 메인 데이터베이스 · 벡터 검색 PostgreSQL 16 + pgvector
MinIO 파일 스토리지 MinIO (S3 호환)
CLI 서비스 관리 · 설정 마법사 Go

누구에게 적합한가요?

개인 사용자

  • 대화 기록을 클라우드에 맡기지 않고 완전한 제어권을 원하는 분
  • AI와 함께 일기, 메모, 목표, 가계부를 한 곳에서 관리하고 싶은 분
  • Telegram을 통해 어디서나 개인 AI 어시스턴트에 접근하고 싶은 분

개발자 / 기술 사용자

  • 자신만의 AI 플랫폼을 구축하고 싶은 개발자
  • 스킬 시스템을 통해 커스텀 기능을 추가하고 싶은 분
  • AI 에이전트 아키텍처를 공부하는 분

적합하지 않은 경우

  • 서버 관리 없이 즉시 사용 가능한 클라우드 서비스를 원하는 경우 → ChatGPT, Claude.ai 등을 권장합니다
  • 수백 명 이상의 동시 사용자가 필요한 경우 → 추가 스케일링 작업이 필요합니다

다음 단계


Copyright © 2025 StarNion. All rights reserved.  |  v0.1.1