Start here when you want to create or import an app that runs on Agentuity. In v3, the framework owns routing and startup. Agentuity adds service clients, local environment wiring, build packaging, and deploy.
npm create agentuitySetup Guides
Follow these in order for a new app, or jump to the existing-app guide when the app already has routes and scripts.
What is Agentuity?
See how Agentuity fits around a framework app
Installation
Install the CLI, sign in, and create a framework starter
Quickstart
Scaffold a Next.js starter, run it locally, and deploy
Project Structure
See exactly what the scaffold adds to a framework app
App Configuration
Configure scripts, agentuity.json, env vars, and service clients
Existing App
Add Agentuity to an app that already has routes and scripts
Choose a Starting Point
| If you have... | Start with | Why |
|---|---|---|
| A new app | Quickstart | Scaffold a Next.js example, run it locally, and deploy it |
| An existing framework app | Existing App | Keep your routes and scripts, then add Agentuity metadata and service clients |
| A fresh machine or CI image | Installation | Install the CLI, sign in, and choose a framework slug |
| Questions about generated files | Project Structure | See what the scaffold adds and what stays framework-owned |
| Environment or service setup work | App Configuration | Configure scripts, agentuity.json, env values, and standalone clients |