PHPackages                             nvoos/core - 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. [Framework](/categories/framework)
4. /
5. nvoos/core

ActiveLibrary[Framework](/categories/framework)

nvoos/core
==========

Framework-agnostic AI orchestration engine — agentic loop, tool registry, provider routing, SSE streaming.

029PHP

Since Jun 5Pushed 1w agoCompare

[ Source](https://github.com/nvdigitalsolutions/nvoos-core)[ Packagist](https://packagist.org/packages/nvoos/core)[ RSS](/packages/nvoos-core/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (2)Used By (0)

nvoos/core
==========

[](#nvooscore)

Framework-agnostic AI orchestration engine — agentic loop, tool registry, provider routing, SSE streaming.

Installation
------------

[](#installation)

```
composer require nvoos/core
```

Requires PHP 8.1+.

What's Inside
-------------

[](#whats-inside)

- **Domain layer** — 9 contracts (ports), 10 immutable entities, 5 typed exceptions, 8 PSR-14 domain events
- **Application layer** — `ChatOrchestrator` (agentic loop), `ProviderRouter` (12-provider routing), `ToolRegistry`, `SkillRegistry`
- **Infrastructure layer** — 12 AI provider clients (OpenAI, Gemini, Anthropic, Ollama, DeepSeek, etc.), SSE streaming handler, cost calculator
- **Tools** — 43 framework-agnostic tool classes (content, cache, files, settings, jobs, etc.)

Architecture
------------

[](#architecture)

This package uses **Hexagonal Architecture (Ports & Adapters)**. The core engine defines interfaces (ports) that platform-specific adapters implement:

AdapterPackageWordPress`nvoos/wordpress-adapter`Laravel`nvoos/laravel-adapter`Craft CMS`nvoos/craft-adapter`Usage
-----

[](#usage)

```
use Nvoos\Core\Application\Chat\ChatOrchestrator;
use Nvoos\Core\Application\Provider\ProviderRouter;
use Nvoos\Core\Application\Tool\ToolRegistry;

// Wire up adapters (WordPress example)
$toolRegistry = new ToolRegistry($errorFactory, $eventDispatcher);
$providerRouter = new ProviderRouter($settingsStore, $httpClient, $requestFactory);
$orchestrator = new ChatOrchestrator(
    $toolRegistry,
    $providerRouter,
    $eventDispatcher,
    $errorFactory,
);

// Run a chat
$response = $orchestrator->handleChat($messages, $options);
```

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

23

—

LowBetter than 25% of packages

Maintenance64

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c615f1f9599eec7b223b63804f7bc3146f94340b37db80ab0c9ef20879f4696?d=identicon)[nvdigital](/maintainers/nvdigital)

---

Top Contributors

[![nvdigitalsolutions](https://avatars.githubusercontent.com/u/85486977?v=4)](https://github.com/nvdigitalsolutions "nvdigitalsolutions (39 commits)")

### Embed Badge

![Health badge](/badges/nvoos-core/health.svg)

```
[![Health](https://phpackages.com/badges/nvoos-core/health.svg)](https://phpackages.com/packages/nvoos-core)
```

###  Alternatives

[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[alizharb/laravel-modular

A professional, framework-agnostic modular architecture for Laravel 11+. Features zero-config autoloading, 29+ Artisan command overrides, and seamless Vite integration.

211.6k9](/packages/alizharb-laravel-modular)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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