Next.jsReact启动器

kakunin-starter-nextjs — Next.js 启动器模板

作者 kakunin-ai

基于 Next.js 的 Kakunin 起步模板，用 @kakunin/sdk 为 AI 代理签发 X.509 证书并在 API 路由上校验。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-14查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

使用 @kakunin/sdk 为 AI 代理签发 X.509 证书

src/app/api/agents/route.ts 通过 agents.create 与 agents.certify 注册并签发代理证书

src/middleware.ts 在 /api/protected/* 路由上强制校验有效证书

src/lib/kakunin.ts 提供延迟初始化的共享 SDK 客户端

提供 Vercel 一键部署入口，需配置 KAKUNIN_API_KEY 环境变量

MIT 许可，可自行 fork 修改

模板详细介绍

这是一个可部署的 Next.js 起步应用，目标是为 AI 代理加入加密身份与合规能力，依赖 @kakunin/sdk。README 说明它包含三部分：src/app/api/agents/route.ts 负责注册代理并签发其 X.509 证书（调用 agents.create 与 agents.certify）；src/middleware.ts 在 /api/protected/* 路由上强制要求有效证书；src/lib/kakunin.ts 是延迟初始化的共享 SDK 客户端。

使用方式为：通过 npx degit 或 GitHub 的 Use this template 获取代码，安装依赖，复制 .env.example 为 .env.local 并填入 API key，然后运行开发服务器。README 提到可在 kakunin.ai/dashboard/api-keys 获取免费的沙箱密钥（kak_test_ 前缀）。注册并签发代理的示例是向 /api/agents 发送包含 name、model、version 的 POST 请求。

README 未提供页面 UI、路由清单、证书校验的具体实现细节、错误处理方式或生产部署配置说明；除 Vercel 部署按钮外，也未说明其他部署步骤。

Next.js启动器

适合你的项目吗？

适用场景

在 Next.js 应用中为 AI 代理注册并签发 X.509 证书
为受保护的 API 路由添加证书校验中间件
作为集成 @kakunin/sdk 的起步示例进行二次开发

适合人群

需要在 Next.js 项目中为 AI 代理引入加密身份的开发者
希望参考 @kakunin/sdk 在 API 路由与中间件中用法的人
准备用 Vercel 部署该起步应用并配置 API key 的团队

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
通过 npx degit kakunin-ai/kakunin-starter-nextjs my-app 或 GitHub 的 Use this template 获取代码
2
执行 npm install 安装依赖
3
复制 .env.example 为 .env.local 并填入 API key
4
在 kakunin.ai/dashboard/api-keys 获取免费沙箱密钥（kak_test_ 前缀）
5
运行 npm run dev 启动开发服务器；README 未提供其他部署步骤说明

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
使用该模板需要从 kakunin.ai 获取 API key（免费沙箱密钥，kak_test_ 前缀），并配置到 .env.local 中，否则无法调用 @kakunin/sdk。
Vercel 一键部署需要配置 KAKUNIN_API_KEY 环境变量，即依赖外部 Kakunin 服务账号。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Get a free sandbox key at [kakunin.ai/dashboard/api-keys](https://www.kakunin.ai/dashboard/api-keys) (`kak_test_...`, no cost).
README 原文

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fkakunin-ai%2Fkakunin-starter-nextjs&env=KAKUNIN_API_KEY&envDescription=Get%20a%20free%20sandbox%20key&envLink=https%3A%2F%2Fwww.kakunin.ai%2Fdashboard%2Fapi-keys)
README 原文

https://github.com/kakunin-ai/kakunin-starter-nextjs/blob/main/LICENSE https://github.com/kakunin-ai/kakunin-starter-nextjs/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-14。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 80 / 100
技术栈: Next.js · React
网站类型: 启动器

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-07-09
截图检查日期: 2026-10-14

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: codex-user-requested-batch-review-20261015 · 2026-10-15

查看当时使用的来源资料

SHA-256: df788eed15dac29827aba267b5bc4610e8c4c6475fbbd0b3dbe537cd11960f99

2026-10-14T22:21:09.735Z

来源文件 / 仓库

# Kakunin + Next.js starter — X.509 identity & compliance for AI agents

A minimal, deployable Next.js app that adds **cryptographic identity and compliance to AI agents** using [`@kakunin/sdk`](https://www.npmjs.com/package/@kakunin/sdk) — issue X.509 certificates, then enforce them on your API routes.

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fkakunin-ai%2Fkakunin-starter-nextjs&env=KAKUNIN_API_KEY&envDescription=Get%20a%20free%20sandbox%20key&envLink=https%3A%2F%2Fwww.kakunin.ai%2Fdashboard%2Fapi-keys)

## What's inside

- **`src/app/api/agents/route.ts`** — register an agent and issue its X.509 certificate (`agents.create` + `agents.certify`).
- **`src/middleware.ts`** — enforce a valid certificate on `/api/protected/*` routes.
- **`src/lib/kakunin.ts`** — the shared `@kakunin/sdk` client (lazy-initialised).

## Quick start

```bash
npx degit kakunin-ai/kakunin-starter-nextjs my-app   # or "Use this template" on GitHub
cd my-app
npm install
cp .env.example .env.local                       # add your API key
npm run dev
```

Get a free sandbox key at [kakunin.ai/dashboard/api-keys](https://www.kakunin.ai/dashboard/api-keys) (`kak_test_...`, no cost).

Register + certify an agent:

```bash
curl -X POST http://localhost:3000/api/agents \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","model":"gpt-4o","version":"1.0.0"}'
```

## Learn more

- SDK: [`@kakunin/sdk`](https://github.com/kakunin-ai/kakunin-sdk-typescript) · Docs: [kakunin.ai/docs](https://www.kakunin.ai/docs)
- More examples: [kakunin-samples](https://github.com/kakunin-ai/kakunin-samples)

MIT licensed — fork it, ship it.

反馈内容错误