Skip to main content
Scout is packaged as the atlas-scout application and exposes the scout command.

​
Install From Source

Install Scout from the Atlas repository:
Verify the command:
Run the setup flow:
scout-dev is for Atlas contributors working inside the repository. It is not installed for end users.

​
Homebrew

Homebrew will be the simplest install path after the first Scout formula is published:
If that command fails, use the source install above.

​
Requirements

  • macOS with Homebrew.
  • A local model provider, such as LM Studio or Ollama, for local discovery.
  • A search key for search-backed discovery.
  • An Atlas account only when you want login, sync, or worker mode.
Scout stores configuration and local data in OS-standard user directories. Run:

​
JavaScript-Rendered Pages

Scout fetches pages without a browser first. When a page needs JavaScript, Scout can use headless Chromium through Playwright. When Scout is installed with Homebrew, the formula installs the Playwright Python package but does not download Chromium during install. Add Chromium when you want JavaScript rendering:
For source installs, use Playwright directly through uvx:

​
Optional Shell Integration

Scout can install shell completion and local man pages:
Use explicit directories when your shell environment needs them: