설치

이 페이지는 macOS·Linux에 네이티브 anyy를 설치합니다. 완료 후 anyy --version이 작동해야 합니다. 공급자 설정, 프로필 데이터, 상주 Gateway는 별도 단계입니다.

지원 설치 대상

네이티브 설치 프로그램은 macOS·Linux의 amd64/x86_64, arm64/aarch64를 지원합니다. 네이티브 Windows는 대상이 아닙니다.

빠른 설치

사전 요건

필요 항목:

지원 macOS·Linux 컴퓨터.
anyy.ai 인터넷 연결.
POSIX sh와 curl, tar, gzip, awk, sed, mktemp, readlink, sha256sum 또는 shasum.

다운로드 전에 명령을 검사합니다. 일반 개인 설치에는 root가 필요 없습니다.

설치 확인

실행:

anyy --version

다음으로 시작해야 합니다.

Anyy (anyy) version

Command: anyy 대신 Binary:면 표시 경로에 --version을 실행하세요. PATH 안내의 정확한 디렉터리를 추가하고 새 셸을 여세요.

일반 비root 설치는 다음 진입점을 만들려고 합니다.

$HOME/.local/bin/anyy

셸 시작 파일을 편집하거나 무관한 기존 anyy를 교체하지 않습니다.

설치 프로그램 동작

순서:

darwin·linux, CPU amd64·arm64를 감지·매핑합니다.
홈·버전을 결정합니다.
릴리스 변경 두 개가 겹치지 않게 홈별 설치/업데이트 잠금을 얻습니다.
명령과 임시·홈 여유 공간을 확인합니다.
아카이브·CHECKSUMS.sha256를 받고 제한 재시도하며 부분 파일을 남기지 않습니다.
SHA-256 및 안전하지 않은 경로·링크를 검증합니다.
버전 디렉터리에 바이너리를 두고 current를 원자 전환합니다.
설치 출처를 기록하고 다른 파일을 덮지 않을 때 진입점을 만듭니다.
명령·Gateway 상태를 보고합니다.

설치는 바이너리에서 끝납니다

모델 선택, config.yaml 기록, state.db 생성, 서비스 설치·시작은 하지 않습니다. 명령이 준비되면 anyy setup을 실행하세요.

설치 디렉터리 구성

설치 사용자에 따른 기본값:

사용자	Anyy 홈	명령 진입점
일반	`$HOME/.anyy`	`$HOME/.local/bin/anyy`
`root`	`/root/.anyy`	`/usr/local/bin`, `/opt/homebrew/bin`, `/usr/bin` 중 첫 쓰기 가능 위치
사용자 `ANYY_HOME`	제공 경로	위 사용자/root 진입점에서 해당 홈을 가리킴

상주 구성:

<ANYY_HOME>/
├── releases/
│   └── <version>/anyy
├── current -> releases/<version>
├── bin/
│   └── anyy -> ../current/anyy
├── .install/
│   ├── source.json
│   └── previous        # present after a release change when rollback exists
├── backups/
├── cache/
├── logs/
├── memory/
├── scripts/
├── secrets/
├── skills/
├── system/
└── workspace/

홈·관리 디렉터리는 0700, .install/source.json은 0600입니다. 이후 명령이 필요할 때만 런타임·프로필 파일을 만듭니다.

런타임이 영속 상태를 처음 열면 state.db·콘텐츠 주소 objects/도 만듭니다. 설치 제공 파일이 아닌 런타임 데이터입니다.

활성화는 current 링크로 한 번에 전환합니다. 이전 활성 릴리스가 있으면 롤백 대상으로 기록합니다.

설치 옵션

파이프 뒤 sh에 설정하세요.

변수	기본값	용도
`ANYY_HOME`	`$HOME/.anyy`, root는 `/root/.anyy`	다른 홈 설치
`VERSION`	`https://anyy.ai/releases/latest` 반환 버전	사용 가능한 특정 `vMAJOR.MINOR.PATCH`
`ANYY_INSTALL_COMPACT`	`0`	공간 부족 시 이전 롤백 이력 상실 수락
`ANYY_RELEASE_BASE_URL`	`https://anyy.ai/releases`	신뢰 호환 미러 운영

사용자 지정 홈

curl -fsSL https://anyy.ai/install.sh | ANYY_HOME="$HOME/.local/share/anyy" sh

설치 진입점 명령은 상주 홈을 추론할 수 있으며 지원하면 --home PATH를 명시할 수도 있습니다.

특정 릴리스 설치

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh

사용 가능한 태그로 바꾸세요. VERSION=latest는 거부하며 최신은 VERSION 미설정 상태를 쓰세요.

저공간 호스트의 compact 모드

curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

compact는 롤백 이력을 줄일 수 있습니다

활성 릴리스는 항상 보존합니다. 비활성 및 홈 공간 검사에 꼭 필요할 때 이전 롤백 대상도 제거할 수 있습니다. 롤백을 유지하려면 공간 확보가 더 안전합니다.

릴리스 출처를 신뢰해야 합니다

사용자 ANYY_RELEASE_BASE_URL이 바이너리와 체크섬을 모두 제공합니다. 직접 제어하거나 독립적으로 신뢰하는 출처만 쓰세요.

재설치와 업데이트

같은 릴리스가 이미 활성일 때 표준 설치를 반복하면 다운로드·대체 없이 내부·명령 진입점을 복구합니다.

상주 설치에서 최신 확인:

anyy update --check

일반 업그레이드는 anyy update입니다. 버전, compact, 롤백은 업데이트를 참조하세요.

설치 후

대화형 설정:

anyy setup

Dashboard 열기:

anyy dashboard

전체 첫 실행은 빠른 시작, 공급자·모델은 설정을 참조하세요.

문제 해결

증상	의미	조치
`unsupported operating system`·`unsupported architecture`	해당 네이티브 릴리스 없음	지원 macOS·Linux `amd64`/`arm64` 사용. 네이티브 Windows 미지원
`<command> is required for release install`	로컬 도구 누락	해당 명령 설치 후 재실행
`Preflight failed: not enough ... space`	안전 여유 포함 공간 부족	임시·홈 공간 확보. 롤백 감소 수락 시만 compact
`another Anyy install or update is already running`	다른 작업이 홈 잠금	완료 후 재시도
`checksum mismatch`	공개 체크섬과 불일치	재시도. 검증 우회·수동 활성화 금지
`Command entrypoint already exists and was not replaced`	다른 파일·활성 링크가 경로 소유	출력 `Binary:` 실행 후 충돌 직접 해결
성공 후 `anyy: command not found`	현재 `PATH`에 진입점 없음	출력된 정확한 안내 후 새 셸에서 `anyy --version` 확인
`Gateway: status unavailable`	바이너리가 Gateway 보고 불가	바이너리 검증과 분리. `anyy setup` 후 필요하면 `anyy gateway status`
`No release was activated.`	후보 전환 전 중지	앞 오류 해결·재시도. 기존 활성은 교체되지 않음

빠른 설치​

사전 요건​

최신 릴리스 설치​

설치 확인​

설치 프로그램 동작​

설치 디렉터리 구성​

설치 옵션​

사용자 지정 홈​

특정 릴리스 설치​

저공간 호스트의 compact 모드​

재설치와 업데이트​

설치 후​

문제 해결​