Aster は、リアルタイムなチャットと音声通話、セルフホスト可能な運用、柔軟な UI カスタマイズを組み合わせるオープンソースのコミュニケーション基盤です。
Important
Aster は設計初期段階にあります。 現在はTauriデスクトップシェル、Password・Google認証クライアント、Guild・Channel・Message API、Message Gateway接続を実行できます。安定版APIは開発中です。
Aster は、次の機能を同じ権限モデルとイベント基盤の上に構築します。
- コミュニティ、テキストチャンネル、ダイレクトメッセージ
- 音声通話、カメラ、画面共有、小規模なライブ配信
- Bot API、Webhook、Application Commands
- デザイントークンを基礎とするテーマとレイアウトの変更
- 公式インスタンスに依存しないセルフホスト
特定の既存サービスをそのまま複製するプロジェクトではありません。 Aster は、リアルタイムな操作感、運用主体を選べる構造、利用者が自分の画面を調整できる設計を一つの基盤にまとめます。
- バックエンドはモジュラーモノリスから始め、計測結果に基づいて分割する。
- REST API は OpenAPI、Gateway は JSON Schema を正とし、境界の型を手書きで二重管理しない。
- 人間、Bot、Webhook は、可能な限り同じドメインサービスと権限判定を利用する。
- 永続データと、Presence や Typing などの短命な状態を分ける。
- オブジェクトストレージと音声基盤への依存は Provider Interface の内側に置く。
- 添付ファイル、音声、映像のデータを Go バックエンド経由で中継しない。
- 公式ドメインや特定ベンダーを前提とするドメインロジックを作らない。
flowchart LR
Client["Desktop Client<br/>Tauri + React + TypeScript"]
Backend["Go Backend<br/>REST API + WebSocket Gateway"]
DB[(PostgreSQL)]
Storage["Object Storage Provider<br/>Cloudflare R2 initially"]
Voice["Voice Provider<br/>Cloudflare Realtime SFU initially"]
Client -->|"HTTPS / WebSocket"| Backend
Backend --> DB
Backend -->|"認可と一時認証情報"| Storage
Backend -->|"参加認可とセッション管理"| Voice
Client <-->|"HTTP / CDN"| Storage
Client <-->|"WebRTC"| Voice
Go バックエンドは認証、権限、メッセージ、Gateway、音声セッションの制御を担当します。 音声、映像、画面共有のパケットは SFU とクライアントの間を流れ、バックエンドは Control Plane に限定されます。
| 領域 | 技術 |
|---|---|
| デスクトップ | Tauri 2、Rust |
| UI | React、TypeScript、Vite |
| クライアント状態 | TanStack Query、Zustand（第一候補） |
| 境界検証 | Zod |
| バックエンド | Go、WebSocket Gateway |
| データベース | PostgreSQL |
| REST 契約 | OpenAPI |
| Gateway 契約 | JSON Schema |
| 識別子 | UUIDv7（第一候補） |
| オブジェクトストレージ | Cloudflare R2（初期 Provider） |
| 音声と映像 | Cloudflare Realtime SFU（初期 Provider） |
Cloudflare は初期開発の速度と帯域コストを考慮した選択です。 セルフホスト環境で R2、S3、MinIO、別の SFU などへ差し替えられるように、Aster のコア機能から Provider 固有の型と処理を分離します。
Node.js 20 以降と npm を用意し、次のコマンドを実行します。
npm install
npm run devTauriデスクトップアプリとして起動する場合は、TauriのOS別依存関係とRustを用意して次を実行します。
npm run tauri:dev型チェック、本番ビルド、配信用 Worker のテストは次のコマンドで実行できます。
npm run typecheck
npm test
npm run build
npm run test:sites
npm run tauri:check現在のプロトタイプには、4カラムレイアウト、チャンネルとコミュニティの選択、検索、メッセージの送信、返信、Reaction、編集、削除、外観設定、表示密度、アクセントカラー、文字サイズ、アイコンサイズ、フォント選択、設定のImportとExport、メンバーリスト表示、カラム幅調整、音声通話コントロールの操作状態が含まれます。
Password認証でログインすると、Aster Serverから参加Guild、Guild内Channel、Text ChannelのMessageを取得します。Messageの投稿と返信、Unicode絵文字によるReaction、自分のMessageのインライン編集と確認付き削除、Cursorによる過去Messageの追加取得、Gatewayによるリアルタイム反映に対応しています。返信元が編集された場合は参照内容を更新し、削除または閲覧不能になった場合は本文を表示できない状態として示します。Reaction Eventの件数は現在値として適用するため、Gatewayから再配信されても二重に加算しません。Gateway切断時は最後に適用したSequenceからSessionをResumeし、復帰不能な場合だけ新しいSessionを開始します。開発時のデモモードでは、Serverなしで同じ操作を含むサンプルUIを確認できます。Member、Presence、Voiceは対応するProtocolが未定義のため、現時点ではデモ表示です。
REST APIの接続先はVITE_ASTER_API_URLで指定します。未指定時はhttp://localhost:8080を使用し、Protocolの/api/v1を自動的に付加します。
Gateway接続先はREST APIのOriginから/gateway/v1を自動生成します。別の接続先を使用する場合はVITE_ASTER_GATEWAY_URLでws://またはwss:// URLを指定できます。
Message入力中は4秒間隔で入力開始を通知します。
受信した入力中表示はProtocolのstarted_atから10秒で失効し、同じUserのMessageを受信した場合は直ちに消去します。
VITE_ASTER_API_URL=https://aster.example.com npm run tauri:devProtocol型を更新する場合は、Aster-protocolのマージ済みOpenAPIとGateway JSON Schemaから生成物を更新します。
npm run generate:protocolデスクトップ版はAccess Tokenをメモリにだけ保持し、Refresh TokenだけをRust経由でmacOS Keychain、Windows Credential Manager、Linux Secret Serviceへ保存します。ブラウザプレビューではRefresh Tokenを永続化しません。
GoogleログインはシステムブラウザでAuthorization Code + PKCE S256を開始し、aster://auth/callbackでデスクトップアプリへ戻ります。Googleの資格情報はデスクトップへ渡さず、Aster ServerがProviderを検証した後にProvider非依存のAster Session Tokenを発行します。PKCE Verifierはメモリだけに保持するため、ブラウザ認証中にアプリを終了した場合はログインをやり直してください。
Aster は、テーマを完成後の追加機能として扱いません。 デザイントークンを初期設計に含め、コンポーネントと機能レイアウトがトークンを参照する構造を採用します。
想定する変更対象は、色、背景、フォント、角丸、余白、サイドバー幅、メッセージ密度、プロフィールカード、音声通話画面、コミュニティ単位のテーマ上書きです。
現在の外観設定は端末内へ保存します。 文字サイズは既存のTypography階層へ同じ差分を適用し、アイコンサイズはクリック領域を保ったままPhosphor Iconの表示だけを拡縮します。フォントは外部配信へ依存せず、OSに入っている日本語フォントから選択します。
外観設定は、版番号を含むJSONファイルとして書き出し、同じ形式から読み込めます。読み込み時は既知の値だけを適用し、対応範囲外の値を安全な既定値または上限と下限へ補正します。
テーマと実行可能なプラグインは別の機能として扱います。 任意の JavaScript 注入は許可せず、Custom CSS を提供する場合も適用範囲と安全性を定義します。
Aster は、責務とリリース周期が異なる次の3リポジトリで開発します。
| リポジトリ | 責務 |
|---|---|
Aster |
Tauri、React UI、WebRTC 制御、OS 統合 |
Aster-server |
Go API、Gateway、ドメイン機能、DB Migration、Provider 実装 |
Aster-protocol |
OpenAPI、Gateway Schema、生成型、Bot SDK、API ドキュメント |
Aster-protocol を Protocol Schema の正とし、Client と Server は生成物を利用します。
ロードマップは順序を示すものであり、公開時期を保証するものではありません。
- Foundation：リポジトリ構成、CI、Protocol Skeleton、Go Server、Tauri Client、PostgreSQL 接続、認証の土台
- Text：ユーザー、コミュニティ、チャンネル、最小限の権限、メッセージ CRUD、Gateway 再接続、基本 UI
- Media：R2 への直接アップロード、添付ファイル、音声参加、ミュート、画面共有
- Platform：Application、Bot Token、Gateway Intents、Application Commands、Webhook、JavaScript SDK
- Customization：ユーザーテーマ、コミュニティテーマ、レイアウト変更、設定の Import と Export
- Public and Self-hosting：Docker 配布、管理設定、Provider 選択、Moderation、Security Hardening、公開ベータ準備
初期版では、大規模な公開配信、Federation、マイクロサービス化、Kafka、ScyllaDB、Elasticsearch を対象にしません。 これらは、利用規模と計測結果が必要性を示した段階で検討します。
REST API は /api/v1 のように URL でバージョンを明示し、一覧取得には Cursor Pagination を優先します。
WebSocket Gateway は Sequence、Heartbeat、Reconnect、Resume、Session、Intents、Backpressure を考慮します。
公開 API と Schema はまだ確定していません。 互換性を保証するリリース段階に入るまでは、事前の告知なく変更される可能性があります。
最終的には、運用者が独自ドメイン、PostgreSQL、オブジェクトストレージ、音声 Provider を選んで Aster を構築できる状態を目指します。 開発環境と小規模構成には Docker Compose を提供する予定です。
セルフホスト手順はまだ利用できません。 初期実装が整うまでは、このリポジトリを本番環境へ導入できません。
コントリビューション手順、行動規範、開発環境の構築方法は、Foundation Phase で追加します。 実装を始める前に、設計判断を ADR として記録し、API の変更を Protocol Schema から開始できる開発フローを整備します。
ブランチは短期間で完結させ、Pull Request、CI、Review、Squash Merge を経て main へ反映する方針です。
Commit Message には Conventional Commits を使用します。
Aster は Apache License 2.0 の下で公開されています。
Discord、Misskey、Cloudflare および本文に記載された製品名は、それぞれの権利者に帰属します。 Aster はこれらのサービスや企業から承認、後援、運営を受けるプロジェクトではありません。