> For the complete documentation index, see [llms.txt](https://docs.kyvvu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyvvu.com/cli-reference/init.md).

# kyvvu init

**What you'll learn:** How `kyvvu init` scaffolds a new agent project.

***

## Usage

```
Usage: kyvvu init [OPTIONS] [project_name]

Arguments:
  PROJECT_NAME  Project directory name (optional; uses current directory if omitted)
```

## What it does

Scaffolds project files — no authentication required:

* `agent.py` — demo agent with three decorated steps
* `requirements.txt` — `kyvvu` dependency
* `.env.example` — environment variable template
* `.gitignore` — standard Python gitignore
* `README.md` — project documentation

Your agent is governed from its first step: Kyvvu applies its bundled baseline (15 policies, OWASP + EU AI Act) automatically when the agent registers — no assignment needed. To add *more* policies, use the dashboard's Manifests page or `kyvvu assign-manifest`.

## Examples

### New directory

```bash
$ kyvvu init my-agent
✓ Created my-agent/

Next steps:

    cd my-agent

    # Install requirements:
    pip install -r requirements.txt

    # Set your key:
    # (open the dashboard, go to Workspace → API Keys, and create one)
    cp .env.example .env       # add your KV_API_KEY
    # or: export KV_API_KEY=your-key

    # Run the agent:
    python agent.py

Your agent is governed from its first step: Kyvvu applies its
baseline (15 policies, OWASP + EU AI Act) when the agent registers.
No assignment needed — see them on the Agents page, tagged Baseline.

To add more policies, go to the dashboard:
    Manifests page → select a manifest → assign to your agent
Or use the CLI:
    kyvvu list-manifests
    kyvvu assign-manifest --agent-id <id> --repo-id <id> --manifest <path>
```

### Current directory

```bash
$ mkdir my-project && cd my-project
$ kyvvu init
```

If the directory is not empty, you'll be asked to confirm.

***

## Next steps

* [Your First Agent](/getting-started/first-agent.md) — run the demo agent and understand the output
* [Manifests](/policy-authoring/templates.md) — assign security policies to your agent
* [kyvvu serve](/cli-reference/serve.md) — run a local policy evaluation server