spora-ai/spora-core
Composer 安装命令：
composer require spora-ai/spora-core
包简介
The WordPress of AI Agents — a portable, zero-configuration agent orchestration platform.
README 文档
README
⚠️ Early Alpha
Spora v0.1.0 is early alpha software. It is functional and runs in production for personal use, but the API, database schema, and plugin system may change in breaking ways before v1.0. Use at your own risk.
What is Spora?
Spora is a self-hosted AI agent orchestration platform built in PHP 8.4+.
It is designed to be:
- Zero-config — works out of the box with sensible defaults (SQLite for small-scale use, MySQL/MariaDB for team or production use)
- Portable — runs on any PHP 8.4+ environment, from a laptop to a shared cPanel/FTP host or as a Docker Container
- Extensible — a WordPress-like plugin system lets you add tools, drivers, and agent behaviors
- Bring your own model — connect any OpenAI- or Anthropic-compatible endpoint, from hosted APIs to local Ollama and LM Studio, and switch providers at any time
- Yours to keep — every tool call, prompt, and result stays on your infrastructure; no vendor lock-in, no third-party telemetry
You define agents, give them tools, and Spora handles the execution loop — tick-based, stateless, with human-in-the-loop approval for write operations.
Key Features
- Tick-based agent execution — stateless, LLM-agnostic orchestration loop (Think → Act)
- Built-in tools — email, calendar, web search, calculator, web scraping, and more
- Plugin system — drop a plugin folder with a
plugin.jsonmanifest, auto-discovered at boot - LLM drivers — OpenAI-compatible and Anthropic-compatible drivers via
DriverFactory - Human-in-the-loop — write tools (email, posting, etc.) require approval before execution
Requirements
| Requirement | Minimum | Notes |
|---|---|---|
| PHP | 8.4+ | Required |
| Node.js | 20+ | Only for frontend builds (Vite 6 / ESLint 10 require ≥ 20) |
| Database | SQLite (dev) / MySQL 8+ (prod) |
Installation
Step-by-step setup — including composer install, frontend build, and the optional Docker stack — is in the Installation Guide.
Documentation
Full documentation is in the docs/ directory:
| Document | Coverage |
|---|---|
| Index | Documentation index and feature overview |
| Architecture | System overview, config, orchestrator loop, plugin system |
| Database Schema | Tables, columns, migrations |
| Interfaces | PHP interfaces and contracts |
| API Reference | REST API endpoints |
| LLM Drivers | Driver architecture |
| Tool Development | How to build tools |
| Plugin System | How to write plugins |
| Logging | Logging conventions and PII policy |
| Frontend | Vue 3 app, stores, polling, SSE |
| Error Handling | Error envelope and code registry |
| Worker & Async | sync mode and worker:run deployment |
| Worker Deployment | Docker, systemd, supervisord |
| Installation | Setup requirements and steps |
| Code Documentation | Comment standards |
| Security | Encryption, CSRF, rate limits |
| Testing | Backend and frontend test setup |
Contributing
Contributions are welcome! See CONTRIBUTING.md for setup instructions and coding standards.
License
Spora is open source software under the MIT License. See the LICENSE file for full terms.
统计信息
- 总下载量： 0
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 1
- 点击次数： 4
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-06-24