Onboarding

Official Documentation: Nova Act GitHub README is the source of truth.

Step 1: Authentication Setup

Nova Act supports two authentication methods. You MUST prompt the user for which method they want to use!

• API Key (Quick Start) — Best for development/testing. Generate at https://nova.amazon.com/act?tab=dev_tools, then export NOVA_ACT_API_KEY="your_key". No decorator needed.
• AWS Credentials + Workflow Definition (Production) — Best for IAM-based access, S3 export. Requires AWS creds + @workflow decorator. See references/workflow_definitions.md.

Full setup details: references/authentication.md

Step 2: Start Using Nova Act

Route to the right mode: