docs/main.rst

==============
Burr
==============

Welcome to Burr's documentation.

For a quick overview of Burr, watch `this walkthrough <https://www.loom.com/share/a10f163428b942fea55db1a84b1140d8?sid=1512863b-f533-4a42-a2f3-95b13deb07c9>`_
or read `our blog post <https://blog.dagworks.io/p/burr-develop-stateful-ai-applications?r=2cg5z1&utm_campaign=post&utm_medium=web>`_. The following video is
a longer demo of building a simple chatbot application with Burr using `this notebook <https://github.com/DAGWorks-Inc/burr/blob/main/examples/conversational-rag/simple_example/notebook.ipynb>`_:

.. raw:: html

   <div style="position: relative; padding-bottom: 56.25%; height: 0;"><iframe width="800" height="455" src="https://www.youtube.com/embed/rEZ4oDN0GdU?si=6RvExhQVsAyNd8Ts" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></div>

For more details about how Burr works, what problems it solves, and how to use it, read on!

You'll find this documentation separated into three sections.

- If you don't know where to start, go to :ref:`getting started <gettingstarted>`.
- If you're looking to build a mental model/read more, go to :ref:`concepts <concepts>`.
- If you're looking for a specific piece of information, go to :ref:`reference <reference>`.

We also ask that you:

- Report any bugs, issues, or feature requests via `GitHub Issues <https://github.com/DAGWorks-Inc/burr/issues>`_ or \
  `GitHub Discussions <https://github.com/DAGWorks-Inc/burr/discussions>`_.
- Give us a star on `GitHub <https://github.com/dagworks-inc/burr>`_ if you like the project!


Testimonials
============

.. raw:: html

    <link rel="stylesheet" type="text/css" href="_static/testimonials.css">
       <div class="testimonial-container">
               <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"After evaluating several other obfuscating LLM frame-works, their elegant yet comprehensive state management solution proved to be the powerful answer to rolling out robots driven by AI decision making."</p>
                <h4>Ashish Ghosh</h4>
                <span>CTO, Peanut Robotics</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"Of course, you can use it [LangChain], but whether it's really production-ready and improves the time from 'code-to-prod' [...], we've been doing LLM apps for two years, and the answer is no [...] All these 'all-in-one' libs suffer from this [...].  Honestly, take a look at Burr. Thank me later."</p>
                <h4>Reddit User</h4>
                <span>LocalLlama, Subreddit</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"Using Burr is a no-brainer if you want to build a modular AI application. It is so easy to build with and I especially love their UI which makes debugging, a piece of cake. And the always ready to help team, is the cherry on top."</p>
                <h4>Ishita</h4>
                <span>Founder, Watto.ai</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"I just came across Burr and I'm like WOW, this seems like you guys predicted this exact need when building this. No weird esoteric concepts just because it's AI."</p>
                <h4>Matthew Rideout</h4>
                <span>Staff Software Engineer, Paxton AI</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"Burr's state management part is really helpful for creating state snapshots and build debugging, replaying and even building evaluation cases around that"</p>
                <h4>Rinat Gareev</h4>
                <span>Senior Solutions Architect, Provectus</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"I have been using Burr over the past few months, and compared to many agentic LLM platforms out there (e.g. LangChain, CrewAi, AutoGen, Agency Swarm, etc), Burr provides a more robust framework for designing complex behaviors."</p>
                <h4>Hadi Nayebi</h4>
                <span>Co-founder, CognitiveGraphs</span>
            </div>
        </div>

        <div class="testimonial-card">
            <div class="testimonial-content">
                <p>"Moving from LangChain to Burr was a game-changer! <br/>Time-Saving: It took me just a few hours to get started with Burr, compared to the days and weeks I spent trying to navigate LangChain. <br/>Cleaner Implementation: With Burr, I could finally have a cleaner, more sophisticated, and stable implementation. No more wrestling with complex codebases. <br/>Team Adoption: I pitched Burr to my teammates, and we pivoted our entire codebase to it. It's been a smooth ride ever since."</p>
                <h4>Aditya K.</h4>
                <span>DS Architect, TaskHuman</span>
            </div>
        </div>
    </div>