콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

환경 변수 레퍼런스

Loom의 거의 모든 구성은 설정 필드로 이루어집니다. 이는 server.settings.Settings의 필드에 대응하는 환경 변수 LOOM_<FIELD>이며, 기본값과 의미는 생성된 구성 레퍼런스에 나와 있습니다. 이 페이지에서는 나머지를 다룹니다. 서버, CLI, SDK, 플러그인, 컨테이너 이미지, compose 파일, 운영자 스크립트가 os.environ(또는 셸의 ${VAR})으로 직접 읽는 변수입니다. 이 중 LOOM_* 변수는 NON_SETTINGS_ENV(server/settings/_env.py)에 나열되어 있으며, 웹훅 서명 시크릿 같은 변수군은 NON_SETTINGS_ENV_PREFIXES에 나열되어 있습니다. 서버의 알 수 없는 변수 경고는 이들을 건너뜁니다. tests/unit/test_environment_reference.py는 이 목록들과 이 페이지가 서로 일치하도록 유지합니다.

서버

변수 읽는 곳 기본값 의미
OPENAI_API_KEY server/embedding/openai.py, server/llm/openai.py 설정 안 됨 OpenAI 임베더와 LLM용 키입니다. OpenAI 모델이 설정되어 있는데 키가 없으면 임베더는 ERROR 로그를 남기고 가짜 n-gram 임베더로, LLM은 가짜 클라이언트로 대체되며 loom doctor가 경고합니다.
ANTHROPIC_API_KEY server/llm/anthropic.py 설정 안 됨 Anthropic LLM 프로바이더용 키입니다(LOOM_LLM_PROVIDER=anthropic, 또는 claude* 모델에서 추론됨).
GEMINI_API_KEY, GOOGLE_API_KEY server/embedding/gemini.py 설정 안 됨 Gemini 임베더용 키입니다. 먼저 설정된 것이 사용됩니다.
COHERE_API_KEY server/core/provider_keys.py 설정 안 됨 호스팅 rerank 프로바이더용 키입니다. 없으면 리랭커가 경고를 로그에 남기고 후보를 입력 순서대로 반환합니다(fail-open).
LOOM_EMBEDDING_API_KEY server/core/provider_keys.py 설정 안 됨 compatible 임베딩 프로바이더(LOOM_EMBEDDING_PROVIDER=compatible)용 키입니다. 없으면 /v1/health와 loom doctor가 누락되었다고 보고합니다.
LOOM_ENV_FILE server/core/env_file.py, server/cli/app.py .env Settings가 읽는 env 파일이자 loom CLI가 환경에 로드하는 파일입니다. 비워 두면 사용하지 않습니다.
LOOM_SETTINGS_FILE server/core/env_file.py 설정 안 됨(없음) Settings가 env 파일과 환경 변수보다 낮은 우선순위로 읽는 YAML 설정 파일입니다(구성 레퍼런스). 지정한 파일이 없으면 시작을 거부합니다. 환경 변수에서 읽고, 없으면 env 파일에서 읽습니다. 환경 변수의 값이 비어 있으면 env 파일에 무엇이 있든 아무것도 읽지 않습니다.
LOOM_INSTANCE_LABEL server/observability/instance.py 설정 안 됨 모든 원장 행에 기록되는 이 프로세스의 레이블입니다(최대 64자). 이 값도 없고 LOOM_DEPLOYMENT=1(제공되는 compose 파일이 설정하는 설정 필드)도 없이 시작한 프로세스는 부팅을 거부하므로, 모든 행의 출처를 알 수 있습니다.
XDG_RUNTIME_DIR server/core/runtime_files.py 설정 안 됨 LOOM_RUNTIME_DIR가 설정되지 않았을 때, 한 서버의 웹 프로세스들이 공유 파일(속도 제한 테이블)을 두는 위치입니다. $XDG_RUNTIME_DIR/loom, /run/loom, /tmp/loom-<uid> 중 해당 사용자만 들어갈 수 있는 디렉터리이거나 그렇게 만들 수 있는 첫 번째 경로가 사용됩니다. 웹 프로세스가 여러 개인데 이 경로가 없으면, scripts/serve.sh가 개수를 직접 정한 경우에는 하나를 시작하고, 그렇지 않으면 중단하고 해당 프로세스를 알려 줍니다. scripts/serve.sh는 이 선택을 한 번만 하고 LOOM_RUNTIME_DIR로 내보냅니다.
HOSTNAME server/observability/instance.py 시스템 호스트 이름 hostname:pid 형식의 인스턴스 id에 쓰이는 대체 호스트 이름입니다.
POD_NAMESPACE, POD_NAME server/core/provider_process.py 설정 안 됨 이 pod의 네임스페이스와 이름입니다(차트가 downward API에서 설정함). 해당 네임스페이스의 API에 그 pod가 더 이상 없거나 실패 상태이면, workers 리더가 유실된 pod의 프로바이더 참가자를 정리합니다.
KUBERNETES_SERVICE_HOST, KUBERNETES_SERVICE_PORT server/core/provider_process.py Kubernetes가 설정 유실된 pod 확인이 서비스 어카운트 토큰과 함께 질의하는 API 서버입니다.
NODE_OPTIONS server/code/workers/scip_ts_delta.py, scip_py_delta.py 설정 안 됨 컴파일러 티어 인덱서 서브프로세스에 그대로 전달됩니다. 해당 서브프로세스의 다른 모든 변수는 워커가 설정합니다.
SCIP_ENV_JSON server/code/workers/scip_py_delta.py 설정 안 됨 Python 컴파일러 티어 인덱서에 그대로 전달됩니다.
PATH server/code/workers/scip_go_delta.py 상속됨 Go 툴체인과 인덱서 바이너리를 찾는 데 사용됩니다. 서브프로세스는 자체 PATH를 갖습니다.
LOOM_WEBHOOK_SECRET_<ORG>__<NAME> server/core/webhooks.py 설정 안 됨 웹훅 서명 시크릿으로, 메모리 웹훅의 secret_ref 또는 작업 인박스의 webhook_secret_ref가 가리키는 이름입니다. ORG는 작업 인박스 웹훅에서처럼 인코딩된 org id입니다. whsec_ 접두사는 base64 키를 뜻하며, 공백은 제거됩니다. 설정되지 않았거나, whsec_ 값이 비어 있거나 base64가 아니거나, 값이 UTF-8이 아니면 시크릿을 사용할 수 없습니다. 이 경우 메모리 웹훅 이벤트는 대기하고(2.5일 후 dead 처리), 작업 인박스의 알림은 보류되며, 서버는 해당 변수 이름을 밝혀 한 번 경고합니다. 알 수 없는 변수 경고는 이 접두사를 가진 모든 이름을 건너뜁니다.

