Plant ID Bot identifies plants from photos of their organs, passing to the Plantnet API for identification. This bot was written for Sustainable Living Hub

If you wish to invite this bot to your server, use this link. However, your server will be limited to a maximum of 20 identifications every 24h. It is strongly preferred that you host a version of this bot yourself and register for your own PlantNet API key. Details for this are later in this readme file.

Features

Takes the message picture attachments and attempts to identify them
Returns a suggested plant name and up to 2 alternatives, with a percentage confidence rating
Plant names are given in latin with a list of possible common names
Provides links to GBIF, PFAF, and POWO for the identified plant

Dependencies

# mix.exs

defp deps do
    [
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},
      {:nostrum, "~> 0.10"},
      {:httpoison, "~> 2.2"},
      {:image, "~> 0.55"},
      {:jason, "~> 1.4"},
      {:plug_cowboy, "~> 2.7"},
      {:quantum, "~> 3.5"}
    ]
  end

Environment Variables

Below are the environment variables that you need to set for the program to function:

PLANTID_DISCORD_BOT_TOKEN=           client secret from the bot's application
PLANTID_LOGS_DISCORD_WEBHOOK_URL=    webhook url for the log channel
PLANTNET_API_KEY=                    API key for the PlantNet service
PLANTID_FILESERVER_URL               URL and port(if needed) for the http file server

Installation

TODO

Development

Want to contribute? Simply fork, edit and then create a pull request. Details of how to do this can be found here.

License

MIT