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.json manifest, 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

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:

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.