Built something? We create video reels & spotlights for GitHub projects.Promote your project →
cognesy
Home / PHP / instructor-php

cognesy/instructor-php

Unified LLM API, structured data outputs with LLMs, and agent SDK - in PHP

PHP ◇ agents MIT
★327STARS
⑂27FORKS
!2ISSUES
🏆#4,298GLOBAL RANK
🔥3DAYS TRENDING
🚀
Maintainer Growth Kit for instructor-php

Claim this project, add your verified backlink badge to your README, and download milestone cards.

Claim Repo

Star History

Continuous Observations
Interactive star growth chart for cognesy/instructor-php
CSV

Momentum

+10

STARS · LAST 30 DAYS

1

PER DAY

#321

MOST-STARRED PHP

Window7 days30 days90 days
Stars gained+7+10+90
Per day111
Forks gained+1+3+10

instructor-php gained 10 stars in the last 30 days, about 1 a day, and now has 327. It is about 3 years old and has averaged roughly 109 stars a year. It ranks #321 among PHP repositories and #4,298 across all languages on GitHubRepo.

Trending Record

instructor-php has maintained a continuous presence across global trending indexes, peaking at #3138. Below is the 30-day activity profile:

💡 Overview

instructor-php is an open-source project written in PHP: Unified LLM API, structured data outputs with LLMs, and agent SDK - in PHP.

Engineered for speed, consistency, and developer ease, it solves common hurdles in agents, ai, ai-agents. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.

⚡ Key Features

1

Optimized execution pipeline written in PHP for predictable speed.

2

Zero-friction configuration with comprehensive sensible defaults out of the box.

3

Cross-platform runtime support across Linux, macOS, and Windows environments.

4

Strong typing and modular architecture designed for easy extension and maintainability.

5

Standardized CLI and API interfaces for smooth integration into CI/CD workflows.

6

Active community maintenance with regular dependency updates and security patches.

📥 Installation

terminal
$ git clone https://github.com/cognesy/instructor-php.git
cd instructor-php

⚙ System Requirements

Platforms

  • • macOS
  • • Linux
  • • Windows

Runtime & Dependencies

PHP >= 8.2 with Composer

Architecture

x86_64, ARM64 (Apple Silicon & Graviton)

🧠 How It Works

instructor-php coordinates its core functionality through a modular PHP pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.

🎯 Production Use Cases

Autonomous AI Agents

Orchestrate intelligent workflows and tool-calling routines with instructor-php.

Model Inference & Prompting

Integrate fast, local or cloud-hosted generative AI models directly into production code.

Context Memory & RAG

Augment language models with dynamic vector retrieval and structured project memory.

Developer Productivity

Automate repetitive engineering tasks, code generation, and test creation using AI agents.

🚀 Getting Started

1

Install instructor-php using your package manager: `git clone https://github.com/cognesy/instructor-php.git`

2

Initialize your project workspace or configuration file for instructor-php.

3

Import instructor-php into your codebase or invoke it directly from your terminal.

4

Execute your test suite or run `instructor-php --help` to verify successful setup.

👍 Strengths

Active community backing with 327 GitHub stars and verified adoption.
Permissive open-source distribution under the MIT license.
Built in PHP for high execution speed and developer familiarity.
Cross-platform compatibility across modern Linux, macOS, and Windows environments.
Clean modular design allowing flexible configuration and pipeline integration.

⚠️ Considerations

Requires familiarity with PHP and modern CLI workflows.
Ecosystem extensions may require manual configuration depending on environment constraints.
Active development roadmap means breaking API changes may occur across major versions.

⇄ Alternatives & Direct Competitors

S
danielmiessler/SecLists ★ 73.8K PHP

SecLists is the security tester's companion. It's a collection of multiple types of lists used during security assessments, collected in one place. List types include usernames, passwords, URLs, sensitive data patterns, fuzzing payloads, web shells, and many more.

Compare ↗
C
coollabsio/coolify ★ 62.3K PHP

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 280+ one-click services on your own servers.

Compare ↗
A
appwrite/appwrite ★ 57.5K PHP

Appwrite® - complete cloud infrastructure for your web, mobile and AI apps. Including Auth, Databases, Storage, Functions, Messaging, Hosting, Realtime and more

Compare ↗
S
nextcloud/server ★ 36.9K PHP

☁️ Nextcloud server, a safe home for all your data

Compare ↗

👥 Who Should Use This

Developers and engineering teams building with PHP, seeking reliable, tested, and actively maintained tooling for production workloads.

🏆 Nearby in the Rankings

cognesy/instructor-php is currently ranked #4,298 by stars across every repository tracked on GitHubRepo. These are adjacent projects:

RankRepositoryLanguageStarsAction
#4,291 Astn/JSON-RPC.NET C# ★ 328 Compare ↗
#4,291 iyzico/iyzipay-php PHP ★ 328 Compare ↗
#4,291 paritytech/smoldot Rust ★ 328 Compare ↗
#4,291 Tantalor93/dnspyre Go ★ 328 Compare ↗
#4,291 itsmostafa/system-one-connector Go ★ 328 Compare ↗
#4,298 cognesy/instructor-php This Project PHP ★ 327
#4,298 maccman/acts_as_recommendable Ruby ★ 327 Compare ↗
#4,298 GNOME/gnome-terminal C++ ★ 327 Compare ↗
#4,298 hairyhenderson/go-fsimpl Go ★ 327 Compare ↗
#4,298 MxIris-Reverse-Engineering/MachOSwiftSection Swift ★ 327 Compare ↗
#4,303 Trepan-Debuggers/zshdb Shell ★ 326 Compare ↗

Frequently Asked Questions

What does instructor-php do? +

Unified LLM API, structured data outputs with LLMs, and agent SDK - in PHP

What language is instructor-php written in? +

The primary language is PHP. Topics include: agents, ai, ai-agents, genai, llm.

Is instructor-php actively maintained? +

Yes, the last recorded push was on Sep 25, 2026 with 2 open issues being tracked.

How many stars does instructor-php have? +

instructor-php has 327 stars and 27 forks on GitHub.

How does instructor-php rank among GitHub repositories? +

With 327 stars, cognesy/instructor-php is ranked #4,298 globally across all repositories tracked on GitHubRepo and #321 among PHP projects.

What license is instructor-php distributed under? +

The repository reports a MIT license. Always verify the repository LICENSE file for legal terms.

From our network
FOR MAINTAINERS

Built something? Put it in front of millions of developers.

We make a short reel about your project and post it across YouTube, Instagram, Threads, and X. Send a link, we do the rest.