PHPackages                             cognesy/instructor-config - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. cognesy/instructor-config

ActiveLibrary[Utility & Helpers](/categories/utility)

cognesy/instructor-config
=========================

Lean config loading utilities for Instructor

v2.3.1(3mo ago)08810MITPHPPHP ^8.3

Since Jun 17Pushed 3mo agoCompare

[ Source](https://github.com/cognesy/instructor-config)[ Packagist](https://packagist.org/packages/cognesy/instructor-config)[ Docs](https://instructorphp.com)[ RSS](/packages/cognesy-instructor-config/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (13)Versions (59)Used By (10)

instructor-config (lean)
========================

[](#instructor-config-lean)

Minimal configuration infrastructure for Instructor.

Scope:

- load YAML or PHP config files as raw arrays,
- resolve relative config file names against multiple base paths,
- derive deterministic dot-keys from file paths,
- optional YAML/PHP parse cache compiled to PHP,
- parse DSN strings into raw arrays,
- no presets, no provider chains, no global settings.

Usage:

```
use Cognesy\Config\Config;
use Cognesy\Config\ConfigLoader;

$single = Config::fromPaths(
    __DIR__ . '/packages/polyglot/resources/config',
    __DIR__ . '/packages/http-client/resources/config',
)->load('llm/presets/openai.yaml')->toArray();

$configs = ConfigLoader::fromPaths(
    __DIR__ . '/packages/polyglot/resources/config',
    __DIR__ . '/packages/http-client/resources/config',
)->withCache(__DIR__ . '/var/cache/instructor-config.php');

$one = $configs->load('llm/presets/openai.yaml')->toArray();
$many = $configs->loadAll(
    'llm/presets/openai.yaml',
    'http/profiles/curl.yaml',
);
```

DSN parsing:

```
use Cognesy\Config\Dsn;

$raw = Dsn::fromString('driver=openai,metadata.region=us-east-1')->toArray();
```

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance81

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

58

Last Release

111d ago

Major Versions

v1.22.0 → v2.0.02026-03-13

PHP version history (2 changes)1.0-rc3PHP ^8.2

v1.19.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/184133?v=4)[Dariusz Debowczyk](/maintainers/ddebowczyk)[@ddebowczyk](https://github.com/ddebowczyk)

---

Top Contributors

[![ddebowczyk](https://avatars.githubusercontent.com/u/184133?v=4)](https://github.com/ddebowczyk "ddebowczyk (90 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cognesy-instructor-config/health.svg)

```
[![Health](https://phpackages.com/badges/cognesy-instructor-config/health.svg)](https://phpackages.com/packages/cognesy-instructor-config)
```

###  Alternatives

[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1616.4k13](/packages/2lenet-crudit-bundle)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[aeliot/todo-registrar

Register TODOs from source code in issue tracker

153.0k](/packages/aeliot-todo-registrar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)