kakunin-starter-nextjs — Next.js Starter Template

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.