✦ StarNion

Personal AI Agent Platform — Self-hosted, privacy-first AI that runs on your own infrastructure.

Get Started GitHub

---

Choose Your Language

	Language	Documentation
🇰🇷	한국어	문서 보기
🇺🇸	English	View Docs
🇨🇳	中文	查看文档
🇯🇵	日本語	ドキュメントを見る

---

What is StarNion?

StarNion is a self-hosted personal AI agent platform. All your data stays on your own server while AI helps you manage your daily life more smartly.

Feature	Description
Multi-channel	Web UI · Telegram bot · WebSocket real-time chat
Finance	Natural language expense tracking & budget management
Memory & RAG	Semantic memory across all your data
24+ Features	Finance · Diary · Goals · Memos · Garden · Wellness · and more
System Scheduler	Per-user toggleable notification jobs
Multi-LLM	Anthropic Claude · Gemini · OpenAI · GLM · Ollama
Language Preference	AI responds in your chosen language (ko/en/ja/zh)
Multimodal	Image analysis · audio transcription · document parsing
Privacy-first	All data on your own PostgreSQL + MinIO
Personas	Custom AI personalities per conversation

---

Architecture

┌──────────────────────┐   ┌──────────────────────┐
│   Web UI (Next.js)   │   │   Telegram Bot        │
│   localhost:3893     │   │   (polling)           │
└──────────┬───────────┘   └──────────┬────────────┘
           │                          │
           ▼                          ▼
┌──────────────────────────────────────────────────┐
│              Go Gateway  :8080                    │
│  REST API  ·  WebSocket  ·  Cron Scheduler        │
│                  │ gRPC                           │
└──────────────────┼───────────────────────────────┘
                   ▼
┌──────────────────────────────────────────────────┐
│           TypeScript Agent  :50051                │
│  AI SDK v5  ·  Multi-LLM  ·  Skills  ·  RAG      │
└──────────────────┬───────────────────────────────┘
                   ▼
         PostgreSQL 16 + pgvector
                   │
                   ▼
              MinIO (S3)

---

Quick Install

Prerequisites: Node.js 20+, pnpm, uv, Docker

npm install -g pnpm
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://jikime.github.io/starnion/install.sh | bash

Supports macOS (Apple Silicon & Intel) and Linux (amd64 & arm64).

After installation:

starnion setup   # Initial setup wizard (7 steps)
starnion start   # Start all services

Verify:

curl http://localhost:8080/healthz
# {"status":"ok"}