Skip to content

Add Langfuse Cloud support#5

Merged
doneyli merged 1 commit intomainfrom
feature/langfuse-cloud-support
Feb 22, 2026
Merged

Add Langfuse Cloud support#5
doneyli merged 1 commit intomainfrom
feature/langfuse-cloud-support

Conversation

@doneyli
Copy link
Owner

@doneyli doneyli commented Feb 10, 2026

Summary

  • Add --cloud flag to install-hook.sh for interactive Langfuse Cloud setup (API key prompts, region selection EU/US/custom, key format validation)
  • Add --cloud flag to validate-setup.sh to skip Docker/port/openssl checks and verify cloud API health instead
  • Add settings-examples/cloud-settings.json as a cloud configuration reference
  • Restructure README with a comparison table and split quick start into Cloud (Option A) and Self-Hosted (Option B) paths, plus cloud-specific troubleshooting

Existing self-hosted flow is completely unchanged when --cloud flag is absent.

Test plan

  • Self-hosted flow still works: run full existing flow without --cloud — behavior should be identical
  • Cloud install: run ./scripts/install-hook.sh --cloud with test credentials, verify ~/.claude/settings.json has correct values
  • Key validation: confirm install rejects keys not starting with pk-lf- / sk-lf-
  • Cloud validate: run ./scripts/validate-setup.sh --cloud --post against a real Langfuse Cloud instance
  • Existing tests pass: python3 -m pytest tests/test_hook_unit.py (no hook changes)
  • Syntax validation: bash -n scripts/install-hook.sh && bash -n scripts/validate-setup.sh

🤖 Generated with Claude Code

Enable users with Langfuse Cloud accounts to use this template without
Docker by adding a --cloud flag to install and validation scripts.

- install-hook.sh --cloud: interactive prompts for API keys and region
  (EU/US/custom) with key format validation (pk-lf-*/sk-lf-*)
- validate-setup.sh --cloud: skips Docker/port/openssl checks, adds
  cloud API health check reading LANGFUSE_HOST from settings.json
- New settings-examples/cloud-settings.json for reference
- README: split quick start into Cloud (Option A) and Self-Hosted
  (Option B) paths with comparison table and cloud troubleshooting

Existing self-hosted flow is completely unchanged when flags are absent.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@doneyli doneyli merged commit 916656a into main Feb 22, 2026
1 check passed
@doneyli doneyli deleted the feature/langfuse-cloud-support branch February 22, 2026 23:56
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.

1 participant