{"id":27102,"library":"ko-speech-tools","title":"Ko Speech Tools","description":"Korean speech and NLP tools for tokenization, romanization, and pronunciation analysis. Version 0.1.0, early development with monthly release cadence.","status":"active","version":"0.1.0","language":"python","source_language":"en","source_url":"https://github.com/your-repo/ko-speech-tools","tags":["korean","nlp","speech","tokenization","romanization"],"install":[{"cmd":"pip install ko-speech-tools","lang":"bash","label":"pip install"}],"dependencies":[],"imports":[{"note":"Top-level import is preferred; submodule import may break in future versions.","wrong":"from ko_speech_tools.tokenizer import KoSpeechTokenizer","symbol":"KoSpeechTokenizer","correct":"from ko_speech_tools import KoSpeechTokenizer"},{"note":"Function exported at package level, not from submodule.","wrong":"from ko_speech_tools.romanization import romanize","symbol":"romanize","correct":"from ko_speech_tools import romanize"},{"note":"Direct top-level import is intended.","wrong":"from ko_speech_tools.pronunciation import pronounce","symbol":"pronounce","correct":"from ko_speech_tools import pronounce"}],"quickstart":{"code":"from ko_speech_tools import KoSpeechTokenizer, romanize, pronounce\n\ntext = \"안녕하세요\"\ntokenizer = KoSpeechTokenizer()\ntokens = tokenizer.tokenize(text)\nprint(\"Tokens:\", tokens)\n\nromanized = romanize(text)\nprint(\"Romanized:\", romanized)\n\npron = pronounce(text)\nprint(\"Pronunciation:\", pron)","lang":"python","description":"Basic usage: tokenize, romanize, and get pronunciation of Korean text."},"warnings":[{"fix":"Use ko-speech-tools==0.1.0 in requirements.txt.","message":"The library is in early alpha (0.1.0); expect breaking changes in minor versions. Pin to exact version in production.","severity":"gotcha","affected_versions":"<=0.1.0"},{"fix":"Use an additional disambiguation step or a more mature romanizer for critical tasks.","message":"Romanization does not handle all ambiguous Korean syllables (e.g., homographs) correctly. Always verify output for sensitive applications.","severity":"gotcha","affected_versions":"*"},{"fix":"Use 'KoSpeechTokenizer.syllable_tokenize()' instead of 'tokenize_syllables()'.","message":"The function 'tokenize_syllables' is renamed to 'syllable_tokenize' in v0.2.0 (upcoming).","severity":"deprecated","affected_versions":"<=0.1.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install ko-speech-tools' and import with underscores: 'import ko_speech_tools'.","cause":"Python environment does not have the package installed or the package name misspelled as 'ko-speech-tools' (with hyphen).","error":"ModuleNotFoundError: No module named 'ko_speech_tools'"},{"fix":"Upgrade to 0.1.0: 'pip install --upgrade ko-speech-tools' and use 'from ko_speech_tools import KoSpeechTokenizer'.","cause":"Older version of the package (pre-0.1.0) did not export KoSpeechTokenizer at top level, or the import path was wrong.","error":"AttributeError: module 'ko_speech_tools' has no attribute 'KoSpeechTokenizer'"},{"fix":"Call romanize(text) or romanize(text=your_string).","cause":"Called romanize without arguments or passed keyword argument incorrectly.","error":"TypeError: romanize() missing 1 required positional argument: 'text'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}