日本語 | English

AGENTIC NEON GENESIS INTELLIGENCE

Claude Code、Codex、Cursor CLI、Grok CLI、Antigravity CLI、Local LLMを、Discord、Slack、Telegram、Web Chat、LINEから使えるAIアシスタントです。Discordを推奨しますが、ブラウザだけでも利用できます。

• 6種類のAIバックエンドと5種類のチャット画面に対応
• チャンネルごとのbackend・model・effort切り替えと、利用可能なモデルの動的取得
• ワークスペースのskillsをチャットから実行
• セッション・会話履歴の永続化、タイムアウト延長、ワークスペースhooks
• スケジューラーと外部イベントからのエージェント起動
• Web Chatからワークスペース内のMarkdown・コードを閲覧・編集
• Web Projectによる会話の分類・既存会話の移動と、Projectごとの追加プロンプト・既定モデル設定

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;

macOS、Linux、WSL2で共通です。

1. 利用するAIツールを1つ準備します。例はCodexです。

   bash <(curl -fsSL https://github.com/karaage0703/xangi/releases/latest/download/setup-ai-tools.sh) codex

   codexの代わりにclaude-code、cursor、grok、antigravityも選べます。

2. xangiをインストールします。

   curl -fsSL https://github.com/karaage0703/xangi/releases/latest/download/install.sh | bash

3. 新しいTerminalを開いて、対話セットアップを開始します。

   xangi setup

セットアップでは、ワークスペース、AIバックエンド、Web Chatの公開範囲、サービスを起動するかどうかを選びます。途中で止まった場合や状態が分からない場合は、次を実行してください。

xangi doctor

詳しいインストール、更新、削除、設定保存先は使い方ガイドを参照してください。

• Web Chat: ローカル公開を選んだ場合はhttp://127.0.0.1:18888
• Discord、Slack、Telegram、LINE: セットアップしたbotへメッセージを送信
• 状態確認: xangi doctor
• 接続情報の変更: xangi settings
• サービスを起動していない場合: xangi service start

チャットコマンド、Terminal CLI、スケジューラー、Docker、Local LLM、環境変数の詳細は使い方ガイドにまとめています。

• Discord
• Slack
• Telegram
• LINE
• Web Chatはxangi setupだけで設定可能

ここからはxangi自体を開発する人向けです。Node.js 22以降、npm、利用するAI CLIが必要です。

cp .env.example .env
npm ci
npm run build
npm start

Discordを使う場合は.envにDISCORD_TOKENとDISCORD_ALLOWED_USERを設定します。Web Chatだけで使う場合はWEB_CHAT_ENABLED=trueを設定します。ソースcheckoutの既定ワークスペースは起動時のカレントディレクトリです。必要に応じてWORKSPACE_PATHを指定してください。

開発時の起動はnpm run dev、検証用コマンドはnpm test、npm run typecheck、npm run lint、npm run format:checkです。PM2、複数instance、主要な環境変数は使い方ガイド、設定例は.env.exampleを参照してください。

Dockerを使う場合:

# Claude Code backend
docker compose up xangi -d --build

# フル版（Local LLMを使う場合は.envでAGENT_BACKEND=local-llmも設定）
docker compose up xangi-max -d --build

# CUDA / PyTorchを含むGPU版
docker compose up xangi-gpu -d --build

詳細はDocker実行を参照してください。

• Web Chat自体には認証がありません。LANへ公開すると、同じ範囲からワークスペースの閲覧・編集も可能になります。通常はローカル公開かTailscaleを選んでください。
• xangi settingsは127.0.0.1だけで一時的に開き、保存済みtokenをブラウザへ返しません。
• 外部サービスのtokenをAIとの会話やshell historyへ貼らないでください。

スキル、メモ、日記、文字起こし、Notion連携などを含むスターターキットとして、ai-assistant-workspaceを利用できます。

• xangi-stackchan - xangiの応答をM5Stackで喋らせ、表情や首振りと連動するブリッジ
• xangi-even-g2 - Even Realities G2からxangiを操作するEven Hubアプリとbridge
• xangi-pets - xangiの状態と応答を表示するデスクトップ常駐ペット

• 使い方ガイド - コマンド、設定、Docker、Local LLM、複数instance、トラブルシューティング
• 設計ドキュメント - アーキテクチャ、コンポーネント、データフロー
• 外部イベントストリーム - SSEとdevice入力API
• インスタンス間チャット - 複数instance間のメッセージ交換

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

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

MIT