# 快速開始

本頁列出 ToriiDB 的執行需求、安裝方式，以及開啟資料目錄時該選哪個入口。

## 需求

| 需求 | 版本或用途 |
|---|---|
| Go | 1.25 以上（依 `go.mod`） |
| 作業系統 | 支援 unix domain socket 的 Unix-like 系統（daemon 監聽於 `/tmp`） |
| 可寫目錄 | 存放 `db_N/` 的 snapshot 與 log 檔 |
| `OPENAI_API_KEY` | 選用；僅向量操作需要 |

## 安裝模組

```bash
go get github.com/pardnchiu/toriidb
```

或 clone 後建置：

```bash
git clone https://github.com/pardnchiu/toriidb
cd toriidb
go build ./...
```

## 選擇入口

| 情境 | 入口 | 指南 |
|---|---|---|
| 可能有多個 process 開啟同一個目錄 | `daemon.New` | [快速上手：Socket Daemon](/zh/getting-started-daemon) |
| 只有一個 process 擁有該目錄 | `store.New` | [快速上手：內嵌 Store](/zh/getting-started-embedded) |
| 互動式試用指令 | `go run cmd/test/main.go` | [快速上手：REPL](/zh/getting-started-repl) |

## 相關頁面

- [快速上手：Daemon](/zh/getting-started-daemon)
- [快速上手：內嵌 Store](/zh/getting-started-embedded)
- [快速上手：REPL](/zh/getting-started-repl)