12

Быстрый старт: настройка и использование EvoX

AI999第1课:智能演化的源流与 EvoX 的诞生背景
00:00

Эта страница решает задачу от нуля до первой работающей среды EvoX по кратчайшему пути: выполните установку и базовую настройку минимальным числом команд, а затем проверьте одним импортом и минимальным примером, что EvoX действительно вызывается из вашей задачи. Запомните одну вещь —установилось — не значит работает. Быстрый старт завершён только тогда, когда на всех четырёх шагах получен реальный вывод.

Настройка среды EvoX: от нуля до первой работающей средыУстановилось — не значит работает: быстрый старт завершён, только когда на всех четырёх шагах получен реальный выводПуть быстрого старта из четырёх шаговКоманды, сгенерированные ИИ: сначала проверьте, потом выполняйтеОперационная системаВерсия PythonCPU / GPUПеред выполнением сверьте официальные имена пакетов и матрицу версий1Изолированная средаpython -m venv .venvsource .venv/bin/activateНикакого загрязнения глобальных зависимостейПри сбое среду можно пересоздать целиком2Установка EvoXpip install -U pippip install evoxИмя пакета и версия — только по официальным даннымНет красного текста ≠ точно работает3Базовая настройкаВерсия Python соответствует официальным требованиямВерсии зависимостей совместимы друг с другомЯвно выбрано использование CPU или GPUЗафиксировано случайное зерно (seed)4Проверка быстрого стартаimport evoxВыведите номер версии и убедитесь, что пакет загруженЗапустите минимальный примерВыполните одну итерацию эволюцииКритерии приёмки: быстрый старт EvoX завершён, только если пройдены все три пунктаНомер версии успешно выведенМинимальный пример выполнен без ошибокВыполните одну итерацию эволюцииГраницы воспроизводимости: записывайте команды установки, файлы зависимостей и номера версий — при смене машины воссоздавайте среду по тому же списку.

Шаг 1: сначала изоляция, потом установка

Прежде чем устанавливать какие-либо пакеты, создайте отдельную среду Python с помощью venv или conda. Пакеты в глобальной среде используются всеми проектами: если версии начнут конфликтовать, поиск проблемы обойдётся очень дорого. Изолированная среда — это отдельный рабочий стол для EvoX: если что-то сломается при установке, среду можно просто удалить и пересоздать, не затрагивая другие проекты.

  • Сначала — изоляция среды: создайте среду командой python -m venv .venv, затем активируйте её (в Windows — скриптом activate из каталога Scripts).
  • Сначала обновите менеджер пакетов: после активации выполните pip install -U pip, чтобы старая версия pip не выдавала ошибки при разрешении зависимостей.

Шаг 2: установите EvoX

Сама установка обычно сводится к одной команде: pip install evox; также можно установить через conda или из исходного кода.Имя пакета, версия и источник загрузки — строго по официальному релизу— имена пакетов из разных источников могут отличаться всего на пару символов, и при опечатке вы установите другой пакет или несовместимую старую версию. Отсутствие красных ошибок при установке означает лишь «установилось», а не «работает», поэтому не останавливайтесь на этом шаге.

Шаг 3: сведите базовую настройку к минимуму

При первом знакомстве не нужно перебирать все параметры — достаточно проверить четыре отправные точки: соответствует ли версия Python официальным требованиям, совместимы ли версии зависимостей, используется ли в этом эксперименте CPU или GPU и зафиксировано ли случайное зерно. Первые два пункта определяют, запустится ли программа вообще, последние два — можно ли воспроизвести результат.

Шаг 4: завершите проверкой

Самый надёжный способ приёмки — не смотреть, есть ли красный текст в терминале, а реально запустить EvoX: сначала выполните import evox и выведите номер версии, чтобы убедиться, что пакет действительно загружен текущей средой; затем запустите минимальный пример или выполните одну итерацию эволюции, чтобы убедиться, что он корректно вызывается из задачи. Среда считается настроенной только после получения реального вывода по обоим пунктам.

Пусть ИИ помогает, но решение за вами

Можно сообщить ИИ вашу операционную систему, версию Python и характеристики оборудования, чтобы он сгенерировал соответствующие команды установки, настройки и диагностики — это сэкономит много времени на чтение документации. Но учтите: имена пакетов, комбинации версий и системные операции, предложенные ИИ, необходимо сверить с официальной документацией и матрицей версий, прежде чем выполнять, особенно команды, изменяющие конфигурацию системы или удаляющие зависимости.

Границы воспроизводимости: записывайте команды установки, файлы зависимостей среды и номера версий. Самый частый итог смешивания сред — «локально работает, на другой машине падает», и запись — единственная недорогая страховка.

Пример промпта для ИИ
«Ubuntu 22.04 + Python 3.10 + без GPU, при установке EvoX возникает конфликт зависимостей — дай команды диагностики в порядке минимального вмешательства». Получив команды, сверьте официальные имена пакетов и матрицу версий, а затем выполняйте их по одной.