Skip to content

karaage0703/xangi

Repository files navigation

日本語 | English

xangi

AI NEON GENESIS INTELLIGENCE

Claude Code / Codex / Gemini CLI / Local LLM をバックエンドに、Discord / Slack から利用できる AI アシスタント。Discord 推奨。

Features

  • マルチバックエンド対応(Claude Code / Codex / Gemini CLI / Local LLM)
  • /backend コマンドでチャンネルごとにバックエンド・モデル・effortを動的切り替え
  • Local LLM対応(Ollama/vLLM等、エージェントモード/チャットモード切替可能)
  • Discord / Slack / Web UI 対応
  • Docker対応
  • スキルシステム
  • スケジューラー(cron / 単発 / 起動時タスク)
  • セッション永続化

アーキテクチャ

graph LR
    User --> |メッセージ| Chat[Chat Platform<br/>Discord / Slack]
    Chat --> |プロンプト| xangi
    xangi --> |実行| CLI[AI Backend<br/>Claude Code / Codex<br/>Gemini CLI / Local LLM]
    CLI --> |ファイル操作| WS[Workspace<br/>skills / AGENTS.md]
    xangi --> |定期実行| Scheduler
    Scheduler --> |プロンプト| CLI
Loading

Quick Start

1. 環境変数設定

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 セットアップ を参照

2. ビルド・起動

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

npm install
npm run build
npm start

# 開発時
npm run dev

3. 動作確認

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

自動再起動(pm2)

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

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

使い方

基本

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

主なコマンド

コマンド 説明
/new 新しいセッションを開始
/clear セッション履歴をクリア
/stop 実行中のタスクを停止
/settings 現在の設定を表示
xangi-cmd schedule_* スケジューラー(定期実行・リマインダー)
xangi-cmd discord_* Discord操作(履歴取得・メッセージ送信・検索等)

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

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

Docker で実行する場合

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

環境変数

必須

変数 説明
DISCORD_TOKEN Discord Bot Token
DISCORD_ALLOWED_USER 許可ユーザーID(カンマ区切りで複数可、*で全員許可)

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

ワークスペース

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

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

書籍

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

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

ドキュメント

Acknowledgments

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

License

MIT

About

xangi - AI NEON GENESIS INTELLIGENCE

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors