日本語 | English

xangi

AGENTIC NEON GENESIS INTELLIGENCE

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

主な機能

• 好きなAIエージェントをDiscordやWeb Chatなどから利用
• スキルやファイルを置いた自分専用のワークスペースで動作
• 会話履歴を引き継ぎ、チャンネルごとにAIやモデルを切り替え
• スケジュールや外部イベントをきっかけに自動実行

アーキテクチャ

flowchart LR
    User([ユーザー]) <-->|メッセージ / ファイル| Channels[チャット画面]
    Channels <--> Xangi[xangi<br>接続 · セッション · 自動起動]
    Xangi <--> Backend[AIエージェント<br>バックエンド]
    Backend <--> Workspace[ユーザーのワークスペース<br>スキル · コード · 資料 · メモリ]
    Backend <--> External[Web · API · 外部サービス]
    classDef user fill:#fef3c7,stroke:#d97706,color:#111;
    classDef surface fill:#ede9fe,stroke:#7c3aed,color:#111;
    classDef core fill:#dbeafe,stroke:#2563eb,color:#111;
    classDef agent fill:#dcfce7,stroke:#16a34a,color:#111;
    classDef workspace fill:#fef9c3,stroke:#ca8a04,color:#111;
    classDef external fill:#f3f4f6,stroke:#6b7280,color:#111;
    class User user;
    class Channels surface;
    class Xangi core;
    class Backend agent;
    class Workspace workspace;
    class External external;

Loading

xangiはチャット接続、会話の継続、自動起動を担当します。推論とツール実行は選択したAIエージェントが担い、スキルやファイルはユーザーのワークスペースに残ります。

Quickstart

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、github-copilot、opencodeも選べます。

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

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

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

   xangi setup

セットアップでは、ワークスペースとAIバックエンドを選び、まずWeb Chatをlocalで起動・確認します。TailscaleやLANでの公開は、localの基本セットアップが完了した後の任意設定です。途中で止まった場合や状態が分からない場合は、次を実行してください。

xangi doctor

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

使い始める

• Web Chat: 初回はhttp://127.0.0.1:18888
• Discord、Slack、Telegram、LINE: セットアップしたbotへメッセージを送信
• 状態確認: xangi doctor
• AIによるエラー調査・復旧: xangi rescue
• Web UIアクセス先・疎通確認: xangi tool web_status
• バージョン確認: xangi --version
• 接続情報の変更: 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を利用できます。

拡張機能

Web UIの「設定」では全ランタイム設定と日常運用向けの起動設定を、反映タイミング付きで変更できます。チャンネル固有設定は名前で選び、保存値と実効値を確認できます。対応する全AIエージェントCLIのログイン状態・versionを一覧し、確認後に公式自己更新を実行できます。APIキーは値を再表示しない書き込み専用入力から既存のローカル秘密情報ストアへ保存できます。「拡張」からは外部機能を追加・管理できます。詳しくは使い方ガイドとExtension連携を参照してください。

• xangi-search - ワークスペースを検索する拡張機能
• xangi-stackchan - xangiの応答をM5Stackで喋らせ、表情や首振りと連動する拡張機能
• xangi-even-g2 - Even Realities G2からxangiを操作するEven Hubアプリとbridgeの拡張機能
• xangi-avatar - 音声会話・画面共有・OBSに対応するブラウザ2Dアバター

関連プロジェクト

• xangi-pets - xangiの状態と応答を表示するデスクトップ常駐ペット

ドキュメント

• 使い方ガイド - コマンド、設定、Docker、Local LLM、複数instance、トラブルシューティング
• 設計ドキュメント - アーキテクチャ、コンポーネント、データフロー
• 外部イベントストリーム - SSEとdevice入力API
• インスタンス間チャット - 認証付きHTTPによる別マシン対応の指名問い合わせ

書籍

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

Acknowledgments

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

License

MIT