프로바이더 선택 자체(LOOM_EMBEDDING_MODEL, LOOM_LLM_PROVIDER, LOOM_LLM_MODEL)는 설정 항목입니다. 배포와 LLM 아키텍처를 참고하세요.

컨테이너 이미지와 uvicorn

이미지의 명령인 scripts/serve.sh가 이 값들을 읽어 uvicorn을 시작합니다. 이 스크립트는 값을 환경 변수에서만 가져오며 .env나 LOOM_ENV_FILE에서는 가져오지 않습니다(compose의 env_file:은 값을 환경에 설정합니다). 단, 설정 필드인 LOOM_WEB_WORKERS, LOOM_TRUSTED_PROXIES, LOOM_RUNTIME_DIR은 예외이며, 서버가 로드할 때 환경, env 파일, 설정 파일 순으로 해석합니다. uvicorn 자체의 UVICORN_<OPTION> 변수는 읽지 않습니다. scripts/serve.sh가 전달하지 않는 uvicorn 옵션에 대해 이 변수가 설정되어 있으면 웹 티어는 시작을 거부합니다.

변수 기본값 의미
PORT 7777 uvicorn이 컨테이너 안에서 바인딩하는 포트입니다.
LOOM_LISTEN_HOST 127.0.0.1 uvicorn --host: 수신 대기하는 주소입니다. 이미지는 0.0.0.0으로 설정합니다. LOOM_BIND_HOST는 시작 점검이 읽는 주소로 유지되며, 환경에 설정되어 있지 않으면 scripts/serve.sh가 루프백이 아닌 수신 주소로 설정합니다(env 파일이나 설정 파일의 값을 덮어씁니다).
LOOM_WEB_WORKERS CPU당 1개, 최대 8개 uvicorn --workers. 설정하지 않으면 컨테이너가 사용할 수 있는 CPU(cpuset을 CPU 할당량으로 낮춘 값)당 1개이며, 메모리 1GiB당 최대 1개, 전체 최대 8개입니다. .env에 개수를 지정하지 않으면 compose 파일이 값을 설정합니다. deploy/standalone과 개발 스택은 2, 클라우드와 colour 스택은 1입니다. 설정 필드이기도 하며, 속도 제한기가 예산을 이 값으로 나눕니다。
LOOM_UVICORN_LOOP asyncio uvicorn --loop: asyncio, auto, uvloop 중 하나입니다. uvloop는 git을 실행할 때마다 프로세스 전체를 포크하므로 루프가 멈춥니다.
LOOM_TRUSTED_PROXIES 127.0.0.1 uvicorn --forwarded-allow-ips: X-Forwarded-For/-Proto를 적용할 피어입니다.
LOOM_GRACEFUL_SHUTDOWN_S 10 uvicorn --timeout-graceful-shutdown: 종료 중인 프로세스가 요청을 처리하며 비우는 시간입니다.
LOOM_KEEP_ALIVE_S 5 uvicorn --timeout-keep-alive: 유휴 연결을 열어 두는 시간입니다. 연결을 재사용하는 로드 밸런서 뒤에서는 로드 밸런서의 유휴 타임아웃보다 길어야 합니다.

