Getting Started#

Welcome to Osprey Framework! This comprehensive guide will take you from zero to building production-ready control system agents, with working results at every step.

What You’ll Accomplish#

By following this comprehensive learning path, you’ll have:

  • A fully functional development environment

  • Your first working agent (weather assistant)

  • Production-grade control system patterns (control assistant)

  • Framework mastery through essential development patterns

  • Complete API reference for daily development

Prerequisites
  • Python 3.11+ installed

  • Basic Python knowledge

  • Terminal/command line familiarity

  • Text editor or IDE

Your Learning Path#

📦 1. Fresh Installation

Get your development environment running with Podman, dependencies, and configuration. Includes interactive CLI for easy project creation!

Outcome: Working dev environment

Installation & Setup
🧠 1a. Conceptual Tutorial

Build a mental model of how Osprey and its applications work, before diving into code.

Outcome: Prepared mind for your Osprey journey

Conceptual Tutorial
🌤️ 2. Hello World

Build a weather agent with natural language queries and mock API integration.

Outcome: Your first working agent

Hello World Tutorial
🎛️ 3. Control Systems

Production control system patterns with channel finding pipelines and comprehensive tooling.

Outcome: Enterprise integration patterns

Production Control Systems Tutorial
💡 4. Explore Examples

See production applications like ALS Assistant for advanced patterns.

Outcome: Real-world inspiration

Example Applications
⚡ 5. Framework Mastery

Master essential development patterns: capabilities, state management, and testing workflows.

Outcome: Framework expertise

Quick Start Patterns
📚 6. API Reference

Complete method documentation, parameters, and return values for daily development.

Outcome: Development reference

API Reference