日本語 | English

AGENTIC NEON GENESIS INTELLIGENCE

Claude Code / Codex / Cursor CLI / Grok CLI / Antigravity CLI / Local LLMをバックエンドに、Discord / Slack / Telegram / ブラウザ / LINE から利用できる AI アシスタント。Discord 推奨、ブラウザ単独でも動作可。

• Discord / Slack / Telegram / Web Chat UI / LINE 対応
• Claude Code / Codex / Cursor CLI / Grok CLI / Antigravity CLI / Local LLM 対応
• /backend でチャンネルごとに backend / model / effort を切り替え
• スキル、スケジューラー、イベントトリガー
• Docker、pm2、supervisorによる自動復帰対応
• セッション永続化、タイムアウト延長、ワークスペース hooks

flowchart LR
    User([ユーザー]) <-->|メッセージ| Platform[チャットプラットフォーム]
    Platform <-->|プロンプト / 応答| xangi[xangi]
    xangi <-->|実行| Backend{{エージェントバックエンド}}
    Backend <-->|読み書き| WS[(ワークスペース)]
    Backend <--> External[外部情報 / Webサービス]
    Scheduler[[スケジューラー / イベントトリガー]] -->|プロンプト| xangi

    classDef user fill:#fef3c7,stroke:#d97706,color:#111;
    classDef core fill:#dbeafe,stroke:#1e40af,color:#111;
    classDef ws fill:#fef9c3,stroke:#a16207,color:#111;
    classDef ext fill:#f3f4f6,stroke:#6b7280,color:#111;
    class User user;
    class Platform,xangi,Backend,Scheduler core;
    class WS ws;
    class External ext;

cp .env.example .env

最低限の設定（.env）:

# Discord Bot Token（必須）
DISCORD_TOKEN=your_discord_bot_token

# 許可ユーザーID（必須、カンマ区切りで複数可、"*"で全員許可）
DISCORD_ALLOWED_USER=123456789012345678

💡 作業ディレクトリはデフォルトで ./workspace を使用。変更する場合は WORKSPACE_PATH を設定。

💡 Discord Bot の作成方法・ID の調べ方は Discord セットアップ を参照。

# Node.js 22+ と使用するAI CLIが必要
# Claude Code: curl -fsSL https://claude.ai/install.sh | bash
# Codex CLI:   npm install -g @openai/codex
# Cursor CLI:  curl https://cursor.com/install -fsS | bash
# Grok CLI:    curl -fsSL https://x.ai/cli/install.sh | bash
# Antigravity CLI: curl -fsSL https://antigravity.google/cli/install.sh | bash
# Local LLM:   Ollama (https://ollama.com) をインストール

npm install
npm run build
npm start

# 開発時
npm run dev

Discord で bot にメンションして話しかけてください。

トークンを用意したくない・LAN 内のブラウザだけで使いたい場合は、Web Chat UI 単独でも起動できます。

.env に以下を追加：

WEB_CHAT_ENABLED=true

npm start

ブラウザで http://localhost:18888 にアクセスして会話を開始。 セッション監視だけを見たい場合は http://localhost:18888/monitor を開くと、Web / Discord / Slack の実行状態を読み取り専用で一覧できます。

💡 ポート競合を避けるため Web Chat UI は明示的に WEB_CHAT_ENABLED=true した時だけ起動します。ポート変更は WEB_CHAT_PORT で。 💡 Slack を使う場合は Slack セットアップ を参照。 💡 Telegram を使う場合は Telegram セットアップ を参照。

xangi は clone 内の ./bin/xangi service で外側の supervisor を操作します。/restart コマンドは、起動中の xangi 自身に graceful shutdown を要求する低レベル操作です。自動復帰にはプロセスマネージャが必要です。

npm install -g pm2
./bin/xangi service start
./bin/xangi service status
./bin/xangi service restart
./bin/xangi service stop

OS 再起動後も自動起動したい場合は、対象 clone で一度だけ以下を実行します。

./bin/xangi service start
./bin/xangi service autostart

autostart は pm2 save で現在のプロセス一覧を保存し、pm2 startup で OS 起動時の PM2 復帰設定を案内します。pm2 startup が sudo env ... pm2 startup ... のようなコマンドを表示した場合は、そのコマンドを一度だけ実行してください。

