Skip to content

🎓 Tutorials

Welcome to the SuperOptiX tutorials! These step-by-step guides will take you from complete beginner to building sophisticated AI agents and orchestras.

🚀 Getting Started Tutorials

🎯 Quick Start Workflow

Perfect for beginners. Build your first agent and run compile/evaluate/optimize.

What you'll learn: - Initialize a SuperOptiX project - Pull and compile an agent - Compile and understand the agent pipeline - Set up for evaluation and optimization

Time: 10-15 minutes
Difficulty: Beginner
Prerequisites: None

🔧 OpenAI SDK + GEPA Optimization

Build custom agents with native OpenAI SDK. Create a code reviewer using official OpenAI Agents SDK patterns and optimize it with GEPA.

What you'll learn: - Write agents using official OpenAI SDK patterns - Integrate native SDK agents with SuperOptiX - Define BDD test scenarios for measurable metrics - Run GEPA optimization to improve performance - Implement automatic optimization loading

Time: 30-45 minutes Difficulty: Intermediate Prerequisites: Basic Python, Ollama installed

🎭 Multi-Agent Orchestra

Advanced tutorial - Coordinate multiple agents to solve complex problems.

What you'll learn: - Design multi-agent workflows - Implement agent communication - Handle complex orchestration scenarios - Deploy real-world systems

Time: 30-45 minutes Difficulty: Advanced Prerequisites: First Agent Tutorial

🎯 Prerequisites

Before starting the tutorials, ensure you have:

  1. SuperOptix installed - See our Setup Guide
  2. Python 3.8+ - Latest stable version recommended
  3. Basic Python knowledge - Familiarity with functions and classes
  4. Text editor - VS Code, PyCharm, or any code editor

🛠️ What You'll Build

Tutorial 1: Genies Agent

  • A developer agent
  • Tool calling capabilities (web search, calculator, file operations)
  • RAG system integration
  • Memory and observability features

Tutorial 2: OpenAI SDK Code Reviewer

  • Code reviewer agent
  • Native OpenAI Agents SDK implementation
  • GEPA-optimized prompts (75% → 100% pass rate)
  • BDD test scenarios for validation
  • Automatic optimization loading

Tutorial 3: Multi-Agent Orchestra

  • Customer service workflow
  • Multiple specialized agents
  • Coordinated problem-solving

📚 Additional Resources

After completing the tutorials, explore:

  • Core Concepts - Deep dive into SuperOptix fundamentals
  • Guides - Techniques and integrations
  • Reference - API documentation and CLI reference

🆘 Need Help?

Ready to build your first AI agent? Start with the Quick Start 🚀