설치
OmniScout를 설치하고 브라우저를 확인한 뒤 daemon을 실행하세요.
요구 사항
- Python 3.11+ —
python --version으로 확인하세요 - Chromium 기반 브라우저 — Chrome, Brave, Edge, Vivaldi, Opera, Arc 또는 Chromium
- macOS 또는 Linux — 데스크톱 자동화(
computer)는 현재 macOS만 지원합니다
설치
pip install omniscout설치를 확인하세요:
omniscout --version
omniscout --help브라우저 설정
OmniScout는 두 가지 방식으로 실제 브라우저를 구동합니다:
| 백엔드 | 설명 | 사용 시점 |
|---|---|---|
| Patchright (기본값) | OmniScout가 영속 프로필로 자체 Chromium을 실행합니다 | 설정 없이 격리된 자동화를 할 때 |
| Extension (선택) | 이미 로그인된 기존 브라우저를 구동합니다 | 이미 로그인된 사이트를 다룰 때 |
설치된 브라우저를 확인하고 Chromium 사용 가능 여부를 검증하세요:
omniscout settings browsers
omniscout install기존 브라우저를 직접 구동하려면 OmniScout가 해당 브라우저를 가리키도록 하고 extension을 로드하세요:
omniscout setup --browser dia이 명령은 extension을 다운로드하고 브라우저의 extensions 페이지를 엽니다. Load unpacked를 선택하고 출력된 폴더를 고른 뒤 팝업에 Daemon: connected가 표시되는지 확인하세요. 백엔드 차이에 대해서는 동작 원리를 참고하세요.
Daemon 시작
daemon은 브라우저를 따뜻하게 유지하는 long-lived 백그라운드 프로세스로, 모든 동작을 1초 이내로 만듭니다:
omniscout daemon start
omniscout daemon status한 번만 실행하면 됩니다 — 이후 명령어에서는 CLI가 daemon을 자동으로 시작합니다. 포트, 로그, 생명주기는 Daemon 및 세션을 참고하세요.
모델 예열
첫 검색이나 answer 호출 시 로컬 임베딩 모델을 다운로드합니다(그 이후에는 캐시됨). 작업 중간에 기다리지 않도록 미리 로드하세요:
omniscout warmup에이전트 스킬 설치 (선택 사항)
AI 에이전트가 OmniScout를 구동할 예정이라면 스킬 파일을 설치하여 Claude Code, Cursor, Codex, Gemini CLI가 자동으로 인식하도록 하세요:
omniscout install --skill전체 에이전트 설정은 AI 에이전트와 함께 사용하기를 참고하세요.
업데이트 및 제거
pip install --upgrade omniscout # update
pip uninstall omniscout # remove the package모든 로컬 상태(프로필, 캐시, 인덱스, memory)를 삭제하려면:
rm -rf ~/Library/Application\ Support/omniscout/ # macOS
rm -rf ~/.local/share/omniscout/ # Linux또는 OMNISCOUT_DATA_DIR로 위치를 재정의하세요. 설정을 참고하세요.