複数 clone を運用する場合は、それぞれのディレクトリで ./bin/xangi を実行します。PATH から使いたい場合は、単一の xangi symlink ではなく xangi-dev / xangi-prod のような名前付き symlink を作ると対象 clone が明確になります。

ln -sf /home/user/xangi-dev/bin/xangi ~/.local/bin/xangi-dev
ln -sf /home/user/xangi-prod/bin/xangi ~/.local/bin/xangi-prod

xangi-dev service status
xangi-prod service restart

ecosystem.config.cjs は PM2 のアプリ定義ファイルです。.env の XANGI_PROCESS_NAME（未指定時は XANGI_INSTANCE_ID → ディレクトリ名）を PM2 のプロセス名に使い、実行ファイル、node --env-file=.env などをまとめて定義します。./bin/xangi service start はこの設定を使って PM2 に起動を依頼します。.cjs にしているのは、このパッケージが ESM ("type": "module") でも PM2 設定を CommonJS (module.exports) として確実に読ませるためです。

• @xangi 質問内容 - メンションで反応
• 専用チャンネル設定時はメンション不要

応答メッセージにはボタン（Stop / New Session）が表示されます。Discord / Slack / Web Chatでは返信候補を折りたたんで表示し、選択すると同じセッションへ送信します。Discord / Slackは押した本人だけに候補を表示します。Discordスレッド内では、完了後に押した本人を退出させる Leave ボタンも表示します（Botに「スレッドの管理」権限が必要）。返信候補はDiscordの /replysuggestions mode:on|off|show|default で全体切替でき、OFF時は候補生成指示をAIへ送らないため追加トークンを消費しません。プラットフォーム別の起動時設定には環境変数を使います。 初回ターンではDiscord / Slack / Webの直近履歴を自動的に先読みします。HISTORY_PREFETCH_ENABLED=false で無効化、HISTORY_PREFETCH_COUNT で件数を変更できます。

詳細は 使い方ガイド を参照してください。

コンテナ隔離環境で実行したい場合は Docker も利用できます。

# Claude Code バックエンド
docker compose up xangi -d --build

# Local LLM バックエンド（Ollama）
docker compose up xangi-max -d --build

# GPU版（CUDA + Python + PyTorch）
docker compose up xangi-gpu -d --build

docker-compose.yml には restart: unless-stopped が設定されています。docker compose stop / docker compose down で明示停止しない限り、Docker daemon の起動時に xangi コンテナも自動復帰します。OS 再起動後も自動起動したい場合は、ホスト側で Docker daemon 自体の自動起動を有効にしてください。

詳細は 使い方ガイド: Docker実行 を参照してください。

ブラウザ単独で使う場合は WEB_CHAT_ENABLED=true のみで起動可能（トークン不要）。

全ての環境変数（オプション含む）は 使い方ガイド を参照してください。

推奨ワークスペース: ai-assistant-workspace

スキル（メモ管理・日記・音声文字起こし・Notion連携など）がプリセットされたスターターキットです。xangi と組み合わせることで、チャットからスキルを呼び出して日常タスクを自動化できます。

• xangi-stackchan - xangi の応答をスタックチャン（M5Stack）に喋らせる・表情/首振り連動させる常駐ブリッジ。外部イベントストリームの SSE を購読して動作

📖 生活に溶け込むAI — AIエージェントで作る、自分だけのアシスタント

xangi を使ったAIアシスタント構築のノウハウをまとめた書籍です。

• 使い方ガイド - Docker実行・環境変数・Local LLM・複数インスタンスの運用・セッションの保持期間・トラブルシューティング
• Discord セットアップ - Bot作成・ID確認方法
• Slack セットアップ - Slack連携
• Telegram セットアップ - Telegram Bot連携
• LINE セットアップ - LINE Messaging API 連携 (Tailscale Funnel での外部公開含む)
• 設計ドキュメント - アーキテクチャ・設計思想・データフロー
• 外部イベントストリーム - 応答ライフサイクルのイベント配信仕様
• インスタンス間チャット - 複数インスタンス間のメッセージ交換・auto-talk

xangi のコンセプトは OpenClaw に影響を受けています。

MIT