Ecosystem page for Apache Burr by harishkesavarao · Pull Request #661 · apache/burr

harishkesavarao · 2026-02-16T04:55:27Z

[Short description explaining the high-level reason for the pull request]

Changes

Adds an ecosystem page for Apache Burr showcasing integrations, examples, and resources to help build better applications with Burr.

How I tested this

Built documentation locally:

Installing all project dependencies (pip install -e ".[docs]")
Running make html in the docs/ directory
Verifying the rendered HTML output

Pre-commit hooks:

Notes

Checklist

PR has an informative and human-readable title (this will be pulled into the release notes)
Changes are limited to a single goal (no scope creep)
Code passed the pre-commit check & code is left cleaner/nicer than when first encountered.
Any change in functionality is tested
New functions are documented (with a description, list of inputs, and expected output)
Placeholder code is flagged / future TODOs are captured in comments
Project documentation has been updated if adding/changing functionality.

harishkesavarao · 2026-02-16T04:56:20Z

Implements item 2 mentioned in #589 (comment)

skrawcz · 2026-02-21T19:19:02Z

docs/ecosystem.rst

+     - `OpenAI Examples <https://github.com/apache/burr/tree/main/examples/openai-compatible-agent>`_
+   * - **LlamaIndex**
+     - Connect your custom data to LLMs.
+     - `LlamaIndex Integration <https://github.com/apache/burr/tree/main/examples/resource_management>`_


this doesn't exist

Sorry about that, now fixed.

skrawcz · 2026-02-21T19:19:32Z

docs/ecosystem.rst

+   * - **OpenAI**
+     - Build agents using OpenAI's powerful models.
+     - `OpenAI Examples <https://github.com/apache/burr/tree/main/examples/openai-compatible-agent>`_
+   * - **LlamaIndex**
+     - Connect your custom data to LLMs.
+     - `LlamaIndex Integration <https://github.com/apache/burr/tree/main/examples/resource_management>`_
+   * - **Haystack**
+     - Build end-to-end NLP pipelines.
+     - `Haystack Integration <https://github.com/apache/burr/tree/main/examples/haystack-integration>`_
+   * - **Instructor**
+     - Structured outputs for LLMs.
+     - `Instructor Examples <https://github.com/apache/burr/tree/main/examples/instructor-gemini-flash>`_
+   * - **Google Gemini**
+     - specific examples using Google's Gemini models.
+     - `Gemini Examples <https://github.com/apache/burr/tree/main/examples/instructor-gemini-flash>`_


can you please QA these and check that the examples actually match the descriptions.

Sorry about the errors, I have fixed them and have also checked the example URLs' content and the descriptions.

skrawcz · 2026-02-21T19:19:56Z

docs/ecosystem.rst

+     - specific examples using Google's Gemini models.
+     - `Gemini Examples <https://github.com/apache/burr/tree/main/examples/instructor-gemini-flash>`_
+
+Orchestration & Data


I think there might be haystack examples?

Yes, added.

skrawcz · 2026-02-21T19:21:03Z

reference_ecosystem.html

@@ -0,0 +1,1072 @@
+<!doctype html>


what's the purpose of this?

It is not required, removed it.

skrawcz

see comments and address them please.

andreahlert · 2026-03-12T08:15:15Z

