Нужна дополнительная информация, чтобы точно сказать, почему у вас не запускается пример. Пришлите, пожалуйста, сам код, вывод ошибки (traceback) и версию пакета (pip show glinker) — тогда смогу указать точную причину и исправление. Пока этого нет, ниже — общие и самые частые причины, почему примеры из документации не работают, и как их проверить/исправить.
Что сначала сделать (быстро проверить)
- Скопируйте полностью текст ошибки (traceback). Это почти всегда даёт ответ.
- Узнайте версию пакета: pip show glinker (или pip3 show glinker).
- Проверьте версию Python: python --version.
- Убедитесь, что вы запускаете пример в том же окружении, где установлен glinker (виртуальное окружение / conda).
Частые причины и как их исправить
1) Версия пакета и документация не совпадают
- Документация может описывать старую или новую версию API. Часто имена функций/параметров изменились.
- Что делать: pip install -U glinker и/или посмотреть changelog на GitHub. Сравните пример из docs с тем, что реально импортируется (help/glinker, dir()).
2) Неправильный импорт или изменённые классы/функции
- Пример может делать from glinker import Linker, а в установленной версии класс называется по‑другому.
- Что делать: в REPL импортируйте модуль и посмотрите доступные имена: python -c "import glinker; print(dir(glinker))".
3) Отсутствующие зависимости или несовместимые версии зависимостей
- Часто требуется конкретная версия numpy, torch, transformers, spacy и т. п. Ошибки типа ImportError / ModuleNotFoundError — признак этого.
- Что делать: посмотреть pip freeze, установить нужные версии из requirements.txt, если такой есть.
4) Модель/файлы данных не загружены
- Quickstart может ожидать, что какая‑то модель (weights, embeddings, knowledge graph) будет автоматически скачана, но скачивание могло не пройти (нет сети, права).
- Что делать: в выводе ошибки ищите сообщения про отсутствие файла/каталога; проверьте, требует ли пример переменной окружения с токеном или путём до KG.
5) Неправильная конфигурация (параметры конструктора/путь к KG)
- В примере может быть опция model="default", но в вашей версии параметр называется иначе.
- Что делать: посмотрите сигнатуру функции (help(Linker) или inspect.signature).
6) Изменения в API сервера (если glinker использует удалённый сервис)
- Может потребоваться указать API ключ или запустить локальный бэкенд. Ошибка соединения (ConnectionError, timeout) указывает на это.
- Что делать: проверьте README/Quickstart на требование API key и переменные окружения.
7) Синтаксические отличия между версиями Python
- Если пример написан для Python 3.10+, а вы запускаете 3.7, возможны ошибки синтаксиса или несовместимости.
- Что делать: используйте рекомендованную версию Python.
Как собрать диагностическую информацию (скопировать и прислать мне)
1. Код примера, который вы запускаете (весь файл).
2. Полный traceback ошибки.
3. Вывод команд:
- python --version
- pip show glinker
- pip freeze | grep -E "glinker|torch|transformers|spacy|numpy" (или pip freeze целиком)
Примерный шаблон для локальной проверки (виртуальное окружение)
- python -m venv venv
- source venv/bin/activate (или venv\Scripts\activate на Windows)
- pip install -U pip
- pip install glinker
- Запустить пример и сохранить/скопировать вывод ошибки.
Если хотите, могу:
- Проанализировать ваш конкретный traceback и поправить код.
- Подсказать «исправленную» версию Quickstart по установленной у вас версии glinker.
Пришлите, пожалуйста, код и ошибку — разберёмся.