omp(오마이파이)란 무엇인가요?
Oh My Pi라고도 알려진 omp는 내장형 및 맞춤형 모델 제공자를 갖춘 터미널 코딩 에이전트입니다.
이 omp 가이드는 models.yml에서 TokenHub OpenAI 호환 공급자를 선언합니다. API 키는 환경 변수에서 확인되며 모델 컨텍스트 및 출력 값은 선택한 모델과 일치해야 합니다. models.yml 파일은 공급자 전송, 환경 지원 자격 증명, 모델 ID, 컨텍스트 창 및 최대 출력을 제어합니다. YAML 들여쓰기 또는 복사 제한으로 인해 로드가 방지되거나 잘못된 요청이 생성될 수 있으므로 omp 모델로 공급자를 검사하고 활성 작업에 사용하기 전에 작은 읽기 전용 작업을 테스트하세요.
omp는 번들 카탈로그인 ~/.omp/agent/models.yml, 런타임 검색 및 확장 등록 모델을 하나의 레지스트리로 결합합니다. TokenHub는 사용자 정의 models.yml 공급자이며 tokenhub/<model-id>로 선택됩니다.
1단계: omp가 해결할 수 있는 자격 증명 설정
export TOKENHUB_API_KEY="sk-..."apiKey는 환경 변수 이름 또는 리터럴 값으로 확인됩니다. TOKENHUB_API_KEY가 존재하는 경우 omp는 해당 값을 사용합니다. 그렇지 않으면 해당 텍스트를 키로 보냅니다. 변수를 구성한 후 변수가 존재하는지 확인하세요.
2단계: ~/.omp/agent/models.yml 편집
providers:
tokenhub:
baseUrl: __API_BASE_URL__/v1
api: openai-completions
apiKey: TOKENHUB_API_KEY
authHeader: true
models:
- id: YOUR_TOKENHUB_MODEL_ID
name: TokenHub / YOUR_TOKENHUB_MODEL_ID
contextWindow: 128000
maxTokens: 8192authHeader: true는 각 요청에 Authorization: Bearer <key>를 주입합니다. contextWindow 및 maxTokens를 해당 TokenHub 모델의 값으로 바꾸십시오.
3단계: 공급자가 로드되어 사용 가능한지 확인
omp models
omp models find YOUR_TOKENHUB_MODEL_ID모델은 선택 가능해지지 않고 omp의 레지스트리에 들어갈 수 있습니다. 공식적인 가용성 규칙은 공급자가 유효한 disabledProviders 목록에 없으며 키가 없거나 확인 가능한 자격 증명을 가지고 있다는 것입니다. tokenhub가 비활성화된 상태에서는 유효한 키로 공급자를 복원할 수 없습니다.
omp의 우선순위에 따라 자격 증명 충돌을 해결합니다.
하나의 공급자에 대한 여러 자격 증명의 경우 omp는 런타임 --api-key, models.yml apiKey, 로컬 인증 저장소 API 키, OAuth, 공급자 환경 변수 및 마지막으로 사용자 지정 공급자 대체를 확인합니다. models.yml에 TokenHub 키를 고정하는 것은 사용자 정의 기본 URL에 적합한 오래된 OAuth보다 우선합니다.
첫 번째 테스트에서는 tokenhub/YOUR_TOKENHUB_MODEL_ID를 선택하고 읽기 전용 작업을 실행한 후 TokenHub 로그를 검사합니다. 공급자가 없는 경우 YAML 및 disabledProviders를 검사합니다. 존재하지만 선택할 수 없는 경우 키 해상도를 검사합니다. 401의 경우 변수와 authHeader를 확인하세요. 400의 경우 기능과 토큰 제한을 확인하세요.
공식 참고자료
모델 선택 방법
omp (Oh My Pi) 공급자 FAQ
apiKey에는 models.yml에 무엇이 포함되어야 합니까?
TOKENHUB_API_KEY를 사용하세요. 해당 환경 변수가 존재하면 omp는 해당 값을 공급자 키로 확인합니다.
내 사용자 지정 공급자를 사용할 수 없는 이유는 무엇입니까?
models.yml 구문을 확인하고 공급자가 비활성화된 공급자에 없는지 확인하고 API 키 변수를 omp에 사용할 수 있는지 확인하세요.
다른 모델의 컨텍스트 값을 복사할 수 있나요?
아니요. 선택한 TokenHub 모델에 대한 실제 contextWindow 및 maxTokens를 선언하세요.
여기서 omp와 Oh My Pi는 동일한 도구인가요?
그렇습니다. 이 페이지에서는 Oh My Pi 터미널 코딩 에이전트와 해당 ~/.omp/agent/models.yml 공급자 구성을 다룹니다.
omp가 TokenHub를 사용하고 있는지 어떻게 확인하나요?
omp 모델을 실행하고, tokenhub/<model-id>를 선택하고, 읽기 전용 작업을 실행하고, TokenHub 로그에서 정확한 모델을 확인하세요.
참고 자료
이 설정은 TokenHub 및 공식 문서를 기준으로 하며, 최종 확인일은 2026-09-08。