Polis

Polis to biblioteka Pythona działająca domyślnie offline. Wykrywa i proponuje minimalne, deterministyczne poprawki polskiego tekstu. Runtime v1 działa bez sieci, modelu językowego, procesu Java i usług zewnętrznych.

Granica v1

Polis poprawia tylko jednoznaczną lokalną formę tekstu. Nie zmienia znaczenia, intencji, faktów, czasu, aspektu, stylu ani tonu. Gdy reguła nie ma uzasadnionej minimalnej poprawki, nie zwraca sugestii. Automatyczna korekta stosuje tylko zakwalifikowane, niekolidujące znaleziska; pozostałe są dostępne do jawnego wyboru przez wywołującego.

Obecny runtime obejmuje reguły zgodności, pisowni oraz lokalnej składni i interpunkcji. Pełny wykaz źródeł znajduje się w opisie reguł. Historia badań v2 nie jest funkcją produktu; jej odtwarzalną lokalizację podaje manifest archiwum. Żaden przetestowany model lokalny nie został zakwalifikowany do runtime'u v1; LanguageTool również nie stanowi jego składnika. Opcjonalne badania nad modelem nigdy nie blokują wydania runtime'u. Ścieżka wydania runtime'u nie wymaga modelu, procesu Java, usługi sieciowej, korpusu badawczego ani zużytego holdoutu.

Szybki start

Polis wymaga Pythona 3.12 lub nowszego.

Do pracy deweloperskiej używaj przypiętego uv 0.11.2. Oficjalne instalatory to https://astral.sh/uv/0.11.2/install.sh dla powłok POSIX oraz https://astral.sh/uv/0.11.2/install.ps1 dla PowerShell.

python -m pip install polis-nlp

from polis import Analyzer, AnalyzerConfig

result = Analyzer(AnalyzerConfig()).correct("Zeby jutro,powiem o tym.")
assert result.corrected_text == "Żeby jutro, powiem o tym."

Analyzer.analyze() zwraca AnalysisResult ze znaleziskami i przesunięciami [start, end). Analyzer.correct() zwraca oryginalny oraz poprawiony tekst, znaleziska zastosowane i pominięte. Szczegóły zawiera publiczne API oraz szybki start.

Konfiguracja

Jedyną wspieraną sekcją pliku TOML jest [analysis]. Może określać categories i minimum_confidence; kompletny przykład znajduje się w examples/polis.toml. Konfiguracja jest odczytywana z lokalnego, jawnie wskazanego pliku i nie szuka ustawień niejawnych. Dokładnie historyczne tabele [backend], [language_tool], [contextual_inflection] i [vendored_language_tool] są odrzucane przez ConfigurationError. Inne nieznane tabele i klucze parser obecnie ignoruje; nie są one wspieranym interfejsem i nie należy na tym zachowaniu polegać.

Jakość i prywatność

Tekst nie opuszcza procesu. Polis nie zapisuje go w błędach bez jawnego działania aplikacji wywołującej. Zobacz pracę offline, ograniczenia, prywatność i audyt prywatności.

W repozytorium kontrole deweloperskie uruchamia się w zablokowanym środowisku:

uv sync --locked --extra dev
uv run --locked --extra dev pytest -m "not research and not slow"
uv run --locked --extra dev ruff check .
uv run --locked --extra dev ruff format --check .
uv run --locked --extra dev mypy .

Zasady zgodności, dystrybucji i kandydata wydania opisują odpowiednio compatibility, verification i prerelease candidate.