How-To Guides#

Task-oriented guides that walk you through common OSPREY operations step by step. Each guide focuses on a single goal and assumes you already have a working OSPREY installation.

Framework & Infrastructure#

Configure LLM Providers

Set up and switch between supported LLM providers — Anthropic, OpenAI, Google, CBORG, AMSC, Ollama, and others — via config.yml.

Configure LLM Providers
Deploy a Project

Create, configure, and deploy an OSPREY project from osprey build through osprey deploy to a running instance.

Container Deployment
Build Profiles

Assemble facility-specific assistants from templates with config overrides, file overlays, and custom MCP servers.

Build Profiles
Add an MCP Server

Build and register a new FastMCP server to expose domain-specific tools that Claude Code can discover and call.

Add an MCP Server
Use the Web Terminal

Launch and operate the Web Terminal interface for interactive Claude Code sessions with your control system.

Use the Web Terminal
Use the CLI Chat Interface

Run Claude Code in your native terminal with companion services accessible in a browser.

Use the CLI Chat Interface
Use the Python Executor

Run Claude-generated Python scripts safely in a containerized environment with access to the OSPREY runtime API.

Python Execution Service
CLI Reference

Complete reference for all osprey commands — build, deploy, config, health, claude, web, and more.

CLI Reference

Services & Connectors#

Add a Control System Connector

Create a custom connector to integrate a new control system protocol (beyond EPICS and Mock) with OSPREY’s protocol-agnostic architecture.

Control System Integration
Use the Channel Finder

Search, filter, and explore control system channels using the Channel Finder service and its web interface.

How to Use the Channel Finder
ARIEL Logbook Search

Intelligent search over facility electronic logbooks with keyword, semantic, RAG, and agentic retrieval modes.

Logbook Search Service (ARIEL)