Skip to main content
Scaffold a ready-to-edit deployment project — provider config plus agents.yaml — with one command.
Starter templates ship in the git checkout, not in the PyPI wheel (MANIFEST.in excludes infra/). Run from a monorepo checkout, or set PRAISONAI_STARTERS_ROOT / PRAISONAI_INFRA_ROOT.

​
Quick Start

1

Scaffold a project

Pick a template and drop its files into the current directory.
2

Edit and deploy

Adjust the generated config, then deploy with the matching command.

​
How It Works

create copies the named template’s files into your target directory, refusing to clobber existing files unless you pass --force.

​
Choosing a Template

Match the template to where you want to run.

​
Templates

Five templates ship today.

​
Command Options

The starters directory can be overridden with PRAISONAI_STARTERS_ROOT.

​
Best Practices

Without --force, create refuses to overwrite an existing agents.yaml — protecting hand-edited files. Use a fresh directory, or pass --force when you intend to replace.
The fastest path to a running deployment is a one-liner:
Starters use latest. Swap in a released tag before deploying to production.

Docker Compose Stack

Run the docker-compose template locally.

Deploy to Fly.io

Deploy the fly template in one command.