使用 pylibseekdb 启动本地 seekdb，再通过 PyMySQL 执行 SQL。需要 Python 3.11 或更高版本。

python3 -m pip install -U pylibseekdb pymysql

将下面的示例保存为 example.py。它通过 connection_options() 获取连接参数并传给 PyMySQL。上下文管理器会先关闭游标和 SQL 连接，再释放运行时句柄：

from contextlib import closing

import pylibseekdb
import pymysql

with closing(pylibseekdb.open("./seekdb.db")) as db:
    options = db.connection_options()
    with pymysql.connect(
        database="test",
        autocommit=True,
        cursorclass=pymysql.cursors.DictCursor,
        **options,
    ) as connection:
        with connection.cursor() as cursor:
            cursor.execute("SELECT 1 AS value")
            print(cursor.fetchall())

运行后输出 [{'value': 1}]：

python3 example.py

完整使用指南 · 支持平台与环境要求

如需更高层的 Collection API、文本 Embedding 和混合检索，可参考 pyseekdb。

使用 @oceanbase/seekdb-node 启动本地 seekdb，再通过 mysql2 执行 SQL。需要 Node.js 22 或更高版本，同时支持 JavaScript 和 TypeScript。

npm install @oceanbase/seekdb-node mysql2

请启用 npm 可选依赖，以自动安装匹配的原生运行时。该绑定管理独立的本地 seekdb 进程；释放运行时句柄前，先关闭 SQL 连接。

将下面的示例保存为 example.mjs（使用 ES modules，同时提供 TypeScript 类型声明）：

import { seekdb } from "@oceanbase/seekdb-node";
import mysql from "mysql2/promise";

const db = await seekdb.open("./seekdb.db");
let connection;
try {
  const endpoint = db.connectionOptions();
  const location = endpoint.transport === "tcp"
    ? { host: endpoint.host, port: endpoint.port }
    : { socketPath: endpoint.transport === "unix_socket"
        ? endpoint.unixSocket : endpoint.namedPipe };
  connection = await mysql.createConnection({
    ...location,
    user: endpoint.user,
    password: "",
    database: "test",
  });
  const [rows] = await connection.query("SELECT 1 AS value");
  console.log(rows);
} finally {
  try {
    if (connection) await connection.end();
  } finally {
    db.close();
  }
}

运行后输出 [ { value: 1 } ]：

node example.mjs

完整使用指南与支持平台

如需更高层的 JavaScript Collection API，可参考 seekdb-js。

使用 seekdb-go 启动本地 seekdb，再通过 go-sql-driver/mysql 执行 SQL。本示例需要 Go 1.24 或更高版本、CGO_ENABLED=1 和 C 编译器。

mkdir seekdb-go-example
cd seekdb-go-example
go mod init example.com/seekdb-demo

将下面的示例保存为 main.go。示例使用 ConnectionOptions 返回的端点，并在释放运行时句柄前关闭 SQL 连接：

package main

import (
	"database/sql"
	"fmt"
	"log"
	"net"

	"github.com/go-sql-driver/mysql"
	seekdb "github.com/oceanbase/seekdb-go"
)

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

func run() error {
	db, err := seekdb.Open("./seekdb.db")
	if err != nil {
		return err
	}
	defer db.Close()

	endpoint, err := db.ConnectionOptions()
	if err != nil {
		return err
	}
	cfg := mysql.NewConfig()
	cfg.User, cfg.DBName = endpoint.User, "test"
	switch endpoint.Transport {
	case "unix_socket":
		cfg.Net, cfg.Addr = "unix", endpoint.UnixSocket
	case "tcp":
		cfg.Net, cfg.Addr = "tcp", net.JoinHostPort(endpoint.Host, fmt.Sprint(endpoint.Port))
	default:
		return fmt.Errorf("unsupported transport %q", endpoint.Transport)
	}
	connection, err := sql.Open("mysql", cfg.FormatDSN())
	if err != nil {
		return err
	}
	defer connection.Close()

	var value int
	if err := connection.QueryRow("SELECT 1 AS value").Scan(&value); err != nil {
		return err
	}
	fmt.Println(value)
	return nil
}

