{"id":27946500,"url":"https://github.com/zapabob/deepresearchmodoki","last_synced_at":"2025-05-07T13:55:28.646Z","repository":{"id":279422854,"uuid":"936918644","full_name":"zapabob/DeepResearchmodoki","owner":"zapabob","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-25T13:18:01.000Z","size":181,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T13:55:26.971Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zapabob.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-21T23:29:19.000Z","updated_at":"2025-02-25T13:18:05.000Z","dependencies_parsed_at":"2025-02-25T14:26:29.559Z","dependency_job_id":"988cfe61-a087-4c56-b95a-6573cab5ba62","html_url":"https://github.com/zapabob/DeepResearchmodoki","commit_stats":null,"previous_names":["zapabob/deepresearchmodoki"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2FDeepResearchmodoki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2FDeepResearchmodoki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2FDeepResearchmodoki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2FDeepResearchmodoki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zapabob","download_url":"https://codeload.github.com/zapabob/DeepResearchmodoki/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252892527,"owners_count":21820646,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T13:55:26.254Z","updated_at":"2025-05-07T13:55:28.629Z","avatar_url":"https://github.com/zapabob.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Web Deep Research\r\n\r\nウェブ全体の詳細検索とChain-of-Thought（CoT）による仮説検証思考を行うツールです。\r\n\r\n## 概要\r\n\r\nWeb Deep Researchは、特定のトピックに関する詳細な調査を自動化するツールです。Google Gemini APIを活用して、ウェブ検索結果を分析し、Chain-of-Thought（CoT）推論によって複数の仮説を検証します。\r\n\r\n## 機能\r\n\r\n- **ウェブクローリング**: 指定されたクエリに基づいてウェブ検索を行い、結果を収集します。\r\n- **テキスト分析**: Google Gemini APIを使用して、収集したテキストを分析します。\r\n- **Chain-of-Thought推論**: 複数の仮説を立て、検証するプロセスを実行します。\r\n- **結果の保存**: 分析結果をJSON形式で保存します。\r\n- **Webインターフェース**: Next.jsとChakra UIを使用したモダンなWebインターフェースを提供します。\r\n\r\n### Chain-of-Thought Deep Research\r\n\r\nChain-of-Thought（CoT）Deep Researchは、通常のDeep Researchをさらに強化し、以下のステップで詳細な分析を行います：\r\n\r\n1. **検索結果の整理**: 情報源の信頼性、関連性、最新性を評価\r\n2. **主要な事実の抽出**: 各検索結果から事実、主張、データポイントを抽出\r\n3. **複数の仮説の形成**: 抽出した事実に基づいて複数の仮説を形成\r\n4. **仮説の検証**: 各仮説について支持する証拠と反証する証拠を評価\r\n5. **最も可能性の高い結論**: 証拠の評価に基づいて結論を導出\r\n6. **追加調査が必要な領域**: 結論を強化するために必要な追加調査を特定\r\n\r\n分析の深さは3段階（基本、詳細、高度）から選択可能で、より深い分析では情報源のバイアスや視点の違い、時系列的な変化、複数の視点からの検討なども行います。\r\n\r\n## プロジェクト構成\r\n\r\n```\r\nweb-deep-research/\r\n├─ .env.example                   ← 環境変数定義ファイルのサンプル\r\n├─ .gitignore                     ← Gitの除外ファイル設定\r\n├─ README.md                      ← プロジェクトの説明書\r\n├─ docker-compose.yml             ← Dockerコンテナ設定\r\n├─ package.json                   ← プロジェクト全体の依存関係\r\n├─ start-all.bat                  ← Windows用起動スクリプト\r\n├─ start-all.ps1                  ← PowerShell用起動スクリプト\r\n├─ backend/                       ← バックエンド関連のコード\r\n│  ├─ __init__.py\r\n│  ├─ main.py                     ← FastAPIサーバーのエントリーポイント\r\n│  ├─ requirements.txt            ← バックエンド依存関係\r\n│  ├─ Dockerfile                  ← バックエンドのDockerfile\r\n│  ├─ routes/                     ← FastAPIルーターなどのエンドポイント定義\r\n│  └─ services/                   ← 各サービス（crawler, gemini, graph, orchestratorなど）\r\n│     ├─ crawler.py               ← ウェブクローリングサービス\r\n│     ├─ gemini.py                ← Google Gemini API連携サービス\r\n│     ├─ graph.py                 ← グラフ生成サービス\r\n│     ├─ cot_deepresearch.py      ← Chain-of-Thought分析サービス\r\n│     └─ orchestrator.py          ← サービス間連携\r\n├─ frontend/                      ← フロントエンド関連のコード\r\n│  ├─ package.json                ← フロントエンド依存関係\r\n│  ├─ next.config.js              ← Next.js設定ファイル\r\n│  ├─ tsconfig.json               ← TypeScript設定ファイル\r\n│  ├─ .env.example                ← フロントエンド環境変数のサンプル\r\n│  ├─ Dockerfile                  ← フロントエンドのDockerfile\r\n│  ├─ public/                     ← 静的ファイル\r\n│  ├─ pages/                      ← Next.jsのページコンポーネント\r\n│  │  ├─ _app.tsx                 ← Next.jsアプリケーションのルート\r\n│  │  └─ index.tsx                ← トップページ\r\n│  └─ src/                        ← ソースコード\r\n│     ├─ components/              ← Reactコンポーネント\r\n│     │  ├─ ApiHealthCheck.tsx    ← APIヘルスチェックコンポーネント\r\n│     │  ├─ DeepResearch.tsx      ← 深層リサーチコンポーネント\r\n│     │  ├─ Footer.tsx            ← フッターコンポーネント\r\n│     │  ├─ Header.tsx            ← ヘッダーコンポーネント\r\n│     │  └─ ResultsDisplay.tsx    ← 結果表示コンポーネント\r\n│     ├─ services/                ← APIサービス\r\n│     │  └─ api.ts                ← バックエンドAPI連携\r\n│     └─ types/                   ← TypeScript型定義\r\n│        ├─ research.ts           ← リサーチ関連の型定義\r\n│        └─ search.ts             ← 検索関連の型定義\r\n├─ scripts/                       ← ユーティリティスクリプト\r\n│  ├─ cot_deepresearch.py         ← CoT深層リサーチスクリプト\r\n│  ├─ deepresearch.py             ← 深層リサーチスクリプト\r\n│  └─ run_integration_python.py   ← 統合実行スクリプト\r\n└─ docs/                          ← ドキュメント\r\n   ├─ api/                        ← API仕様書\r\n   └─ setup/                      ← セットアップガイド\r\n```\r\n\r\n## セットアップ\r\n\r\n### 前提条件\r\n\r\n- Node.js 18.x以上\r\n- Python 3.8以上\r\n- Google Gemini API キー\r\n\r\n### 環境変数の設定\r\n\r\n1. プロジェクトのルートディレクトリに`.env`ファイルを作成し、以下の内容を設定します：\r\n\r\n```\r\n# API Keys\r\nGOOGLE_AISTUDIO_API_KEY=your_gemini_api_key_here\r\n\r\n# Backend Settings\r\nBACKEND_PORT=8002\r\nENABLE_CORS=true\r\nLOG_LEVEL=INFO\r\n\r\n# Frontend Settings\r\nNEXT_PUBLIC_API_URL=http://localhost:8002\r\n```\r\n\r\n2. フロントエンドディレクトリに`.env.local`ファイルを作成し、以下の内容を設定します：\r\n\r\n```\r\nNEXT_PUBLIC_API_URL=http://localhost:8002\r\nNODE_ENV=development\r\n```\r\n\r\n### インストール\r\n\r\n1. プロジェクト全体の依存関係をインストールします：\r\n\r\n```bash\r\nnpm install\r\n```\r\n\r\n2. バックエンドの依存関係をインストールします：\r\n\r\n```bash\r\ncd backend\r\npip install -r requirements.txt\r\n```\r\n\r\n3. フロントエンドの依存関係をインストールします：\r\n\r\n```bash\r\ncd frontend\r\nnpm install\r\n```\r\n\r\n## 実行方法\r\n\r\n### 開発環境での実行\r\n\r\n1. バックエンドサーバーを起動します：\r\n\r\n```bash\r\ncd backend\r\npython main.py\r\n```\r\n\r\n2. フロントエンドの開発サーバーを起動します：\r\n\r\n```bash\r\ncd frontend\r\nnpm run dev\r\n```\r\n\r\n3. ブラウザで http://localhost:3005 にアクセスして、アプリケーションを使用します。\r\n\r\n### 統合スクリプトを使用した実行（Windows）\r\n\r\nWindowsでは、以下のスクリプトを使用して両方のサーバーを同時に起動できます：\r\n\r\n```bash\r\n# PowerShellスクリプト\r\n.\\start-all.ps1\r\n\r\n# または、バッチファイル\r\nstart-all.bat\r\n```\r\n\r\n### Docker Composeを使用した実行\r\n\r\n```bash\r\ndocker-compose up -d\r\n```\r\n\r\n## トラブルシューティング\r\n\r\n### ポートが既に使用されている場合\r\n\r\nバックエンドサーバーの起動時に「ポートが既に使用されています」というエラーが表示される場合は、以下のコマンドを実行して該当するプロセスを終了してください：\r\n\r\n```bash\r\n# Windowsの場合\r\nnetstat -ano | findstr :8002\r\ntaskkill /F /PID \u003cプロセスID\u003e\r\n\r\n# PowerShellの場合\r\nGet-NetTCPConnection -LocalPort 8002 | Select-Object -Property OwningProcess\r\nStop-Process -Id \u003cプロセスID\u003e -Force\r\n\r\n# Linuxの場合\r\nlsof -i :8002\r\nkill -9 \u003cプロセスID\u003e\r\n```\r\n\r\n### フロントエンドの依存関係エラー\r\n\r\nフロントエンドの依存関係に関するエラーが発生した場合は、以下のコマンドを実行してください：\r\n\r\n```bash\r\ncd frontend\r\nnpm install --force\r\n```\r\n\r\n### Gemini APIのエラー\r\n\r\nGemini APIに関するエラーが発生した場合は、`.env`ファイルの`GOOGLE_AISTUDIO_API_KEY`が正しく設定されていることを確認してください。\r\n\r\n## ライセンス\r\n\r\nこのプロジェクトはMITライセンスの下で公開されています。\r\n\r\n## 貢献\r\n\r\nバグ報告や機能リクエストは、GitHubのIssueを通じてお願いします。プルリクエストも歓迎します。\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzapabob%2Fdeepresearchmodoki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzapabob%2Fdeepresearchmodoki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzapabob%2Fdeepresearchmodoki/lists"}