囲碁 AI コーチングアプリケーション。Hono.js と Mastra を活用し、あなたの棋譜から上達のためのヒントを提供します。
囲碁の楽しみを広げ、プレイヤーの棋力向上をサポートする AI パートナーを作成すること。
Katrain などの既存 AI と対局した SGF ファイルをアップロードすることで、より人間らしく、教育的なフィードバックを生成します。
- SGF ファイルの読み込み
- AI による対局の振り返りコメント生成
- 改善点の提案
- Backend: Golang (Echo v4), Genkit
- Frontend: React (Vite), Material-UI
- Tools: Bun (Runtime/PackageManager), Biome (Linter/Formatter)
- Go 1.22+
- Bun 1.1+
-
依存関係のインストール:
bun install cd frontend && bun install && cd ..
-
Google OAuth の設定:
- Google Cloud Console でプロジェクトを作成し、OAuth 同意画面を設定します。
- 「OAuth クライアント ID」を作成します(アプリケーションの種類: ウェブ アプリケーション)。
- 承認済みの JavaScript 生成元に
http://localhost:3000を追加します。
-
環境変数の設定:
プロジェクトルートに
.envファイルを作成し、以下の内容を設定してください:GOOGLE_CLIENT_ID=your-google-client-id GOOGLE_CLIENT_SECRET=your-google-client-secret
bun run dev
# または
go run cmd/server/main.go
# フロントエンドのビルドも含む場合:
bun run buildポート 3000 で起動します。ブラウザで http://localhost:3000 にアクセスしてください。
フロントエンドはビルドされ、バックエンドから静的ファイルとして配信されます。
フロントエンドのみを開発する場合は以下を実行します:
cd frontend
bun run devポート 5173 で起動します。ブラウザで http://localhost:5173 にアクセスしてください。
(バックエンドAPIを利用する場合はプロキシ設定またはCORS設定に注意してください)
(Go移行に伴い、現在MCPサーバー機能は一時的に削除されています)