Skip to content

docs(examples): add Langfuse (OpenTelemetry) integration example#339

Merged
cyfyifanchen merged 1 commit into
mainfrom
feat/langfuse-example
Jul 13, 2026
Merged

docs(examples): add Langfuse (OpenTelemetry) integration example#339
cyfyifanchen merged 1 commit into
mainfrom
feat/langfuse-example

Conversation

@dani1005

Copy link
Copy Markdown
Collaborator

Adds examples/langfuse/ — a thin OpenTelemetry wrapper that traces EverOS memory operations (add / flush+extract / search / reflection) into Langfuse, with recall quality pushed as Langfuse scores.

  • Pure OTel SDK, no Langfuse package dependency; works with any OTLP backend.
  • Runs with no server via a built-in mock, or against a real EverOS server (EVEROS_BASE_URL). Verified end-to-end (traces + scores render in Langfuse).
  • Additive only, no changes to EverOS core.
  • Referenced by the upcoming Langfuse docs integration cookbook.

Native, opt-in instrumentation in core is a planned follow-up.

Adds examples/langfuse/ — a thin OpenTelemetry wrapper that traces EverOS
memory operations (add / flush+extract / search / reflection) into Langfuse,
with recall quality pushed as Langfuse scores. Pure OTel SDK, no Langfuse
package dependency; runs against a built-in mock or a real EverOS server
(EVEROS_BASE_URL). Additive only, no changes to EverOS core.

Referenced by the upcoming Langfuse docs integration cookbook.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dani1005 dani1005 changed the title examples: add Langfuse (OpenTelemetry) integration example docs(examples): add Langfuse (OpenTelemetry) integration example Jul 13, 2026
@dani1005 dani1005 force-pushed the feat/langfuse-example branch from 5f4b724 to 0ecf8e0 Compare July 13, 2026 22:39
@dani1005

Copy link
Copy Markdown
Collaborator Author

Heads-up for reviewers on structure:

This introduces a new top-level examples/ directory (it didn't exist before). The intent is for it to be the home for runnable integration / usage examples, one per subfolder — this PR adds examples/langfuse/, and future ones would sit alongside (e.g. examples/<integration>/).

Why examples/ rather than alternatives:

  • It's runnable sample code users copy/adapt, not a shipped module — so examples/ fits better than integrations/ (which implies a first-party, packaged integration).
  • It's code + a runnable demo, so examples/ reads more naturally than nesting under docs/.

This is additive only — no changes to existing code or core. Native, opt-in instrumentation inside core is a planned follow-up.

If you'd prefer a different home for this (e.g. docs/integrations/ or integrations/), happy to rename before merge — just let me know.

@cyfyifanchen cyfyifanchen merged commit a1e21ca into main Jul 13, 2026
9 checks passed
@cyfyifanchen cyfyifanchen deleted the feat/langfuse-example branch July 13, 2026 23:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants