Download the PHP package boriskwemo/llm-ledger without Composer

LLM Ledger - PHP LLM Cost Tracking & Multi-Provider AI Gateway

Track, analyze and control your LLM spend from one clean PHP API - compatible with OpenAI, Anthropic, Google Gemini, Mistral, DeepSeek, Qwen, Kimi, GLM, Grok and any OpenAI-compatible endpoint. Works natively with Symfony 8 and Laravel, installs from Composer, and ships with a customizable cost dashboard, a deprecation-aware model catalog and batch processing - all under the MIT license.

Every call - tokens, reasoning tokens, latency, model, provider and dollar cost - is recorded automatically and visualized in a dashboard. No more guessing what AI actually costs you.

Table of contents

1. Why LLM Ledger?
2. Features
3. Who is it for?
4. How it compares
5. Requirements
6. Installation
7. Quickstart
8. Configuration
9. Model registry & deprecation
10. Thinking / reasoning tokens
11. Batch processing
12. API key handling
13. Symfony 8 integration
14. Laravel integration
15. CLI
16. Model coverage
17. Architecture
18. Testing
19. Contributing
20. Security
21. License

Why LLM Ledger?

Modern apps rarely use one AI provider. They use four or five - a frontier model from OpenAI, Claude for coding, Gemini for long context, DeepSeek or Qwen when cost matters, Mistral for EU data residency. That fragmentation creates three real problems:

The result: one dependency instead of five, and a complete, queryable audit trail of your AI usage and cost - for free, open-source, without locking you into a gateway or a hosted dashboard.

Features

• Unified multi-provider API - a single chat() method for OpenAI, Anthropic, Google, Mistral, DeepSeek, Qwen, xAI, Groq, Cohere and any OpenAI-compatible server (vLLM, LiteLLM, local endpoints).
• American, French & Chinese models - OpenAI · Anthropic · Google · xAI · Groq · Cohere · Meta (US), Mistral · Kyutai · LightOn (France), DeepSeek · Qwen · Kimi · GLM · Ernie · MiniMax · Doubao · Hunyuan (China).
• Automatic cost tracking - per-call token usage and USD cost, including cached-input and Anthropic cache-write pricing, aggregated by model/provider/day.
• Thinking / reasoning token visibility - captures reasoning text and token counts across providers so no token is invisible in your bill.
• Batch processing - run hundreds of prompts through OpenAI, Anthropic or Gemini batch APIs with one batch() call and track every item.
• Deprecation-aware model registry - curated, editable YAML with descriptions, context windows, pricing, modalities and a deprecated / superseded_by lifecycle.
• YAML configuration - providers, storage, defaults and UI in one llm.yaml.
• Customizable dashboard - light/dark themable UI with Twig (Symfony), Blade (Laravel) and a standalone PHP version; every template is overridable.
• Secure by default - API keys live in memory only and are never persisted or logged.
• CLI - models:list, models:show, usage:report, call.

Who is it for?

• SaaS & AI-feature teams that call multiple LLMs and need to bill customers or teams accurately.
• Symfony / Laravel shops that want a first-class, idiomatic integration - autowired service or facade - not a raw HTTP client.
• Agencies & indie developers who want to track AI spend per client or project without building infrastructure.
• Cost-conscious engineers comparing models (GPT vs Claude vs Gemini vs DeepSeek vs Qwen) on real, recorded numbers.

How it compares

Requirements

• PHP 8.2+ (Symfony 8.1 requires 8.4+, Laravel 12 requires 8.2+)
• ext-json, ext-pdo
• Composer

Installation

Quickstart (plain PHP)

Structured conversation & multimodal content

Configuration (llm.yaml)

Every provider's base_url and protocol default come from the bundled registry; api_key is the only thing you normally add.

Model registry & deprecation

The catalog lives in config/models.yaml - a readable, editable snapshot you can copy and point at with models_file. Each entry carries a description and lifecycle metadata:

Inspect it programmatically:

Pricing is a bundled snapshot. Providers change prices often - treat it as a starting point and override in your own YAML (or via models_file).

Tracking thinking / reasoning tokens

Every result exposes the full picture, normalized across providers:

Where each number comes from (verified against vendor specs):

All of this is persisted (tokens, reasoning text, response text, finish reason, tool calls) - set tracking.store_content: false to keep only the token/cost numbers.

Batch processing

Supported backends:

• OpenAI (and providers mirroring /v1/batches): file upload → batch → poll → JSONL results.
• Anthropic: /v1/messages/batches → poll → results.
• Google Gemini: :batchGenerateContent (synchronous, returns all responses in one call).

Each successful item is recorded to the tracker with its custom_id. Use $llm->pollBatch($provider, $id) to resume polling a job without recreating it.

API key handling

Keys are never persisted, never logged, and never stored in the tracking database:

• Keys are read once from config (api_key: env(VAR), %env(VAR)% in Symfony, env() in Laravel) and held in memory only for the lifetime of the request.
• Only the Authorization / x-api-key / x-goog-api-key header carries the key; error messages and stored records contain provider responses, never your key.
• Keep keys out of version control via .env (gitignored). For Laravel, note that php artisan config:cache bakes env() values into bootstrap/cache/config.php - exclude that cache from your repo and rotate keys if it leaks. For production secrets, wire a secret manager by resolving the value in your own config before passing it to the provider map.

Symfony 8 integration

1. Register the bundle in config/bundles.php:

2. Configure it (config/packages/llm_cost_tracker.yaml):

3. Import the routes (config/routes/llm_cost_tracker.yaml):

4. Use the autowired service:

Open /llm for the dashboard and /llm/models for the model catalog. To customize the UI, copy Resources/views into templates/bundles/LlmCostTrackerBundle/ and edit - Twig resolution gives your templates priority.

Laravel integration

The package auto-registers via Composer (extra.laravel.providers). Publish config, migration and views:

Configure in .env:

Use the facade:

The dashboard is served at /llm (configurable via llm-cost-tracker.dashboard.route_prefix). Views are published to resources/views/vendor/llm-cost-tracker for customization.

CLI

Standalone dashboard

examples/dashboard.php renders a self-contained HTML dashboard with zero framework dependencies - useful as a reference or for a quick internal tool.

Model coverage

The bundled registry (compiled from vendor documentation, June-Aug 2026) covers, among others:

Sources used for the snapshot: LLM API pricing comparison, Mistral API pricing, Chinese LLM price war 2026, OpenAI API pricing, Claude API pricing, Gemini API pricing, xAI Grok pricing, Qwen API pricing, DeepSeek API pricing, and GLM-5.2 vs Kimi K3.

Architecture

Token counts come from each provider's usage field (authoritative). When a provider omits usage, a ~4 chars/token heuristic fills the gap so tracking never silently drops a call.

Testing

Contributing

Contributions are welcome - code, docs, tests, or model/pricing updates. See CONTRIBUTING.md for setup, coding standards, and the pull-request process.

Security

To report a vulnerability privately (not in a public issue), see SECURITY.md. Your API keys are never persisted or logged; read the file for key-handling best practices.

License

MIT - free to use, modify and ship in commercial projects. See LICENSE.