빌드 인수: LOOM_BUILD_COMMIT(이미지에 LOOM_BUILD_COMMIT으로 내장되며 build_commit으로 보고됩니다). 이미지에는 항상 로컬 CPU 임베더와 기본 모델이 포함되어 있으며 LOOM_LOCAL_EMBEDDING_MODEL_DIR=/app/models로 설정됩니다. 나머지 ARG는 컴파일러 티어 인덱서의 도구 체인 버전과 체크섬을 고정합니다(GO_VERSION, NODE_VERSION, SCIP_GO_VERSION, SCIP_CLANG_VERSION, 이들의 *_SHA256* 값, LLVM 서명 키의 지문인 LLVM_SIGNER_FPR). scripts/install-code-toolchains.sh는 npm으로 설치하는 도구(scip-typescript, scip-python, 패키지 관리자)의 버전을 고정합니다.

Compose 파일

변수 읽는 곳 기본값 의미
LOOM_CH_HOST_PORT, LOOM_CH_NATIVE_HOST_PORT dev/docker-compose.dev.yml, dev/ci_start_clickhouse.sh 8123, 9000 로컬 ClickHouse가 게시하는 호스트 포트(HTTP 및 네이티브)입니다.
LOOM_CH_CONTAINER dev/ci_start_clickhouse.sh loom-ch 컨테이너 이름입니다. 두 번째 ClickHouse(워크트리당 하나)를 첫 번째 옆에서 실행할 수 있습니다.
LOOM_COLOUR, LOOM_COLOUR_PORT dev/docker-compose.colour.yml 필수 blue/green 프로젝트가 실행할 색(blue 또는 green)과 호스트 포트(7781 또는 7782)입니다.
LOOM_CLICKHOUSE_IMAGE compose.yaml, dev/ci_start_clickhouse.sh clickhouse/clickhouse-server:latest 스택이 실행하는 ClickHouse 이미지입니다. 릴리스 번들의 compose 파일은 기본값을 번들을 빌드하고 스키마를 검사한 릴리스로 지정합니다.
LOOM_IMAGE_REPOSITORY, LOOM_VERSION compose.yaml, install.sh ghcr.io/clickhouse/loom, latest 독립 실행형 스택이 실행하는 이미지와 태그입니다. 설치 프로그램은 .env에 태그를 고정합니다.
LOOM_EXTRACTOR_IMAGE_REPOSITORY compose.yaml, install.sh ghcr.io/clickhouse/loom-extractor 문서 추출기 서비스의 이미지이며 LOOM_VERSION으로 실행됩니다.
LOOM_PORT compose.yaml, install.sh 7777 독립 실행형 스택이 게시하는 호스트 포트입니다.
LOOM_REPOSITORY install.sh ClickHouse/loom 설치 프로그램이 릴리스를 다운로드하는 GitHub 저장소입니다.
LOOM_RELEASES_URL install.sh GitHub 설치 프로그램이 릴리스 파일을 다운로드하는 위치로, https:// URL입니다. 기본값은 https://github.com/$LOOM_REPOSITORY/releases입니다.
LOOM_CONNECT install.sh 설정 안 됨 묻지 않고 연결할 코딩 에이전트로, claude-code, codex, vscode의 쉼표 목록, all, 또는 단독 none입니다. 설정하지 않으면 터미널에서는 묻고, 터미널이 없는 실행에서는 아무것도 연결하지 않습니다(빠른 시작).
LOOM_LOCAL_MODELS install.sh 설정 안 됨 ollama는 묻지 않고 Loom의 모델 작업(추출, 그리고 활성화된 경우 어시스턴트)을 이 머신의 Ollama에서 실행하도록 설정합니다. off는 이를 제안하지 않습니다. 설정하지 않으면 터미널에서의 새 설치는 실행 중인 Ollama를 제안받습니다(모델과 키).
LOOM_NO_OPEN install.sh 설정 안 됨 1은 설치 프로그램이 브라우저에서 대시보드를 열지 않도록 합니다.

