StarNionとは

目次

• 概要
• コアコンセプト
  • パーソナルAIエージェント
  • プライバシーファースト
  • セルフホスティング
• 主要機能
• アーキテクチャ
  • コンポーネント説明
  • データフロー
• 技術スタック
  • バックエンド
  • フロントエンド
  • インフラストラクチャ
• 対象ユーザー
  • 個人ユーザー
  • 開発者・技術ユーザー
  • 向いていない方
• 次のステップ

---

概要

StarNion は完全にセルフホスティング可能なパーソナルAIアシスタントプラットフォームです。すべてのデータとAIのやり取りはご自身のインフラ上で動作し、承認されたLLM API呼び出し以外で外部サーバーにデータが送信されることは一切ありません。

クラウドAIサービスの利便性を保ちながら、個人情報とデータ主権を完全にコントロールできるよう設計されています。

---

コアコンセプト

パーソナルAIエージェント

StarNionのAIエージェントは、単純なチャットボット以上の存在です。Vercel AI SDK v5をベースにマルチLLMバックエンドで複雑なタスクをステップごとに処理するインテリジェントなエージェントです。

• マルチプロバイダーLLM: Anthropic Claude、Google Gemini、OpenAI、GLM (Z.AI)、Ollama
• スキルシステム: 24以上の組み込みスキル — finance、diary、goals、wellness、searchなど
• 会話コンテキスト管理: RAGベースのメモリ
• ツールコール: エージェントがスキル関数を自律的に実行
• ペルソナ: コンテキストごとに設定可能なカスタムAIパーソナリティ

プライバシーファースト

あなたのデータ = あなたのインフラのみに保存

• すべての会話履歴はご自身のPostgreSQLデータベースに保存
• LLM API呼び出し時には必要最低限のテキストのみを送信
• ファイル、画像、音声はご自身のMinIOストレージに保管
• サードパーティの分析サービスやトラッキングコードは一切なし

セルフホスティング

自分のサーバーで動作 = 完全なコントロール

• スタック全体を単一の starnion dev コマンドで起動可能
• クラウド、オンプレミス、ホームサーバーなど、どこでも動作
• Ollamaを使用してローカルAIモデルをサポート（インターネット不要）
• データのバックアップとマイグレーションを直接コントロール

---

主要機能

機能	説明
マルチLLM	Anthropic Claude · Gemini · OpenAI · GLM · Ollama
Web UI	Next.js 16ウェブインターフェース、24以上の機能ページ
Telegramチャンネル	Telegramボットを通じたAIチャット
i18n	4言語UI（韓国語・英語・日本語・中国語）
家計管理	自然言語で支出を記録・検索
予算管理	月間予算と支出アラート
日記	AIアシストのジャーナルライティングとムードトラッキング
目標管理	個人目標の設定、追跡、チェックイン
Dデイ	重要な日付のカウントダウンタイマー
メモ	タグフィルタリング付きクイックノート
ガーデン＆ウェルネス	データビジュアライゼーションガーデン + ムード/ウェルネスチェックイン
レポート＆統計	自動定期サマリーとチャート
ペルソナ	コンテキストごとのAIパーソナリティ設定
スキル管理	プロバイダーごとにAIツールスキルを有効/無効化
Web検索	AIパワードのリアルタイムWeb検索
AIメモリ	全データにわたるセマンティック（RAG）メモリ
ファイル管理	ドキュメント、画像、音声のアップロードと解析
通知センター	ユーザーごとのcronジョブ（予算アラート、デイリーサマリーなど）
使用量分析	LLMトークン使用量とコスト追跡
Dockerサポート	starnion dev または starnion docker up
リアルタイムストリーミング	SSE/gRPCベースのレスポンスストリーミング

---

アーキテクチャ

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

コンポーネント説明

コンポーネント	役割	技術スタック
Web UI	Webインターフェース + 認証	Next.js 16 · React 19 · TypeScript · NextAuth v5
Gateway	REST API · WebSocket · Telegram · Cron	Go 1.22+ · Echo v4
Agent	AIエンジン · gRPCサーバー · スキル実行	TypeScript · AI SDK v5 · gRPC
PostgreSQL	メインデータベース · ベクター検索	PostgreSQL 16 + pgvector
MinIO	ファイルストレージ	MinIO（S3互換）
CLI	サービス管理 · セットアップウィザード	Go

データフロー

ユーザーメッセージ
     │
     ▼
  Web UI (Next.js)  or  Telegram Bot
     │ HTTP / WebSocket
     ▼
  Gateway (Go)
     │ gRPC streaming
     ▼
  Agent (TypeScript / AI SDK v5)
     │
     ├──▶ LLM API (Anthropic / Gemini / OpenAI / Ollama)
     ├──▶ スキル実行（finance、diary、goals、search、...）
     ├──▶ PostgreSQL（会話保存 / ベクター検索）
     └──▶ MinIO（ファイルアクセス）
     │
     ▼
  ストリーミングレスポンス → Gateway → UI

---

技術スタック

バックエンド

技術	バージョン	目的
Go	1.22+	Gateway APIサーバー + CLI
TypeScript / Node.js	20+	AIエージェントエンジン
Vercel AI SDK	v5	LLM通信とストリーミング
gRPC	-	Gateway ↔ Agent通信
PostgreSQL	16+	データベース
pgvector	-	ベクター埋め込み / セマンティック検索
MinIO	latest	S3互換ファイルストレージ
robfig/cron	v3	ユーザーごとのcronスケジューラー

フロントエンド

技術	バージョン	目的
Next.js	16	Webフレームワーク
React	19	UIライブラリ
TypeScript	5+	型安全性
NextAuth	v5	認証
Tailwind CSS	4	スタイリング
shadcn/ui	-	UIコンポーネントライブラリ
next-intl	4	国際化（ko/en/ja/zh）

インフラストラクチャ

技術	バージョン	目的
Docker	24+	コンテナ化
Docker Compose	v2	オーケストレーション
GoReleaser	v2	CLIリリース自動化

---

対象ユーザー

個人ユーザー

• AI会話をクラウドサービスに委ねずに完全にコントロールしたい方
• 個人の日記、メモ、目標、家計をAIと一緒に管理したい方
• TelegramからどこでもパーソナルAIアシスタントにアクセスしたい方

開発者・技術ユーザー

• 独自のAIプラットフォームを構築・拡張したい開発者
• スキルシステムを通じてカスタム機能を追加したい方
• AIエージェントアーキテクチャを学びたい方

向いていない方

• サーバー管理なしですぐに使えるクラウドサービスが欲しい方 → ChatGPT、Claude.aiなどをお勧めします
• 数百人以上の同時ユーザーに対応する必要がある場合 → 追加のスケーリング作業が必要です

---

次のステップ

• クイックスタート — 今すぐStarNionを起動する
• インストールガイド — 詳細なインストール手順
• 設定 — 環境変数とAPIキーの設定