Download the PHP package dayemsiddiqui/langfuse-sdk without Composer

Laravel Langfuse SDK

A simple Laravel package for working with Langfuse prompts. Fetch, compile, and test AI prompts with ease.

🚀 Quick Start

1. Install:

2. Add your API keys to `.env:

3. Use in your code:

✨ Features

• Fetch prompts from Langfuse by name
• Compile prompts with variables (e.g. {{name}})
• Detailed error messages for missing variables
• Elegant testing with LangfuseFake::fake() (see below)

🧑‍💻 Usage

Get a Prompt

Compile a Prompt

Handle Missing Variables

If you try to compile a prompt and dont provide all the required variables in a prompt you will get a MissingPromptVariablesException

🧪 Testing (Just like Queue::fake())

Testing your code is easy and elegant!

1. Fake Langfuse in your tests

2. Make assertions

3. Chainable API

4. Use the trait for auto-setup

📚 API Reference (Short)

• getPrompt($name) → returns a PromptBuilder
• PromptBuilder->raw() → get raw prompt
• PromptBuilder->compile($vars) → compile with variables
• LangfuseFake::fake([...]) → fake prompts in tests
• LangfuseFake::getFake()->assertPromptRequested($name) → assert prompt was used

📝 Advanced

• Dependency Injection: Works with Laravel's container, so you can type-hint Langfuse in your services.
• Custom Exception: Get missing variables, provided variables, prompt name/content from the exception.
• Supports both {{name}} and {{ name }} syntax.

🛠️ Development

• Run tests: composer run test
• Format code: composer format
• Static analysis: composer analyse

🤝 Contributing & License

• PRs welcome! See CONTRIBUTING.
• MIT License. See LICENSE.md.

🙏 Credits

• Dayem Siddiqui
• All Contributors