AIが「あなた専属の家庭教師」になる！記憶も成長もする次世代学習アシスタント — DeepTutor

アーキテクチャ

• v1.0.0で約20万行の全面書き直し（agent-nativeアーキテクチャ）
• バックエンド: Python 3.11+ / FastAPI
• フロントエンド: Next.js 16 / React 19
• 二層プラグインモデル: Tools（RAG検索、Web検索、コード実行など）と Capabilities（Chat、Deep Solve、Quiz Generationなどのワークフロー）を分離
• TutorBotエンジン: nanobot（超軽量AIエージェントフレームワーク）
• RAGパイプライン: LlamaIndexベースのドキュメントインデクシング
• 数学アニメーション: ManimCatによるManim連携

対応LLMプロバイダー（25以上）

OpenAI、Anthropic、Azure OpenAI、Gemini、DeepSeek、Ollama（ローカル）、vLLM、Groq、Mistral、OpenRouter、DashScope（Qwen）、SiliconFlow、GitHub Copilot、Zhipu AI（GLM）など多数。OpenAI互換APIなら custom バインディングで接続可能。

対応Embeddingプロバイダー

OpenAI (text-embedding-3-large)、DashScope、Ollama、SiliconFlow、vLLM、任意のOpenAI互換サービス

対応Web検索プロバイダー

• Brave（無料枠あり、推奨）
• Tavily、Jina、Perplexity（APIキー要）
• SearXNG、DuckDuckGo（APIキー不要）

主要機能一覧

TutorBotの特徴

• Soul Templates: 性格・トーン・教育哲学を定義するファイルでカスタマイズ
• Heartbeat: 定期的な学習チェックイン、復習リマインダー、スケジュールタスク
• Skill Learning: スキルファイルを追加して能力を拡張
• Multi-Channel: Telegram、Discord、Slack、Feishu、WeChat Work、DingTalk、Email等に接続
• Sub-Agents: 複雑なタスクのためにバックグラウンドサブエージェントを生成可能

デプロイ

• Docker対応（linux/amd64、linux/arm64）、GitHub Container Registryに公式イメージ
• リモートサーバー向けに NEXT_PUBLIC_API_BASE_EXTERNAL でパブリックURL設定可能
• 開発モード（ホットリロード）対応の docker-compose.dev.yml あり
• データ永続化: data/user と data/knowledge_bases がボリュームマウントされる

対応ドキュメント形式

PDF、TXT、Markdown

ライセンス

Apache License 2.0（商用利用可能）

今後のロードマップ

• 認証・ログイン機能（マルチユーザー対応）
• テーマ・UI外観カスタマイズ
• LightRAG統合（高度なナレッジベースエンジン）
• ドキュメントサイト整備

方法A：対話式セットアップ（推奨）

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

# Python環境を作成
conda create -n deeptutor python=3.11 && conda activate deeptutor

# ガイド付きセットアップを起動
python scripts/start_tour.py

対話形式でLLMやEmbeddingの設定を行い、自動でサービスが起動します。

方法B：手動インストール

pip install -e ".[server]"
cd web && npm install && cd ..
cp .env.example .env
# .envにAPIキーを設定
python -m deeptutor.api.run_server  # バックエンド起動
cd web && npm run dev -- -p 3782     # フロントエンド起動

方法C：Docker

cp .env.example .env
# .envを編集
docker compose -f docker-compose.ghcr.yml up -d

方法D：CLIのみ

pip install -e ".[cli]"
deeptutor chat

いずれも http://localhost:3782 でアクセスできます。