Tutorials
=========

.. note::
   **Learning-oriented documentation**
   
   These tutorials are designed to help you learn by doing. They take you through a series of steps to complete a meaningful project, helping you understand how the HoneyHive SDK works in practice.

Welcome to the HoneyHive Python SDK tutorials! If you're new to HoneyHive or LLM observability, start here.

**What you'll learn:**

- How to set up and configure the HoneyHive SDK
- How to trace your first LLM application
- How to integrate with popular LLM providers
- How to enrich traces with metrics, feedback, and metadata
- How to run experiments and evaluate your LLM outputs
- **How to implement distributed tracing across microservices**

**Prerequisites:**

- Python 3.11 or higher
- Basic familiarity with Python programming
- A HoneyHive account (sign up at `honeyhive.ai <https://honeyhive.ai>`_)

Getting Started Path
--------------------

Follow these tutorials in order for the best learning experience:

.. toctree::
   :maxdepth: 1
   :numbered:

   01-setup-first-tracer
   02-add-llm-tracing-5min
   03-enable-span-enrichment
   04-configure-multi-instance
   05-run-first-experiment
   06-distributed-tracing

Additional Learning
-------------------

Once you've completed the core tutorials, explore these additional topics:

.. toctree::
   :maxdepth: 1

   advanced-configuration

**Next Steps**

After completing these tutorials:

- Check out :doc:`../how-to/index` for solving specific problems
- Explore :doc:`../reference/index` for detailed API documentation
- Read :doc:`../explanation/index` to understand concepts and design decisions

**Need Help?**

- Join our `Discord community <https://discord.gg/honeyhive>`_
- Check the :doc:`../how-to/index` guide (Troubleshooting section)
- Email support@honeyhive.ai