설치 프로그램에 LOOM_VERSION을 주면 해당 릴리스를 설치합니다. 주지 않으면 릴리스의 install.sh는 자신의 릴리스를 설치하고, 저장소의 사본은 latest를 설치합니다. 더 새로운 설치 위에 더 오래된 릴리스를 설치하는 것은 LOOM_VERSION으로 명시하지 않으면 거부됩니다 (먼저 ClickHouse를 고정하세요: 설치 프로그램으로 설치한 환경 다운그레이드).

compose 파일의 다른 ${LOOM_*} 참조는 compose 수준의 기본값이 주어진 설정 필드와 위의 uvicorn 변수입니다. 설치 프로그램은 두 이미지 저장소(LOOM_IMAGE_REPOSITORY, LOOM_EXTRACTOR_IMAGE_REPOSITORY), 태그, 포트, 바인드 호스트, LOOM_CLICKHOUSE_IMAGE가 주어지면 .env에 유지합니다. 기본 .env가 설정하는 내용은 빠른 시작에서 설명합니다.

loom CLI

변수 읽는 곳 기본값 의미
LOOM_BASE_URL server/cli/_client.py 및 클라이언트 명령 http://localhost:7777 클라이언트 명령(install, demo, export-okf, …)이 통신하는 서버입니다.
LOOM_API_KEY server/cli/_client.py 및 클라이언트 명령 설정 안 됨, 이후 ~/.loom/token 클라이언트 명령이 제시하는 토큰입니다. 여기에 오래된 값이 있으면 ~/.loom/token보다 우선합니다.
LOOM_BIND_HOST, LOOM_BIND_PORT server/cli/serve.py 0.0.0.0, 7777 loom serve --host 및 --port의 기본값입니다.
LOOM_CONFIG_FILE server/cli/_client.py ~/.loom/config.json loom doctor --client가 읽는 클라이언트 설정입니다(loom init이 작성하는 파일).
LOOM_API_KEY_FILE server/cli/_client.py, 플러그인의 lib/loom-client.mjs, grep shim ~/.loom/token LOOM_API_KEY가 설정되지 않았을 때 읽는 토큰 파일입니다.

CLI 레퍼런스를 참고하세요.

SDK

변수 읽는 주체 기본값 의미
LOOM_BASE_URL Python 및 TypeScript SDK http://localhost:7777 생성자에 서버를 지정하지 않았을 때 사용하는 서버입니다.
LOOM_API_KEY Python 및 TypeScript SDK loom login 세션, 없으면 ~/.loom/token 생성자에 지정하지 않았을 때 사용하는 베어러 토큰입니다. 빈 값은 설정하지 않은 것으로 간주합니다.
LOOM_PROFILE Python 및 TypeScript SDK default 생성자에 지정하지 않았을 때 클라이언트가 사용하는 ~/.loom/credentials의 loom login 세션입니다.
LOOM_LOG_LEVEL Python 및 TypeScript SDK 설정 안 됨 SDK 로거의 레벨입니다(debug, info, warning/warn, error, off).
LOOM_MENTOR_BRIEF Python 및 TypeScript SDK 꺼짐 on이면 첫 호출 시 백그라운드에서 mentor.brief를 가져옵니다.
LOOM_AUTO_RUN Python SDK 꺼짐 각 Agent의 수명에 암묵적 실행(run)을 바인딩합니다.

Python SDK와 TypeScript SDK를 참고하세요.

코딩 에이전트 플러그인과 훅 스크립트

