Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/replicate/getting-started-nextjs
A Next.js starter app using Replicate
https://github.com/replicate/getting-started-nextjs
Last synced: about 13 hours ago
JSON representation
A Next.js starter app using Replicate
- Host: GitHub
- URL: https://github.com/replicate/getting-started-nextjs
- Owner: replicate
- License: apache-2.0
- Created: 2022-08-11T19:11:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-29T17:02:46.000Z (4 months ago)
- Last Synced: 2024-08-05T09:11:50.826Z (3 months ago)
- Language: JavaScript
- Homepage: https://replicate.com/docs/get-started/nextjs
- Size: 791 KB
- Stars: 205
- Watchers: 21
- Forks: 103
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ai-frontend - Next.js starter with Replicate's Prediction API
README
## Getting started with Next.js and Replicate
This is a [Next.js](https://nextjs.org/) template project that's preconfigured to work with Replicate's API.
It uses Next's newer [App Router](https://nextjs.org/docs/app) and [Server Components](https://nextjs.org/docs/app/building-your-application/rendering/server-components).
You can use this as a quick jumping-off point to build a web app using Replicate's API, or you can recreate this codebase from scratch by following the guide at [replicate.com/docs/get-started/nextjs](https://replicate.com/docs/get-started/nextjs)
## Noteworthy files
- [app/page.js](app/page.js) - React frontend that renders the home page in the browser
- [app/api/predictions/route.js](app/api/predictions/route.js) - API endpoint that calls Replicate's API to create a prediction
- [app/api/predictions/[id]/route.js](app/api/predictions/[id]/route.js) - API endpoint that calls Replicate's API to get the prediction result
- [app/api/webhooks/route.js](app/api/webhooks/route.js) - API endpoint that receives and validates webhooks from Replicate
## Running the app
Install dependencies:
```console
npm install
```
Create a git-ignored text file for storing secrets like your API token:
```
cp .env.example .env.local
```
Add your [Replicate API token](https://replicate.com/account/api-tokens) to `.env.local`:
```
REPLICATE_API_TOKEN=
```
Run the development server:
```console
npm run dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser.
For detailed instructions on how to create and use this template, see [replicate.com/docs/get-started/nextjs](https://replicate.com/docs/get-started/nextjs)
## Webhooks
Webhooks provide real-time updates about your predictions. When you create a prediction or training, specify a URL that you control and Replicate will send HTTP POST requests to that URL when the prediction is created, updated, and completed.
This app is set up to optionally request, receive, and validate webhooks.
### How webhooks work
1. You specify a webhook URL when creating a prediction in [app/api/predictions/[id]/route.js](app/api/predictions/[id]/route.js)
1. Replicate sends POST requests to the handler in [app/api/webhooks/route.js](app/api/webhooks/route.js) as the prediction is updated.
### Requesting and receiving webhooks
To test webhooks in development, you'll need to create a secure tunnel to your local machine, so Replicate can send POST requests to it. Follow these steps:
1. [Download and set up `ngrok`](https://replicate.com/docs/webhooks#testing-your-webhook-code), an open-source tool that creates a secure tunnel to your local machine so you can receive webhooks.
1. Run ngrok to create a publicly accessible URL to your local machine: `ngrok http 3000`
1. Copy the resulting ngrok.app URL and paste it into `.env.local`, like this: `NGROK_HOST="https://020228d056d0.ngrok.app"`.
1. Leave ngrok running.
1. In a separate terminal window, run the app with `npm run dev`
1. Open [localhost:3000](http://localhost:3000) in your browser and enter a prompt to generate an image.
1. Go to [replicate.com/webhooks](https://replicate.com/webhooks) to see your prediction status.
### Validating incoming webhooks
Follow these steps to set up your development environment to validate incoming webhooks:
1. Get your signing secret by running:
```
curl -s -X GET -H "Authorization: Bearer $REPLICATE_API_TOKEN" https://api.replicate.com/v1/webhooks/default/secret
```
1. Add this secret to `.env.local`, like this: `REPLICATE_WEBHOOK_SIGNING_SECRET=whsec_...`
1. Now when you run a prediction, the webhook handler in [app/api/webhooks/route.js](app/api/webhooks/route.js) will verify the webhook.