AI NEON GENESIS INTELLIGENCE
Claude Code / Codex / Gemini CLI / Local LLM(Ollama等)をバックエンドに、Discord から利用できる AI アシスタント。
- 🤖 マルチバックエンド対応(Claude Code / Codex / Gemini CLI / Local LLM)
- 💬 Discord 対応
- 👤 シングルユーザー設計
- 🐳 Docker対応(コンテナ隔離環境)
- 📚 スキルシステム(スラッシュコマンド対応)
- 🐙 GitHub CLI(gh)対応
- ⏰ スケジューラー機能(cron / 単発 / 起動時タスク)
- 🚀 常駐プロセスモードで高速応答
- 💾 セッション永続化(再起動後も会話継続)
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
# Gemini CLI: npm install -g @google/gemini-cli
# Local LLM: Ollama (https://ollama.com) をインストール
npm install
npm run build
npm start
# 開発時
npm run devDiscord で bot にメンションして話しかけてください。
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 compose up xangi -d --buildClaude 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アシスタント構築のノウハウをまとめた書籍です。
- 使い方ガイド - 詳細な使い方
- Discord セットアップ - Bot作成・ID確認方法
- Slack セットアップ - Slack連携(非推奨)
- 設計ドキュメント - アーキテクチャ・全環境変数・マウント設定
xangi のコンセプトは OpenClaw に影響を受けています。
MIT
