Templates

The fastest way to start is from a template. create-kuralle-agents scaffolds a working project — no clone, no boilerplate to wire up.

Create a project

1. Run the scaffolder. It copies a template, sets your project name, and prints the next steps.

   npm create kuralle-agents@latest my-app

   Or pick the template up front:

   npm create kuralle-agents@latest my-app --template nextjs-chatbot

2. Install and run.

   cd my-app
   npm install
   cp .env.example .env   # add your OPENAI_API_KEY
   npm run dev

With no arguments, the CLI asks where to create the project and which template to use.

Templates

| Template | What it is | | --- | --- | | nextjs-chatbot | A Next.js chat app wired to a Kuralle agent — streaming chat UI, thread history, and persistence through Kuralle SessionStore (in-memory by default, Postgres when POSTGRES_URL is set). |

More templates

nextjs-chatbot is the first template — more are on the way. In the meantime, the Agents, Flows, and Routing guides cover the same patterns (triage, flows, and per-specialist tool scoping) with runnable examples you can copy.

What you get

Every template is a complete, runnable project:

• Kuralle already wired — defineAgent + createRuntime, ready to extend.
• A real example of the pattern it demonstrates (chat UI, persistence, flows, or triage).
• .env.example listing the keys you need.

Edit lib/kuralle/ (or the equivalent) to change the agent, add tools, or attach a flow — see the Agents, Flows, and Tools guides.