spora-ai/spora-core

A portable, zero-configuration AI agent orchestration platform that runs on any shared host (cPanel/FTP) without system dependencies beyond PHP 8.4+.

v0.14.2 2026-08-05 10:00 UTC

Requires

• php: ^8.4.1
• ext-curl: *
• ext-dom: *
• ext-fileinfo: *
• ext-iconv: *
• ext-json: *
• ext-mbstring: *
• ext-openssl: *
• ext-pdo: *
• ext-pdo_mysql: *
• ext-pdo_sqlite: *
• ext-simplexml: *
• ext-sodium: *
• ext-zip: *
• chriskonnertz/string-calc: ^2.0
• delight-im/auth: ^9.0
• dragonmantank/cron-expression: ^3.6
• iamgerwin/php-pdf-to-markdown-parser: ^0.0
• illuminate/database: ^13.0
• illuminate/filesystem: ^13.0
• illuminate/pagination: ^13.0
• league/html-to-markdown: ^5.1
• monolog/monolog: ^3.10
• nikic/fast-route: ^1.3
• php-di/php-di: ^7.1
• psr/log: ^3.0
• spora-ai/installer: ^1.1
• symfony/console: ^8.0
• symfony/http-client: ^8.0
• symfony/http-foundation: ^8.0
• symfony/mailer: ^8.0
• symfony/process: ^8.0
• symfony/yaml: ^8.0
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.94
• larastan/larastan: ^3.9
• mockery/mockery: ^1.6
• pestphp/pest: ^5.0
• phpstan/phpstan: ^2.1
• phpstan/phpstan-mockery: ^2.0
• zircote/swagger-php: ^6.4

MIT

Published on Packagist.org on 2026-08-05 10:30 UTC

README

What is Spora?

A self-hosted AI agent orchestration platform in PHP 8.4+. Define agents, give them tools, and Spora runs the loop — tick-based, LLM-agnostic, with human-in-the-loop approval for write operations. Zero-config (SQLite out of the box, MySQL for production), portable (any PHP host, Docker), extensible via plugins, BYO model (any OpenAI- or Anthropic-compatible endpoint), and yours to keep — no vendor lock-in, no telemetry.

Install (operators)

If you want to run Spora, install the operator skeleton — it pulls in spora-core, the Vue admin UI, and the installer:

composer create-project spora-ai/spora

See spora-ai/spora for full setup, Docker deployment, and production guidance.

Develop (contributors)

If you want to work on spora-core itself:

composer install         # dependencies
composer test           # Pest
composer analyse        # PHPStan
composer format         # PHP-CS-Fixer
composer openapi        # regenerate openapi.json

See CONTRIBUTING.md for coding standards and PR conventions.

Documentation

Full documentation lives in spora-ai/spora-docs: architecture, API reference, LLM drivers, plugin system, tool development, frontend, deployment, security.

License

MIT — see LICENSE.

Early alpha. Functional and runs in production for personal use, but the API, schema, and plugin system may change in breaking ways before v1.0.