sparrow-nlp 0.1.0

Small Python client for Yandex AI Studio Responses API.

cheating_sparrow

Minimal Python client for Yandex AI Studio OpenAI-compatible Responses API.

Security

This package is intentionally minimal. If you publish it with a real API key inside the code, everyone who installs the package can extract and use that key.

Install locally

python3 -m pip install -e .

After publishing to PyPI, users will install it as:

python3 -m pip install cheating_sparrow

The Python import stays underscore-based:

from cheating_sparrow import ask

Usage

from cheating_sparrow import ask

answer = ask("Напиши Python-код для TF-IDF классификации текста.")
print(answer)

For more control:

from cheating_sparrow import YandexAIStudioClient

client = YandexAIStudioClient()
answer = client.ask(
    "Объясни лемматизацию в NLP.",
    instructions="Отвечай кратко.",
    temperature=0.3,
    max_output_tokens=500,
)

print(answer)

The package uses the same call as the raw OpenAI SDK:

import openai

YANDEX_CLOUD_FOLDER = "b1g22m7kb1cbitqfp8gf"
YANDEX_CLOUD_API_KEY = "***...X3OyrU"
YANDEX_CLOUD_MODEL = "gpt-oss-120b/latest"

client = openai.OpenAI(
    api_key=YANDEX_CLOUD_API_KEY,
    base_url="https://ai.api.cloud.yandex.net/v1",
    project=YANDEX_CLOUD_FOLDER,
)

response = client.responses.create(
    model=f"gpt://{YANDEX_CLOUD_FOLDER}/{YANDEX_CLOUD_MODEL}",
    temperature=0.3,
    instructions="",
    input="",
    max_output_tokens=500,
)

print(response.output_text)

Publish to PyPI

python3 -m pip install -U build twine
python3 -m build
python3 -m twine check dist/*
python3 -m twine upload dist/*

Use TestPyPI first while testing releases:

python3 -m twine upload --repository testpypi dist/*
python3 -m pip install --index-url https://test.pypi.org/simple/ cheating_sparrow