PHPackages                             cognesy/instructor-dynamic - 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-dynamic

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

cognesy/instructor-dynamic
==========================

Lightweight dynamic structure record and schema builder for Instructor

v2.3.1(1mo ago)052MITPHPPHP ^8.3

Since Jul 16Pushed 1mo agoCompare

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

READMEChangelog (10)Dependencies (15)Versions (41)Used By (2)

Instructor Dynamic
==================

[](#instructor-dynamic)

Lightweight runtime structures for schema-driven inputs and outputs.

```
use Cognesy\Dynamic\Structure;
use Cognesy\Schema\SchemaBuilder;

$schema = SchemaBuilder::define('search_args')
    ->string('query')
    ->int('limit', required: false)
    ->schema();

$args = Structure::fromSchema($schema, ['query' => 'laravel']);

$updated = $args->set('limit', 10);

$updated->validate()->isValid(); // true
$updated->toArray();             // ['query' => 'laravel', 'limit' => 10]
```

Use this package when you need:

- a small immutable runtime record (`Structure`)
- schema-driven structures from callables/classes (`StructureFactory`)

Schema authoring lives in `Cognesy\Schema` (`SchemaBuilder`, `SchemaFactory`, `CallableSchemaFactory`).

See [CHEATSHEET.md](CHEATSHEET.md) for API details.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance90

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity63

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 ~6 days

Total

40

Last Release

50d ago

Major Versions

v1.22.0 → v2.0.02026-03-12

PHP version history (2 changes)v1.0.0-RC22PHP ^8.2

v1.19.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/d11593cece5bb65ba5eea704a91e1dda72362e86f8fe0e99295f291ba7628cac?d=identicon)[ddebowczyk](/maintainers/ddebowczyk)

---

Top Contributors

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

###  Code Quality

TestsPest

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[symfony/ai-platform

PHP library for interacting with AI platform provider.

51927.7k136](/packages/symfony-ai-platform)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)[symfony/ai-agent

PHP library for building agentic applications.

30536.7k44](/packages/symfony-ai-agent)[api-platform/metadata

API Resource-oriented metadata attributes and factories

243.5M96](/packages/api-platform-metadata)[api-platform/hydra

API Hydra support

223.3M8](/packages/api-platform-hydra)[api-platform/validator

API Platform validator component

223.2M10](/packages/api-platform-validator)

PHPackages © 2026

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