nocturne-client

Tiny Python client for Nocturne — the bioacoustic species classifier for insects, amphibians, and other non-bird wildlife from Stratus Labs.

Install

pip install nocturne-client

Use

from nocturne_client import Nocturne

n = Nocturne()
r = n.predict("cicada.wav", top_k=5, threshold=0.15)
for p in r.predictions:
    print(f"{p.score:.3f}  {p.species}")

Batch:

results = n.predict_batch(["clip1.wav", "clip2.wav", "clip3.wav"])

CLI:

nocturne-client predict clip.wav --top-k 5
nocturne-client health
nocturne-client vocab

Environment

• NOCTURNE_URL — override the default endpoint (https://nocturne.runstratus.com) if you're self-hosting.

Rate limits

The public endpoint is capped at 10 requests per minute per IP. The client retries automatically on 429 with linear backoff. For batch work at scale, self-host the model (weights on HuggingFace at stratus-labs/nocturne-v1-teacher) or contact Stratus Labs.

License

Apache-2.0. Model weights are CC-BY-4.0 (see the model card).