환경 변수
코드가 실제로 읽는 값만 적었어요.
서버
서버(services/api)를 직접 운영할 때 써요. 데스크톱 앱은 필요한 값을 스스로 넘기니 따로 정할 것이 없어요.
| 이름 | 필수 | 기본값 | 뜻 |
|---|---|---|---|
PUBLIC_URL | ✓ | 바깥 주소(경로 없는 https://...). 로그인 콜백, 쿠키 Secure, Origin 검사, CSP, 맥 스크립트가 모두 써요. http 는 DEV_NO_AUTH 에서만 | |
SESSION_SECRET | ✓ | 쿠키 서명 키, 32자 이상 | |
ALLOWED_LOGINS | ✓ | 들어올 수 있는 로그인, 쉼표로(대소문자 무시). 비어 있으면 시작하지 않아요. GitHub 은 id:12345 로도 적어요 | |
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET | (가) | GitHub OAuth 앱으로 로그인 | |
OIDC_ISSUER / OIDC_CLIENT_SECRET | (나) | 일반 OIDC 로그인 | |
OIDC_CLIENT_ID | notype | OIDC 클라이언트 id | |
AGENT_TOKEN | 고정 에이전트 토큰(32자 이상). 비우면 시작하기 페이지에서 받은 토큰만 통해요 | ||
TRUSTED_PROXIES | (아무도 안 믿음) | 리버스 프록시 주소 CIDR, 쉼표로. 이 주소에서 온 요청만 X-Forwarded-For 를 봐요 | |
AGENT_DIST_DIR | /usr/local/share/notype/agent (이미지) | 맥에 내줄 에이전트 바이너리 폴더 | |
DATA_DIR | /data | SQLite(notype.db), 녹음(audio/), 붙인 파일(files/) | |
PORT / ADDR | 8080 / :$PORT | 듣는 주소 | |
DEV_NO_AUTH | 1 이면 로그인 없이 열어요. ADDR 이 루프백이 아니면 시작을 거부해요 | ||
NOTYPE_LOCAL_TOKEN | 데스크톱 앱이 쓰는 로컬 모드. 이 토큰을 쿠키로 든 요청만 받아요. ADDR 이 루프백이고 AGENT_TOKEN 이 있어야 해요 |
로그인 방식은 (가)·(나) 중 정확히 하나예요(로컬 모드·DEV_NO_AUTH 는 제외). ANTHROPIC_API_KEY 는 쓰지 않아요.
에이전트
맥의 notype-agent 가 읽어요. 괄호 안은 같은 뜻의 플래그예요.
| 이름 | 기본값 | 뜻 |
|---|---|---|
NOTYPE_SERVER (-server) | ~/.notype/server | 서버 주소. 연결 스크립트가 넘겨요 |
AGENT_TOKEN | ~/.notype/token | 토큰을 직접 줄 때 |
WLK_URL (-wlk) | 이미 떠 있는 WhisperLiveKit /asr 주소. 주면 직접 띄우지 않아요 | |
WLK_DIR (-wlk-dir) | ~/.notype/WhisperLiveKit | WhisperLiveKit 설치 폴더. 없으면 받아쓰기 없이 AI 만 연결해요 |
WLK_MODEL (-wlk-model) | 맥에 맞춰 고름(지금은 늘 small) | 실시간 초안 모델 |
NOTYPE_LIVE_REFINE (-live-refine) | auto | 회의 중 정밀 받아쓰기 on·off·auto. auto 는 메모리 24GB 미만이면 꺼요 |
NOTYPE_REFINE_MODEL (-refine-model) | mlx-community/whisper-large-v3-turbo | 정밀 받아쓰기·정리본 모델. off 면 꺼요(줄은 초안 그대로, 정리는 실시간 줄로) |
WLK_LANGUAGE (-language) | ko | 받아쓰기 언어 |
CLAUDE_BIN | PATH 의 claude → /opt/homebrew/bin/claude → ~/.local/bin/claude | claude 실행 파일 |
CLAUDE_MODEL | sonnet | claude --model 값 |
NOTYPE_HOME | ~/.notype | 토큰·서버 주소·기록을 두는 곳 |
설치 스크립트(/setup)는 WLK_DIR 과 WLK_REPO(미러 주소)도 읽어요.
데스크톱 앱
| 이름 | 기본값 | 뜻 |
|---|---|---|
NOTYPE_HOTKEY | Alt+CommandOrControl+R | 녹음 단축키(Electron accelerator 형식) |
NOTYPE_DEBUG_PORT | start.sh 가 읽어요. 주면 자동 시험용 원격 조작 포트를 127.0.0.1 에 열어요. 평소엔 쓰지 않아요 |
데스크톱 앱에 값 넘기기
데스크톱 앱은 open·Raycast·Spotlight 로 떠서 터미널의 환경 변수를 그대로 받지 못해요. 그래서 앱이 시작할 때 로그인 셸에서 NOTYPE_HOTKEY 와 위 에이전트 값(NOTYPE_HOME, WLK_DIR, WLK_URL, WLK_MODEL, WLK_LANGUAGE, NOTYPE_LIVE_REFINE, NOTYPE_REFINE_MODEL, CLAUDE_BIN, CLAUDE_MODEL)을 읽어 와 에이전트까지 넘겨요.
- 늘 쓸 값:
~/.zshrc등에export해 두기 - 한 번만:
NOTYPE_HOTKEY=… sh desktop/scripts/start.sh(이 값이 셸 설정보다 앞서요)
값을 바꾼 뒤엔 앱을 끝냈다가 다시 띄워야 해요.