https://github.com/replicate/zoo
🦓 Zoo — Image Playground
https://github.com/replicate/zoo
Last synced: 4 months ago
JSON representation
🦓 Zoo — Image Playground
- Host: GitHub
- URL: https://github.com/replicate/zoo
- Owner: replicate
- License: apache-2.0
- Created: 2023-05-09T18:34:58.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-20T23:46:39.000Z (almost 2 years ago)
- Last Synced: 2025-03-29T08:06:28.767Z (10 months ago)
- Language: JavaScript
- Homepage: https://zoo.replicate.dev
- Size: 5.53 MB
- Stars: 324
- Watchers: 22
- Forks: 105
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🦓 Zoo
A playground for comparing AI image models.
## Usage
This is a [Next.js](https://nextjs.org/) app. To run it locally, you'll need to install [Node.js](https://nodejs.org/en/).
Install dependencies:
```console
npm install
```
Then, copy the `.env.example` file, name it `.env.local`, and fill in your credentials.
You'll need a running ngrok server to receive the [webhooks](https://replicate.com/docs/reference/http#predictions.create--webhook) from Replicate.
To do this, [install ngrok](https://ngrok.com/), and run it with `ngrok http 3000`. You'll see two forwarding addresses. Copy the `https` URL and enter it as your `NGROK_URL`
Then, run the development server:
```console
npm run dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser.
## Want to add a model?
1. Check out `lib/models.js` and add your model to the MODELS array.
2. Optionally, generate some example predictions by adding some submissions to `lib/seeds.js`.
3. Push your PR!
## Deploying on Vercel
Alternatively, you can [deploy Zoo on Vercel](./doc/deploy_vercel/README.md).