Skip to content

Latest commit

 

History

History
163 lines (114 loc) · 5.44 KB

File metadata and controls

163 lines (114 loc) · 5.44 KB

xangi

AI NEON GENESIS INTELLIGENCE

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

Features

  • 🤖 マルチバックエンド対応(Claude Code / Codex / Gemini CLI / Local LLM)
  • 💬 Discord 対応
  • 👤 シングルユーザー設計
  • 🐳 Docker対応(コンテナ隔離環境)
  • 📚 スキルシステム(スラッシュコマンド対応)
  • 🐙 GitHub CLI(gh)対応
  • ⏰ スケジューラー機能(cron / 単発 / 起動時タスク)
  • 🚀 常駐プロセスモードで高速応答
  • 💾 セッション永続化(再起動後も会話継続)

アーキテクチャ

Architecture

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 セッション履歴をクリア
/settings 現在の設定を表示
!schedule スケジューラー(定期実行・リマインダー)
!discord Discord操作(チャンネル送信・検索)

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

Docker で実行する場合

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

docker compose up xangi -d --build

Claude Code 認証:

docker exec -it xangi claude

環境変数

必須

変数 説明
DISCORD_TOKEN Discord Bot Token
DISCORD_ALLOWED_USER 許可ユーザーID

オプション

変数 説明 デフォルト
AGENT_BACKEND エージェントバックエンド(claude-code / codex / gemini / local-llm claude-code
LOCAL_LLM_BASE_URL LLMサーバーURL(local-llm時) http://localhost:11434
LOCAL_LLM_MODEL 使用モデル名(local-llm時) -
LOCAL_LLM_THINKING Thinkingモデルの推論有効化(local-llm時) true
LOCAL_LLM_MAX_TOKENS 最大トークン数(local-llm時) 8192
WORKSPACE_PATH 作業ディレクトリ(ホストのパス) ./workspace
AUTO_REPLY_CHANNELS メンションなしで応答するチャンネルID(カンマ区切り) -
AGENT_MODEL 使用するモデル -
SKIP_PERMISSIONS デフォルトで許可スキップ false
TIMEOUT_MS タイムアウト(ミリ秒) 300000
MAX_PROCESSES 同時実行プロセス数の上限 10
IDLE_TIMEOUT_MS アイドルプロセスの自動終了時間(ミリ秒) 1800000(30分)
GH_TOKEN GitHub CLI用トークン -
INJECT_CHANNEL_TOPIC チャンネルトピックをプロンプトに注入 true
INJECT_TIMESTAMP 現在時刻をプロンプトに注入 true

全ての環境変数は 設計ドキュメント を参照してください。

ワークスペース

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

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

書籍

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

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

ドキュメント

Acknowledgments

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

License

MIT