Nice addition. Just flagging that some links in the docs still point to burr.dagworks.io and dagworks-inc/burr (tracked in #589, PR #659 addresses part of it). Might be worth making sure any URLs in this new ecosystem page use the apache/burr references.

harishkesavarao · 2026-03-15T15:43:03Z

Nice addition. Just flagging that some links in the docs still point to burr.dagworks.io and dagworks-inc/burr (tracked in #589, PR #659 addresses part of it). Might be worth making sure any URLs in this new ecosystem page use the apache/burr references.

Noted, will make changes accordingly.

…message to explain why this merge is necessary, # especially if it merges an updated upstream into a topic branch. # # Lines starting with '#' will be ignored, and an empty message aborts # the commit.

harishkesavarao · 2026-03-21T16:23:43Z

see comments and address them please.

@skrawcz thank you for the review, I have made changes. Can you please review the PR once more?

skrawcz

this needs to be referenced in an index for it to be displayed. can you build the docs locally and show it being surfaced please?

skrawcz · 2026-03-26T19:13:16Z

and also run the pre-commit hooks please

skrawcz · 2026-03-26T19:16:54Z

/home/runner/work/burr/burr/docs/ecosystem.rst: WARNING: document isn't included in any toctree [toc.not_included]

is the error -- so you need to include it in an index

harishkesavarao · 2026-04-02T18:41:33Z

and also run the pre-commit hooks please

Added a screenshot showing successful pre-commit hook runs locally.

harishkesavarao · 2026-04-02T18:52:18Z

/home/runner/work/burr/burr/docs/ecosystem.rst: WARNING: document isn't included in any toctree [toc.not_included]

is the error -- so you need to include it in an index

Added and the local build succeeded with 1 warning which is unrelated to this scenario. The warning about the document not being included in the toctree is no longer present.

WARNING: autodoc: failed to import class 'ray.RayExecutor' from module 'burr.integrations'; the following exception was raised

copying static files: done
copying extra files... 
copying extra files: done
copying assets: done
writing output... [100%] reference/visibility
generating indices... genindex py-modindex done
writing additional pages... search done
copying images... [ 55%] _build/jupyter_execute/7baf196d9ea191cc9f552705148b505c95bc44bd8d20762b4408
copying images... [ 59%] _build/jupyter_execute/961ccf2d21bb45ddc5a735b657550ebf380b508173891513db90
copying images... [ 82%] _build/jupyter_execute/f52a61a867091a818e1acc164177df0b8e6967c73e2babf6f81b
copying images... [ 86%] _build/jupyter_execute/a749e8885585ee2b150f28fa622ef6efde3ceab91bbee2248dce
copying images... [ 91%] _build/jupyter_execute/381ba5fd7b53f739dbd688ee9bdd9b240d6bbac4293e45be4129
copying images... [100%] _static/burr_video_thumbnail.jpg
dumping search index in English (code: en)... done
dumping object inventory... done
sphinx-sitemap: sitemap.xml was generated for URL https://burr.staged.apache.org/docs/ in /home/hkpm/git_repos/burr/docs/_build/html/sitemap.xml
build succeeded, 1 warning.

The HTML pages are in _build/html.

harishkesavarao · 2026-04-02T18:54:09Z

this needs to be referenced in an index for it to be displayed. can you build the docs locally and show it being surfaced please?

Added the reference and built the docs locally (added screenshots to the description for the build and the ecosystem page being surfaced locally)

harishkesavarao · 2026-04-05T04:49:05Z

@skrawcz when you get a moment, can you please review the PR again?

skrawcz

thanks!

Ecosystem page for Apache Burr

eb027e8

skrawcz reviewed Feb 21, 2026

View reviewed changes

skrawcz requested changes Feb 21, 2026

View reviewed changes

harishkesavarao added 4 commits March 18, 2026 18:30

Removed broken links, this is a work in progress

69e9e08

more integrations, examples, docs

a308db0

Merge branch 'main' into docs/ecosystem-page # Please enter a commit …

c3b18bf

…message to explain why this merge is necessary, # especially if it merges an updated upstream into a topic branch. # # Lines starting with '#' will be ignored, and an empty message aborts # the commit.

remove extra file

001c24d

harishkesavarao requested a review from skrawcz March 21, 2026 16:23

skrawcz reviewed Mar 26, 2026

View reviewed changes

andreahlert added kind/documentation Docs, examples, notebooks area/website burr.apache.org website labels Mar 30, 2026

add ecosystem to the index

ab4b21d

harishkesavarao requested a review from skrawcz April 2, 2026 18:54

skrawcz approved these changes Apr 5, 2026

View reviewed changes

skrawcz merged commit 8571806 into apache:main Apr 5, 2026
11 checks passed

andreahlert mentioned this pull request Apr 9, 2026

Remove all references for 3rd-parties from "apache" PMC sites #589

Closed

Conversation

harishkesavarao commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

How I tested this

Notes

Checklist

Uh oh!

harishkesavarao commented Feb 16, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

skrawcz left a comment

Choose a reason for hiding this comment

Uh oh!

andreahlert commented Mar 12, 2026

Uh oh!

harishkesavarao commented Mar 15, 2026

Uh oh!

harishkesavarao commented Mar 21, 2026

Uh oh!

skrawcz left a comment

Choose a reason for hiding this comment

Uh oh!

skrawcz commented Mar 26, 2026

Uh oh!

skrawcz commented Mar 26, 2026

Uh oh!

harishkesavarao commented Apr 2, 2026

Uh oh!

harishkesavarao commented Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

harishkesavarao commented Apr 2, 2026

Uh oh!

harishkesavarao commented Apr 5, 2026

Uh oh!

skrawcz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

harishkesavarao commented Feb 16, 2026 •

edited

Loading

harishkesavarao commented Apr 2, 2026 •

edited

Loading