始め方

この page は最小の on-ramp です。command surface、configuration keys、gateway routes、environment matrix の canonical reference は repository README です。

Prerequisites

• Rust stable — rust-toolchain.toml で pinned
• protoc v29 以上
• Git
• onboarding で設定する model provider credential、または local provider
• 推奨 memory backend を使う場合は PostgreSQL。Markdown と none は constrained / offline setup 用にありますが、production recommendation ではありません。

Build

git clone https://github.com/haru0416-dev/AsteronIris.git
cd AsteronIris
cargo build --release

First run

最初の実行には順序があります。fresh install では agent を開始する前に onboard --interactive を完了する必要があります。これは ~/.asteroniris/config.toml を書き、workspace を初期化します。

# Interactive onboarding wizard (fresh install では最初に実行)
cargo run -- onboard --interactive

# Interactive agent loop を開始
cargo run -- agent

# One-shot message
cargo run -- agent --message "Summarize my open tasks"

Full daemon を起動する

Discord、gateway、scheduler、heartbeat をまとめて動かす場合:

cargo run -- daemon --host 127.0.0.1 --port 3000

これは turn pipeline が想定している mode です。Discord text は primary product surface です。onboarding が書いた configuration と README の channel settings に従って daemon に接続します。Discord message が companion turn として受理されると、CLI-originated turn と同じ shared enrichment / verification path を通ります。

次に読むもの

• why から入りたい場合 — 概要 と companion-runtime concept を読んでください。
• productively に動かしたい場合 — README の Gateway、Command Surface、Configuration sections が実用 reference です。
• deployment を運用する場合 — boundaries page が AsteronIris が明示的に promise しないものを示します。misfit use case を見つける最短経路です。