Об этом проекте

织流 Loom — это локальная рабочая среда для конвейеров ИИ-агентов, предназначенная для решения задач полного цикла, таких как математическое моделирование, исследовательские отчёты и написание длинных документов. Она разбивает задачу на редактируемый многошаговый процесс; на каждом шаге можно привязать навык (skill), имя файла результата, роль (выполнение/проверка/редактирование), движок и модель, а также настроить паузу на контрольной точке для ожидания подтверждения. Ключевые возможности: - **Проектирование процесса**: визуальное добавление и удаление шагов, гибкая настройка каждого шага. - **Библиотека навыков**: управление спецификациями промптов для каждого шага, поддержка создания, редактирования, сохранения копии, а также импорта стандартных пакетов skill (zip / SKILL.md). - **Запуск**: потоковое выполнение в реальном времени через SSE; в области транскрипта постепенно отображаются вызовы инструментов и вывод; карточки процессов в правом верхнем углу соответствуют состоянию каждого шага; панель файлов рабочей области в реальном времени показывает файлы, которые пишет агент (markdown рендерится на месте, изображения/PDF отображаются встроенно). - **Диалоговые точечные правки**: если после запуска результат не устраивает, можно указать на конкретный шаг и сказать, что изменить, — перезапишется только этот шаг, без повторного запуска всего процесса. - **Импорт и экспорт процессов**: один процесс = один JSON-файл, который можно передавать, сохранять в резервную копию и импортировать обратно. Одно жёсткое правило: основной текст может создавать только локальный CLI-агент. Сам Loom не подключается напрямую к каким-либо API больших моделей для генерации контента; API-пресеты в настройках используются только для передачи endpoint/ключа/модели в Claude Code или Codex CLI. Перед использованием нужно установить и войти в один из них: Claude Code (доступна команда `claude`) или Codex CLI (доступна команда `codex`). Запуск из исходного кода: ```bash pip install -r requirements.txt python run.py # http://127.0.0.1:8000 python run.py --port 8001 # сменить порт python run.py --auto-kill # автоматически освободить порт, если он занят старым процессом ``` Регрессионные тесты (сеть не требуется): ```bash python -m pytest -q ``` Структура каталогов: - `app/`: бэкенд FastAPI, включает `main.py` (маршруты и все /api), `runner.py` (движок выполнения процесса: контрольные точки, поток событий SSE, рабочая область, результаты), `agents.py` (слой адаптации Claude / Codex CLI), `updater.py` (проверка обновлений, загрузка установочного пакета, сверка sha256). - `static/`: фронтенд (нативные HTML/CSS/JS, без фреймворков и шага сборки). - `tests/`: регрессионные тесты pytest, включая контрактные тесты статических ресурсов. - `loom_launch.py`: точка входа в упакованном виде (нативное окно pywebview, при ошибке — откат к браузеру). - `run.py`: точка входа при запуске из исходного кода. - `make_release.py`: PyInstaller onedir + Inno Setup → release/Loom-<версия>-setup.exe. - `upload_cos.py`: загрузка установочного пакета и latest.json в Tencent Cloud COS. Каталог данных: при запуске из исходного кода — `modex-data/`, после установки — `data/` рядом с exe (SQLite + рабочая область + собственные навыки + экспортированные файлы). При обновлении он не перезаписывается, при удалении не удаляется. Сборка и публикация: ```bash python make_icon.py # нужно только если менялась иконка python make_release.py --version 1.0.1 --notes "…" # создаёт setup.exe + latest.json python upload_cos.py # загрузка в COS (нужен локальный файл ключей, не попадает в репозиторий) ``` Установочный пакет содержит только само приложение и зависимости; `modex-data/` с машины разработчика в него не попадает (в `make_release.py` есть явная проверка). Конфиденциальность: нет серверной системы аккаунтов, нет телеметрии, никакой контент не загружается. Процессы, промпты и результаты остаются на локальной машине. Единственные внешние запросы — однократное чтение списка версий при проверке обновлений и собственное взаимодействие CLI-агента с сервисом модели. Скачать: https://lxlrwxs.top/modelflow/ | Требуется Windows 10/11 | Полностью локальная работа, без аккаунтов и телеметрии.