설정
anyy setup은 설치 명령을 작동하는 개인 비서로 만드는 안내 방식입니다. 모델, 메시징, 선택 미디어·웹, MCP를 구성할 수 있습니다.
첫 설치는 Quick setup입니다. 대체 모델·메시징·외부 도구 전에 로컬 대화 하나를 작동시키세요.
시작 전에
대화형 터미널과 다음 중 사용 가능한 모델 연결이 필요합니다.
- 공급자 API 키.
- 지원 구독 로그인.
- 실행 Ollama·LM Studio.
- OpenAI·Anthropic 호환 엔드포인트.
원하는 프로필에서 실행:
anyy setup
기본 아닌 경우 명령 앞 --profile NAME 또는 뒤 --home PATH:
anyy --profile work setup
anyy setup --home /path/to/anyy-home
모드 선택
첫 화면 두 경로:
| 모드 | 구성 |
|---|---|
| Quick setup | 공급자, 인증, 기본 모델, 선택 대체 모델, 메시징 |
| Full setup | Quick 전체 후 선택 이미지·동영상·음성·웹·MCP |
둘 다 단일 검토로 끝납니다. Write these changes? 확인 후 수집 구성을 확정합니다. 명시 로그인은 확인 전에 인증 서비스에 접촉할 수 있습니다.
기본 모델 구성
Provider & Model 질문:
- 공급자.
- 제공 인증 방식.
- 필요한 엔드포인트·자격 증명.
- 기본 모델.
카탈로그가 있으면 가져와 선택하게 합니다. 호환·로컬은 수동 ID가 필요할 수도 있습니다.
일반 경로:
| 연결 | 선택 |
|---|---|
| OpenAI API 키 | OpenAI → OpenAI API key |
| ChatGPT 구독 | OpenAI → ChatGPT subscription (Codex) |
| Anthropic 키 | Anthropic → Anthropic API |
| Claude Code 구독 | Anthropic → Claude Code subscription |
| 로컬 모델 | Ollama 또는 LM Studio |
| 호환 서비스 | OpenAI-compatible 또는 Anthropic-compatible |
설치 마법사가 기준 카탈로그이며 해당 버전에 구현된 인증만 보입니다.
프롬프트, 첨부, 요청 메타데이터를 받습니다. 운영하거나 신뢰하는 곳만 쓰세요.
모델만 구성
메시징·도구 없이 인증·기본 모델 변경:
anyy setup model
Gateway가 접근 가능하면 확인 기록 후 공급자를 다시 로드합니다. 아니면 다음 런타임 시작에 적용됩니다.
대체 모델 추가
두 설정 모두 대체 라우팅을 묻습니다. 두 번째 검증 모델이 없다면 첫 실행에는 건너뛰세요.
나중 순서 체인 관리:
anyy setup model fallback
기본 모델이 먼저 필요합니다. 기본 불가에서 이동할 수 있을 때 저장 순서로 시도하며 유효 비밀·정상 공급자 대체물이 아닙니다.
메시징 연결
Messaging에서 지원 플랫폼 또는 건너뛰기를 고릅니다. 전용 실행:
anyy setup channel
계정 ID, 접근 정책, 웹훅, 비밀을 물을 수 있습니다. 변경 확인 시 상주 Gateway를 설치·시작해 터미널 종료 뒤에도 유지합니다.
웹훅에는 기본 비활성 리스너도 필요합니다. channel_webhooks.enabled와 접근 가능 channel_webhooks.listen을 설정하고 Gateway 재시작 후 콜백을 구성하세요. 계정 저장·다시 로드만으로 켜지지 않습니다. 플랫폼 인증·공개 HTTPS 안내를 따르세요.
지원·페어링·상태·다시 로드는 메시징 플랫폼을 참조하세요.
선택 기능
Full setup 추가 항목:
- 이미지 이해.
- 동영상 이해.
- 이미지 생성.
- TTS·STT.
- 웹 검색.
- 하나 이상의 MCP.
모두 선택입니다. 쓸 기능만 고르세요. 각 백엔드는 자체 비밀·데이터 처리·요금이 있습니다.
지원 입력으로 검증하세요. Dashboard는 PNG/JPEG는 이미지, 나머지는 파일이므로 오디오·동영상 업로드만으로 이해가 실행되지 않습니다. 미디어 이해를 참조하세요.
검토와 기록
Review Changes에서 공급자, 모델, 엔드포인트, 비밀 수, 대체, 채널, 선택 기능, MCP를 확인하세요.
확인:
Write these changes? [Y/n]
성공하면 setup complete와 다음을 제안합니다.
anyy status
anyy config
anyy
최종 확인 전 취소는 로컬 수집 설정을 쓰거나 채널 작업을 제출하지 않습니다. 확인 후는 상주 Gateway로 직접 실행하며 로컬 영수증과 연결 진단을 따로 보고합니다.
데이터 저장 위치
선택 홈 기준:
| 데이터 | 위치 |
|---|---|
| 공급자·모델·라우팅·기능 | <PROFILE_HOME>/config.yaml |
| 공급자/MCP 비밀 파일 | <PROFILE_HOME>/secrets/ |
| 채널 계정·보호 암호화 비밀 | <PROFILE_HOME>/state.db |
| 세션·런타임 | <PROFILE_HOME>/state.db |
비밀 파일·암호화 채널 바인딩은 config.yaml과 별개이며 모드 0600입니다. 값 출력 없이 경로·상태는 anyy config로 보세요.
전용 설정 명령
anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
[--set INPUT=VALUE] \
[--sensitive-fd INPUT=FD] \
[--external-locator-fd INPUT=FD]
마지막은 비대화형 채널이며 민감 값은 디스크립터로 읽어 기록·프로세스 인수에 남기지 않습니다.
문제 해결
| 문제 | 해결 |
|---|---|
requires an interactive terminal | anyy setup, anyy setup model, 대화형 anyy setup channel을 터미널에서 직접 실행 |
| 빈 API 키로 취소 | anyy setup model 재실행 후 유효 키·다른 인증 |
| 로컬 모델 없음 | 서버 시작·엔드포인트 확인 후 재설정 |
| 구독 미완료 | 브라우저/장치 완료 후 터미널 만료면 재설정 |
| 저장이 안 보임 | anyy config로 프로필·홈 비교 |
| 채널 연결 불가 | anyy channel doctor CHANNEL, 수정 후 anyy channel reload |
Dashboard 개요 또는 모델 구성으로 이어가세요.