---
title: Investibook をローカルで動かす
order: 6
description: フルスタックを開発用に自分のマシン上で立ち上げる。
---

# Investibook をローカルで動かす

ほとんどのユーザーはホスト版 [investibook.tidbcloud.com](https://investibook.tidbcloud.com)
だけで十分です。このページは、自分のマシン上で全スタックを動かしたいエンジニア向けです。

## 前提条件

- フロントエンド用に **Node.js 20+** と **pnpm**
- バックエンド用に **Python 3.11+** と **uv**
- AgentKit プラグイン用に **Bun**
- エージェント runtime が `PATH` 上にあること —— `opencode`、`claude-code-acp`、または Pi core 用の Node.js 22.19+

## クローンとインストール

```bash
git clone git@github.com:pingcap/investibook.git
cd investibook
make install
```

`make install` は以下を実行します：

- `backend/` で `uv sync`
- `frontend/` で `pnpm install`
- AgentKit プラグインのための `bun install`

## スタックを起動する

ターミナルを 2 つ開きます：

```bash
# ターミナル 1 — backend を :8000 で起動
make api

# ターミナル 2 — frontend を :3000 で起動
make web
```

[http://localhost:3000](http://localhost:3000) を開き、開発アカウント `dev@localhost`
でサインインします。

## 環境変数

| 変数 | 用途 |
| --- | --- |
| `ACP_AGENT_TYPE` | `opencode`（デフォルト）、`claude`、または `pi` |
| `ACP_AGENT_BIN` | 選択した runtime 実行ファイルへの絶対パス。未設定なら自動検出。 |
| `AGENT_PROVIDER_CONFIG` | 共有 provider/model カタログ。既定ではグローバル OpenCode 設定を使用します。 |
| `AGENT_MODEL_STANDARD` / `AGENT_MODEL_PRO` | OpenCode と Pi 向けに runtime が変換する共有モデルセレクター |
| `PI_MODEL_STANDARD` / `PI_MODEL_PRO` | provider を変換できない場合の任意の Pi 専用オーバーライド |
| `DATA_DIR` | バックエンドデータディレクトリ（デフォルト `backend/data/`） |
| `TEMPLATES_DIR` | ワークスペーステンプレート（デフォルト `backend/templates/`） |
| `AGENTKIT_SKILLS_DIR` | ビルトインスキル（デフォルト `agentkit/skills/`） |
| `NEXT_PUBLIC_API_URL` | フロントエンド → バックエンドの URL（ローカルは `http://localhost:8000`） |

## エージェントを切り替える

```bash
# デフォルト
ACP_AGENT_TYPE=opencode

# Claude Code に切り替え
ACP_AGENT_TYPE=claude

# Pi core に切り替え
ACP_AGENT_TYPE=pi
```

`ACP_AGENT_BIN` が未設定の場合、バックエンドは `shutil.which()` で適切な runtime 実行ファイルを
自動検出します。