panini-lang

Python bindings for Panini — an LLM-powered morphological feature extraction engine for any language.

Installation

pip install panini-lang

No other dependencies required. The package ships pre-compiled for macOS, Linux, and Windows.

Quick Start

from panini import extract

result = extract(
    provider="openai",        # "openai" | "anthropic" | "google"
    model="gpt-4o",
    api_key="sk-...",
    language="fra",           # ISO 639-3 code
    text="Je ne sais pas",
    targets=["sais"],
)

print(result)
# {
#   "target_features": [...],
#   "context_features": [...]
# }

Async Support

import asyncio
from panini import async_extract

async def main():
    result = await async_extract(
        provider="anthropic",
        model="claude-opus-4-5",
        api_key="sk-ant-...",
        language="pol",
        text="Nie wiem",
        targets=["wiem"],
    )
    print(result)

asyncio.run(main())

Supported Languages

from panini import supported_languages

supported_languages()
# ['pol', 'tur', 'ara', 'fra']

Supported Providers

Analysis Components

By default, all compatible components are run. You can select specific ones:

result = extract(
    ...,
    components=["morphology", "pedagogical_explanation"],
)

Custom Prompts

Panini ships with built-in extraction prompts. You can override them by passing a YAML file path or a dict:

# From a YAML file
result = extract(..., prompts="/path/to/my_prompts.yml")

# From a dict
result = extract(..., prompts={
    "system_role": "You are a strict NLP extractor...",
    ...
})

# Inspect the built-in default prompts
from panini import get_default_prompts
print(get_default_prompts())

Full API Reference

extract(...) -> dict

Synchronous extraction.

async_extract(...) -> dict

Asynchronous version of extract(). Same parameters, returns a coroutine.

supported_languages() -> list[str]

Returns the list of supported ISO 639-3 language codes.

get_default_prompts() -> dict

Returns the built-in extraction prompts as a Python dict.

version() -> str

Returns the current package version.

License

MIT