SpinAI App

SpinAI App

OpenAI やその他の AI サービスを使用して AI 機能を統合する、TypeScript ベースのアプリケーションです。

機能

• OpenAI を使用した AI 搭載機能
• HubSpot との統合
• 最新の TypeScript 開発環境
• Express.js バックエンド
• 環境変数に基づく設定

前提条件

• Node.js（v18 以降）
• npm または yarn
• OpenAI API キー
• HubSpot アクセストークン

インストール

1. リポジトリをクローンします：

git clone [your-repo-url]
cd my-spinai-app

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します：
   • .env.example を .env にコピーします：

cp .env.example .env

   - 認証情報を使って `.env` を編集します：

OPENAI_API_KEY="your-openai-api-key" HUBSPOT_ACCESS_TOKEN="your-hubspot-access-token" SHARED_CONTACT_ID="your-shared-contact-id"

## 開発

### 開発サーバーの実行

```bash
npm run dev

これにより、ホットリロードを有効にした開発サーバーが起動します。

本番環境向けのビルド

npm run build

本番サーバーの起動

npm run start

プロジェクト構成

my-spinai-app/
├── src/              # Source code
├── .env              # Environment variables (copy from .env.example)
├── .env.example      # Example environment variables
├── package.json      # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── mcp-config.ts     # Model Context Protocol configuration

利用可能なスクリプト

• npm run dev - ホットリロードを有効にして開発サーバーを起動します
• npm run build - 本番環境向けにプロジェクトをビルドします
• npm run start - 本番サーバーを起動します
• npm run lint - コードの書式をチェックするために ESLint を実行します
• npm run check-types - TypeScript の型をチェックします

環境変数

以下の環境変数が必要です：

• OPENAI_API_KEY - OpenAI API キー
• HUBSPOT_ACCESS_TOKEN - HubSpot アクセストークン
• SHARED_CONTACT_ID - HubSpot の共有連絡先 ID

使用技術

• TypeScript
• Node.js
• Express.js
• OpenAI SDK
• HubSpot との統合
• コードのリントに使用する ESLint

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

貢献

[該当する場合は、貢献ガイドラインを追加してください]