변수 읽는 곳 기본값 의미
LOOM_ORG, LOOM_NAMESPACE, LOOM_AGENT 플러그인의 lib/loom-client.mjs, integrations/cursor/, integrations/generic/, dev/loom_init.py ~/.loom/config.json, 그다음 토큰의 클레임, 그다음 default / coding / 클라이언트 이름 훅과 스크립트가 캡처한 행을 기록할 때 사용하는 ID입니다.
LOOM_HOOK_TIMEOUT_MS 플러그인의 lib/loom-client.mjs 측정한 /v1/health 왕복 시간의 5배, 3000에서 8000 사이 각 훅 요청을 중단시키는 타임아웃입니다. loom doctor --client가 이 값을 보고합니다.
LOOM_HOOK_EXIT_MS 플러그인의 lib/loom-client.mjs LOOM_HOOK_TIMEOUT_MS 훅 프로세스가 요청을 보낸 뒤 종료하기 전에 대기하는 시간입니다.
LOOM_SHUNT_READ_CAP 플러그인의 hooks/loom-code-shunt.mjs 0 (꺼짐) 인덱싱되었고 수정되지 않은 파일의 범위 읽기가 이 줄 수를 넘으면 대신 코드 도구로 보냅니다.

Claude Code 플러그인을 참고하세요.

운영자 스크립트

변수 읽는 곳 기본값 의미
LOOM_REPO redeploy.sh 스크립트가 있는 디렉터리 배포 체크아웃입니다.
LOOM_REDEPLOY_READY_TIMEOUT_S redeploy.sh 180 전환을 중단하기 전에, 유휴 상태인 색상의 /v1/health가 준비 완료를 보고할 때까지 기다리는 시간입니다.
LOOM_PUBLIC_HEALTH_URL redeploy.sh 설정 안 됨 설정하면 클라이언트가 사용하는 상태 확인 URL을 마지막에 확인합니다.
LOOM_PREFLIGHT_STRICT redeploy.sh 1 0으로 설정하면 원장에만 있는 마이그레이션 행과 체크섬 불일치를 중단하지 않고 보고만 합니다.
LOOM_PREFLIGHT_HEALTH_URL dev/redeploy_preflight.sh http://localhost:7777/v1/health 사전 점검이 읽는 상태 확인 URL입니다.
LOOM_PREFLIGHT_PORT dev/redeploy_preflight.sh 7777 사전 점검이 확인하는 포트입니다.
LOOM_PREFLIGHT_MIGRATE dev/redeploy_preflight.sh $PYTHON -m server.core.schema.migrate --dry-run 사전 점검이 실행하는 마이그레이션 드라이 런 명령입니다.
HDX_BASE, HDX_COOKIE 또는 HDX_EMAIL + HDX_PASSWORD, HDX_DB, HDX_PREFIX, HDX_CONNECTION_ID, DRY_RUN deploy/clickstack_sources.sh HDX_DB=default, HDX_PREFIX=loom, DRY_RUN=0 Loom의 ClickStack 소스를 등록할 HyperDX 인스턴스, 자격 증명, 이름 규칙입니다.
LOOM_ADMIN_TOKEN dev/onboard_tenant.py 설정 안 됨 테넌트를 온보딩하는 관리자 토큰입니다.
LOOM_OUTPUT_DIR dev/loom_init.py, dev/onboard_tenant.py . 온보딩 스크립트가 출력 파일을 쓰는 위치입니다.
LOOM_REBUILD_DIR scripts/ops/table_rebuild.py, scripts/ops/vector_codec_rebuild.py . 재빌드 스크립트가 실행을 중단시키는 ABORT_REBUILD 파일을 찾는 위치이며, vector_codec_rebuild.py가 생성한 트윈의 UUID(<table>_rebuild.uuid)를 기록하는 위치입니다. 이 UUID로 트윈이 잔여물인지 판단하므로, 하나의 재빌드에 속한 모든 명령은 같은 디렉터리에서 실행하세요.
LANGFUSE_HOST, LANGFUSE_ORG_API_KEY dev/loom_init.py 설정 안 됨 dev/loom_init.py 실행 중 Langfuse 프로젝트를 프로비저닝합니다.

재배포 절차와 사전 점검은 배포와 업그레이드를 참고하세요. 컴파일러 티어 워커는 코드 인덱스 운영을, ClickStack은 ClickStack을 참고하세요.

관련 문서

  • 구성 참조: 모든 LOOM_* 설정 필드.
  • 배포: 필수 환경, 공급자 및 프로덕션 체크리스트.