loom

织流 Loom은 로컬에서 실행되는 에이전트 파이프라인 워크벤치로, 수학 모델링, 조사 보고서, 장문 문서 작성 등 복잡한 작업의 전체 체인 문제를 해결하는 것을 목표로 합니다. 작업을 편집 가능한 다단계 프로세스로 분해하며, 각 단계는 스킬(skill), 산출물 파일 이름, 역할(실행/검토/편집), 엔진 및 모델을 바인딩할 수 있고, 체크포인트를 설정하여 일시 중지 및 확인 대기를 지원합니다. 핵심 기능은 다음과 같습니다: - **프로세스 오케스트레이션**: 단계를 시각적으로 추가/삭제하고 각 단계를 유연하게 구성합니다. - **스킬 라이브러리**: 각 단계의 프롬프트 규범을 관리하며, 새로 만들기, 편집, 복사본 저장, 표준 스킬 패키지(zip / SKILL.md) 가져오기를 지원합니다. - **실행**: SSE를 통한 실시간 스트리밍 실행, 전사 영역에 도구 호출 및 출력이 단계별로 표시되며, 오른쪽 상단의 프로세스 카드가 각 단계의 상태에 대응하고, 작업 영역 파일 패널에 에이전트가 작성 중인 파일이 실시간으로 표시됩니다(markdown 즉시 렌더링, 이미지/PDF 인라인 미리보기). - **대화형 부분 수정**: 실행 결과가 만족스럽지 않을 때 특정 단계를 가리키며 수정 방법을 지시하면 해당 단계만 다시 작성하고 전체 프로세스를 다시 실행할 필요가 없습니다. - **프로세스 가져오기/내보내기**: 하나의 프로세스 = 하나의 JSON 파일로, 공유, 백업, 재가져오기가 가능합니다. 핵심 규칙: 본문은 로컬 CLI 에이전트만이 생성할 수 있습니다. Loom 자체는 어떤 대형 모델 API에도 직접 연결하여 콘텐츠를 생성하지 않으며, 설정의 API 프리셋은 엔드포인트/키/모델을 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/`, 설치 후 exe와 같은 레벨의 `data/`(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 필요 ｜ 완전 로컬 실행, 계정 없음, 원격 측정 없음.