---
id: openplantbook-sdk
version: "0.6.1"
license: "MIT"
license_treatment: permissive
maintenance: aging
---

# openplantbook-sdk — Open Plantbook SDK for Python

License: permissive · Maintenance: aging · Downloads: 102.0K/mo

## What it is and what it does

openplantbook-sdk is a Python client library for the Open Plantbook API, a web service that provides plant information including details and search functionality. It wraps the HTTP API in async-first Python methods, requiring registration and API credentials from the Open Plantbook website to authenticate requests.

The SDK is built on aiohttp for async HTTP communication and supports optional language localization via ISO 639-1 language codes. It targets Python 3.9 and above and is designed for developers integrating plant data into applications—typical use involves instantiating an OpenPlantBookApi client with credentials, then calling async methods to fetch plant details or search results.

Use it for:

- Build a gardening app that looks up plant care requirements and metadata by plant name
- Integrate plant identification and information into a home automation or IoT system
- Create a plant database search interface with multi-language support for international users
- Populate a plant catalog or reference tool with current data from Open Plantbook

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for querying the Open Plantbook API to retrieve plant details and search plant information with optional language localization.

Yes, if you need to query Open Plantbook data and have valid API credentials. The low install friction, permissive license, and active (if infrequent) maintenance make it a straightforward choice for that specific use case. No, if you need a plant database that does not require external API registration or if you are unsure whether Open Plantbook's API meets your data or availability requirements.

## Install

pip install openplantbook-sdk
uv add openplantbook-sdk
poetry add openplantbook-sdk

## Installing openplantbook-sdk

Before you install: Low install friction with only two runtime dependencies (aiohttp and json-timeseries). The package is aging—last updated 197 days ago—but the repository remains active and not archived, suggesting maintenance is infrequent rather than abandoned.

License in practice: MIT license is permissive, allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install openplantbook-sdk

from openplantbook_sdk import OpenPlantBookApi
import asyncio

async def main():
    api = OpenPlantBookApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
    details = await api.async_plant_detail_get("abelia chinensis", lang="en")
    print(details["display_pid"])

asyncio.run(main())

Requires valid Open Plantbook API credentials (client ID and secret) obtained by registering on the Open Plantbook website.

Verify before relying:

- Whether API credentials from Open Plantbook are freely available or require paid subscription
- Current state of Open Plantbook API stability and uptime
- Whether json-timeseries dependency is actually used by the SDK or is a metadata artifact

## Package facts

- License: "MIT" (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 102.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

plant database api client, open plantbook sdk, plant details lookup, plant search api, async plant information retrieval, plant-data, async-api-client

[View on SkillFed](https://skillfed.io/packages/openplantbook-sdk) · [View on PyPI](https://pypi.org/project/openplantbook-sdk/)