Skip to main content

Avian Insight

PyPI version License: MIT Downloads LinkedIn

A package that extracts insights on bird behavior from text descriptions using pattern-matched LLM responses.

Installation

pip install avianinsight

Usage

from avianinsight import avianinsight

response = avianinsight(user_input, api_key="your_api_key", llm=your_llm_instance)

Parameters

  • user_input: str - the user input text to process
  • llm: Optional[BaseChatModel] - the langchain llm instance to use, defaults to ChatLLM7
  • api_key: Optional[str] - the api key for llm7, defaults to LLM7_API_KEY environment variable or "None"

Using alternative LLM instances

You can pass your own llm instance (based on https://docs.langchain.com/) by passing it like avianinsight(user_input, llm=their_llm_instance), for example:

from langchain_openai import ChatOpenAI from avianinsight import avianinsight
llm = ChatOpenAI()
response = avianinsight(user_input, llm=llm)
from langchain_anthropic import ChatAnthropic from avianinsight import avianinsight
llm = ChatAnthropic()
response = avianinsight(user_input, llm=llm)
from langchain_google_genai import ChatGoogleGenerativeAI from avianinsight import avianinsight
llm = ChatGoogleGenerativeAI()
response = avianinsight(user_input, llm=llm)

API Key Limitations

The default rate limits for LLM7 free tier are sufficient for most use cases of this package. If you need higher rate limits for LLM7, you can pass your own api_key via environment variable LLM7_API_KEY or via passing it directly like avianinsight(user_input, api_key="your_api_key".

Contributing

If you encounter any issues or have suggestions for improvement, please report them on the GitHub issues page: https://github.com/chigwell/avianinsight

Author

Metadata

Release files for avianinsight 2025.12.21175643

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for avianinsight 2025.12.21175643
File Size Uploaded
avianinsight-2025.12.21175643.tar.gz 3.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for avianinsight 2025.12.21175643
File Interpreter ABI Platform
avianinsight-2025.12.21175643-py3-none-any.whl Python 3 none any Details

Total release size: 8.0 kB

Release files / avianinsight-2025.12.21175643.tar.gz

Download URL avianinsight-2025.12.21175643.tar.gz
Size 3.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0df866958951cac0a0cdaafc6fac39a3922ac53de99e37e651b5fe3c2c231b13
BLAKE2b-256 checksum
How to use checksums
7654d57d3895470bb0300954f4eed432b15e677301ab2c8f628d75e5da95e758
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release files / avianinsight-2025.12.21175643-py3-none-any.whl

Download URL avianinsight-2025.12.21175643-py3-none-any.whl
Size 4.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
221c8cc102500c30c789fb88c018c4cfee7c2359cad7622e689ea3e8c1d46813
BLAKE2b-256 checksum
How to use checksums
768ea6fec050691a2cecbf0516625ed9ae0c9b38e854a4a232f844f8a1bac3c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release history Release notifications | RSS feed

This release

2025.12.21175643 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page