kyvvu init

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

---

Usage

Usage: kyvvu init [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

Policies are assigned separately via the dashboard (Manifests page) or CLI (kyvvu assign-manifest).

Examples

New directory

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

Next steps:

    cd my-agent

    # Install requirements:
    pip install -r requirements.txt

    # Set your key:
    # (run `kyvvu register` if you have none)
    cp .env.example .env       # add your KV_API_KEY
    # or: export KV_API_KEY=your-key

    # Run the agent:
    python agent.py

To assign compliance 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

$ 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 — run the demo agent and understand the output

• Manifests — assign compliance policies to your agent

• kyvvu serve — run a local policy evaluation server