번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. 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을 참고하세요.