lucataco/moondream2 – Run with an API on Replicate

lucataco / moondream2

moondream2 is a small vision language model designed to run efficiently on edge devices

Warm

Public
612.6K runs
L40S
GitHub
License

Iterate in playground

Run with an API

Playground API Examples README Versions

Input

Run this model in Node.js with one line of code:

npx create-replicate --model=lucataco/moondream2

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run lucataco/moondream2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "lucataco/moondream2:72ccb656353c348c1385df54b237eeb7bfa874bf11486cf0b9473e691b662d31",
  {
    input: {
      image: "https://replicate.delivery/pbxt/KZKNhDQHqycw8Op7w056J8YTX5Bnb7xVcLiyB4le7oUgT2cY/moondream2.png",
      prompt: "Describe this image"
    }
  }
);

console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run lucataco/moondream2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "lucataco/moondream2:72ccb656353c348c1385df54b237eeb7bfa874bf11486cf0b9473e691b662d31",
    input={
        "image": "https://replicate.delivery/pbxt/KZKNhDQHqycw8Op7w056J8YTX5Bnb7xVcLiyB4le7oUgT2cY/moondream2.png",
        "prompt": "Describe this image"
    }
)

# The lucataco/moondream2 model can stream output as it's running.
# The predict method returns an iterator, and you can iterate over that output.
for item in output:
    # https://replicate.com/lucataco/moondream2/api#output-schema
    print(item, end="")

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run lucataco/moondream2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "lucataco/moondream2:72ccb656353c348c1385df54b237eeb7bfa874bf11486cf0b9473e691b662d31",
    "input": {
      "image": "https://replicate.delivery/pbxt/KZKNhDQHqycw8Op7w056J8YTX5Bnb7xVcLiyB4le7oUgT2cY/moondream2.png",
      "prompt": "Describe this image"
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

The image features a logo with a smiling blue circle above the word "moondream" written in black text.

Generated in

0.6 seconds

Tweak it Share Report

Run time and cost

This model costs approximately $0.0014 to run on Replicate, or 714 runs per $1, but this varies depending on your inputs. It is also open source and you can run it on your own computer with Docker.

This model runs on Nvidia L40S GPU hardware. Predictions typically complete within 2 seconds.

Readme

Moondream2

moondream2 is a small vision language model designed to run efficiently on edge devices. Check out the GitHub repository for details, or try it out on the Hugging Face Space!

Benchmarks

Release	VQAv2	GQA	TextVQA	DocVQA	TallyQA (simple/full)	POPE (rand/pop/adv)
2024-07-23 (latest)	79.4	64.9	60.2	61.9	82.0 / 76.8	91.3 / 89.7 / 86.9
2024-05-20	79.4	63.1	57.2	30.5	82.1 / 76.6	91.5 / 89.6 / 86.2
2024-05-08	79.0	62.7	53.1	30.5	81.6 / 76.1	90.6 / 88.3 / 85.0
2024-04-02	77.7	61.7	49.7	24.3	80.1 / 74.2	-
2024-03-13	76.8	60.6	46.4	22.2	79.6 / 73.3	-
2024-03-06	75.4	59.8	43.1	20.9	79.5 / 73.2	-
2024-03-04	74.2	58.5	36.4	-	-	-

Usage

The model is updated regularly, so we recommend pinning the model version to a specific release as shown above.