Amazon Nova API Cookbook

Introduction

Amazon Nova foundation models deliver frontier intelligence and industry-leading price-performance, enabling you to build generative AI applications that are safe, reliable and cost-effective.

This repository contains code samples demonstrating how to use the Amazon Nova API, an OpenAI-compatible interface for Amazon Nova's latest models.

⚠️ Please note: The Amazon Nova API is not currently intended for production usage. See our API Documentation for rate limits and quotas. For higher rate limits and quotas, explore Amazon Nova models on AWS.

Get Started

To get started, ensure you have an Amazon Nova API Key. You can get one at nova.amazon.com/dev.

If you are building on AWS, please see AWS Samples for Amazon Nova.

Prerequisites

• Python 3.x
• Jupyter Notebook (for running .ipynb files)
• Nova API Key from nova.amazon.com/dev

Setup

1. Clone the repository:

git clone https://github.com/amazon-nova-api/getting-started-with-nova-api.git
cd getting-started-with-nova-api

2. Create a virtual environment (recommended):

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install required dependencies:

For basic notebooks (00-04):

pip install -r requirements.txt

For Nova Agent examples (optional):

pip install -r nova_agents/requirements.txt  # Adds Nova Act for computer use

For LangChain examples (optional):

pip install -r langchain/requirements.txt

4. Configure your API key:

cp .env.example .env

5. Edit .env and replace your_api_key_here with your actual Amazon Nova API Key

⚠️ Important: Never commit your .env file to version control

Suggested Workflow

Getting Started with Amazon Nova

1. Getting Started: Complete basic set up, make your first calls, and learn Amazon Novas new features
2. Multi Turn: Go from single calls, to chaining promp turns to complete a conversation with Amazon Nova
3. Multi Modal Understanding: Get started with Amazon Nova's multi modal understanding capabilities, like image, and video understanding
4. Tool Use with Nova: Learn the basics of tool use with Amazon Nova
5. Nova Strands Agent: Get your first taste of building a simple agent with Strands SDK

Build Agents with Amazon Nova

1. langchain/: Advanced examples of building Nova Agents with LangChain
2. strands/: Advanced examples of building Nova Agents with LangChain
3. nova_agents/: Agentic application examples combining Nova Acts computer use capabilities

License

This library is licensed under the MIT-0 License. See the LICENSE file.