madj2k / ai-core
Framework-independent AI, vector store and indexing core shared by Madj2k integrations.
Requires
- php: ^8.2
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.8
- hkulekci/qdrant: ^1.0
- openai-php/client: ^0.10
- psr/http-message: ^1.1 || ^2.0
- psr/log: ^3.0
Requires (Dev)
- phpunit/phpunit: ^10.5 || ^11.0 || ^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-09-25 15:43:52 UTC
README
madj2k/ai-core contains the framework-independent runtime and shared building blocks for Madj2k
AI integrations:
- assistant context, memory and pipeline execution;
- provider-neutral AI and vector-store contracts;
- tool-calling contracts and bounded tool execution;
- indexing, adapters, chunking and source identities;
- resilience, connection health and normalized DTOs.
The package has no TYPO3 or Symfony container dependency. Host applications provide configuration
objects and compose connectors, providers and resolvers through constructor injection. TYPO3
persistence, TCA, controllers, backend modules and HTTP integration belong to
madj2k/t3-ai-assistant. MCP protocol support belongs to madj2k/ai-mcp.
Requirements
- PHP 8.2 or newer
- JSON and mbstring extensions
Installation
composer require madj2k/ai-core
Public API
Integrations should depend on public interfaces, DTOs, configuration contracts and facades. Custom pipeline processors, prompt context builders, AI connectors, vector-store connectors, tool providers, indexers and adapters are registered through their corresponding contracts.
Classes marked with @internal are bundled implementations or provider-specific helpers. They may
change without backward-compatibility guarantees.
Tests
composer install
composer test
The test suite is framework-independent and does not bootstrap TYPO3.
See Documentation for architecture, pipeline, tool-calling and extension-point details.
License
GNU General Public License version 3. See LICENSE.