运行时 Go 会自动解析依赖，并下载当前平台的原生包，输出 1：

go run -mod=mod .

常规的 seekdb-go go get 或 go mod tidy 可能下载所有支持平台的原生包。

完整使用指南 · 支持平台与环境要求

一条 curl 命令，即刻获得运行中的数据库 — 无需注册，无需信用卡。

curl -X POST https://d0.seekdb.ai/api/v1/instances

免费使用 7 天。了解更多 →

docker run -d \
  --name seekdb \
  -p 2881:2881 \
  -p 2886:2886 \
  -v ./data:/var/lib/oceanbase \
  oceanbase/seekdb:latest

请参考此 Docker 镜像的文档获取详细信息。

# Linux（一键安装，可能需要 sudo）
curl -fsSL https://obportal.s3.ap-southeast-1.amazonaws.com/download-center/opensource/seekdb/seekdb_install.sh | bash

# macOS（Homebrew）
brew tap oceanbase/seekdb
brew install seekdb

DEB/RPM 离线安装和配置详情请参见部署文档。

Agent 的经典循环：写入一条观察，毫秒后检索相关上下文，周而复始。seekdb 的异步索引流水线确保在持续并发下读写两端均保持高吞吐。

import pyseekdb

client = pyseekdb.Client(path="./agent_state.db")
memory = client.get_or_create_collection(name="episodic")

for step in agent.run():
    # 持久化观察结果
    memory.upsert(ids=[step.id], documents=[step.observation])

    # 检索相关上下文 — 写入后毫秒级返回，
    # 由增量 HNSW 提供服务（无需等待后台重建）
    relevant = memory.query(query_texts=step.next_query, n_results=5)

    agent.act(relevant)

-- 包含向量列、全文索引和 HNSW 向量索引的表
CREATE TABLE articles (
  id        INT PRIMARY KEY,
  title     TEXT,
  content   TEXT,
  embedding VECTOR(384),
  FULLTEXT INDEX idx_fts (content) WITH PARSER ik,
  VECTOR   INDEX idx_vec (embedding) WITH (DISTANCE=l2, TYPE=hnsw, LIB=vsag)
) ORGANIZATION = HEAP;

-- 混合搜索：向量相似度 + 全文匹配在一条查询中完成
SELECT id, title,
       l2_distance(embedding, '[0.12, 0.34, ...]') AS dist
FROM articles
WHERE MATCH(content) AGAINST('quarterly report')
ORDER BY dist APPROXIMATE
LIMIT 10;

Python 开发者可通过 SQLAlchemy 或任何 MySQL 驱动来访问。

Agent 需要一个能够支撑持续写入记忆、毫秒级检索、分支探索以及出错即回滚的状态存储。seekdb 正是为此而生：

• 流式友好 — 写入即可查，毫秒级可见
• COW 沙箱 — FORK DATABASE 安全实验，MERGE 接受成果，DROP 一键回滚
• 混合检索 — 向量 + 全文 + 结构化，一条 SQL 搞定
• MySQL 协议 — 原生兼容 LangChain、LlamaIndex、Dify

个人助手 · 企业自动化 · 垂直领域 Agent · Agent 平台

seekdb 的混合检索 + 多模引擎同样适用于经典 AI 工作负载：

• 📖 RAG 与知识检索 — 向量 + 全文 + 标量过滤，支持多级访问控制。企业问答、客服、行业洞察、个人知识库。
• 🔍 语义搜索 — 基于嵌入向量的文本、图像及多模态搜索。商品搜索、以文搜图、以图搜商品。
• 💻 AI 辅助编程 — 语义代码搜索、多项目隔离、时间旅行查询，适用于 IDE 插件和代码 Agent。本地 IDE、Web IDE、设计转代码。
• ⬆️ 企业应用智能化 — MySQL 兼容的 AI 层，适用于遗留系统，支持行列混合存储。文档智能、业务洞察、金融系统。
• 📱 端侧与边缘 AI — 嵌入式/微服务器模式，适用于资源受限设备。车载系统、AI 教育、伴侣机器人、医疗设备。