日本語 | English

AI NEON GENESIS INTELLIGENCE

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

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

flowchart LR
    User([ユーザー]) <-->|メッセージ| chat[UI<br/>Discord / Slack<br/>ブラウザ / LINE]
    chat <-->|プロンプト| xangi[xangi]
    xangi <-->|実行| LLM{{LLMバックエンド<br/>Claude Code / Codex<br/>Cursor CLI / Grok CLI<br/>Local LLM}}
    LLM <-->|ファイル操作| WS[(Workspace<br/>AGENTS.md / skills<br/>ローカル資料)]
    LLM <--> Web[Web検索]
    LLM <--> Service[Webサービス]
    xangi -->|定期実行| Scheduler
    Scheduler -->|プロンプト| LLM

    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 chat,xangi,LLM,Scheduler core;
    class WS ws;
    class Web,Service 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
# 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 にアクセスして会話を開始。

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

xangi は /restart コマンドで再起動できます。自動復帰にはプロセスマネージャが必要です。

npm install -g pm2
pm2 start "npm start" --name xangi
pm2 restart xangi  # 手動再起動
pm2 logs xangi     # ログ確認

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

応答メッセージにはボタン（Stop / New Session）が表示されます。DISCORD_SHOW_BUTTONS=false で非表示。

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

コンテナ隔離環境で実行したい場合は 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実行 を参照してください。

ブラウザ単独で使う場合は 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連携
• LINE セットアップ - LINE Messaging API 連携 (Tailscale Funnel での外部公開含む)
• 設計ドキュメント - アーキテクチャ・設計思想・データフロー
• 外部イベントストリーム - 応答ライフサイクルのイベント配信仕様
• インスタンス間チャット - 複数インスタンス間のメッセージ交換・auto-talk

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

MIT