README

Important

Dieses Paket ist umgezogen. Entwicklung und Releases laufen jetzt im Monorepo public-sector-dev-crew/lotse-fleet (Verzeichnis packages/steg-bundle). Dieses Repository ist eingefroren und wird archiviert.

• Neuer Composer-Name: lotse/steg-bundle (vormals ndrstmr/steg-bundle)
• Umstellen: composer remove ndrstmr/steg-bundle && composer require lotse/steg-bundle
• Der PHP-Namespace Steg\Bundle\ bleibt unverändert — nur die require-Zeile ändert sich.
• Packagist: https://packagist.org/packages/lotse/steg-bundle

steg-bundle

Symfony Bundle for Steg — auto-configuration, profiler panel, and DI integration.

Requirements

• PHP 8.2+
• Symfony 7.0+ or 8.0+
• ndrstmr/steg ^1.0.1 (v1.0.0 has an incompatible StegClient and is not supported)

Installation

composer require ndrstmr/steg-bundle

Symfony Flex will register the bundle automatically. Without Flex, add it manually:

// config/bundles.php
return [
    // ...
    Steg\Bundle\StegBundle::class => ['all' => true],
];

Configuration

Create config/packages/steg.yaml:

steg:
    connections:
        vllm_local:
            dsn: '%env(STEG_VLLM_DSN)%'   # e.g. vllm://gpu-server:8000/v1?model=llama-3.3-70b-awq
            timeout: 120
        ollama_dev:
            dsn: 'ollama://localhost:11434?model=qwen2.5:7b'
            timeout: 60
        mock:
            dsn: 'mock://default'
    default_connection: vllm_local

DSN format

Alternative: explicit base_url

steg:
    connections:
        vllm_local:
            base_url: '%env(VLLM_BASE_URL)%'
            model: '%env(VLLM_MODEL_NAME)%'
            api_key: '%env(VLLM_API_KEY)%'
            timeout: 120

Usage

Autowiring (default connection)

use Steg\Client\InferenceClientInterface;
use Steg\Model\ChatMessage;

final class MyService
{
    public function __construct(
        private readonly InferenceClientInterface $steg,
    ) {}

    public function translate(string $text): string
    {
        $response = $this->steg->complete([
            ChatMessage::system('You are a translation assistant.'),
            ChatMessage::user($text),
        ]);

        return $response->content;
    }
}

Named connections via #[Autowire]

use Steg\Client\InferenceClientInterface;
use Symfony\Component\DependencyInjection\Attribute\Autowire;

final class MyService
{
    public function __construct(
        #[Autowire(service: 'steg.client.vllm_local')]
        private readonly InferenceClientInterface $vllm,

        #[Autowire(service: 'steg.client.ollama_dev')]
        private readonly InferenceClientInterface $ollama,
    ) {}
}

Available service IDs

Symfony Profiler

When StegDataCollector is wired, the Symfony Profiler shows a Steg panel with:

• Request count and total duration
• Prompt and completion token usage
• Per-request timeline (connection, model, duration, tokens, response preview)

To enable profiling, decorate your client services with ProfilingClient in the DI configuration.

License

EUPL-1.2 — see LICENSE.

Built by 👾 public sector dev crew

Notice

This repository was developed with the assistance of AI code agents (Claude Code, Anthropic). The code was created as part of a development sprint and is not cleared for production use without prior review. Use at your own risk.

License: European Union Public Licence v. 1.2 (EUPL-1.2) — Copyright © 2026 Andreas Teumer