Agent Starter Pack

0.41.3 verified Sat May 09 auth: no python

CLI tool (v0.41.3) to scaffold production-ready Google Cloud GenAI agent projects from templates. Released weekly. Uses cookiecutter internally.

pip install agent-starter-pack

Common errors

error No module named 'agent_starter_pack' ↓

cause Package name confusion: pip installs under 'agent-starter-pack', but import uses underscores.

fix

Run pip install agent-starter-pack and then from agent_starter_pack import main.

error ModuleNotFoundError: No module named 'cookiecutter' ↓

cause cookiecutter is a lazy dependency and may not be auto-installed on some setups.

fix

Run pip install cookiecutter or reinstall with pip install agent-starter-pack[cookiecutter].

Warnings

gotcha The pip package name uses hyphens, but the Python import uses underscores. `pip install agent-starter-pack` then `from agent_starter_pack import ...`. ↓

fix Use underscores for imports, hyphens only for pip install.

deprecated In v0.40+ the template backend was refactored: custom template directories must now be specified via `--template-dir` instead of `AGENT_TEMPLATE_DIR` env var. ↓

fix Replace `AGENT_TEMPLATE_DIR` with `--template-dir /path/to/templates`.

Imports

agent_starter_pack
wrong
```
from agent_starter import main
```
correct
```
from agent_starter_pack import main
```
Package name uses underscores, not hyphens.

Quickstart

Invoke the CLI programmatically. For shell usage run `agent-starter-pack new`.

from agent_starter_pack import main
import sys
sys.argv = ['agent-starter-pack', '--help']
main()