Spora
About 365 wordsAbout 1 min
Spora
Self-hosted AI agent orchestration. Zero-config. Anywhere.
PHP 8.4+ on a laptop, a shared host, or a Docker container.
What is Spora?
Spora is a self-hosted AI agent orchestration platform. It runs anywhere PHP 8.4+ runs — a laptop, a shared cPanel/FTP host, a VPS, or a Docker container. Agents tick, call tools, and ask for human approval before touching the outside world. Plugins drop into a folder. Models are yours.
Quick start
# Create a Spora project (skeleton)
composer create-project spora-ai/spora my-spora
# Install
cd my-spora && php bin/spora spora:install
# Run (dev server with hot reload)
composer dev # → http://localhost:8080
# Or for a production-like server, see the [Deployment guide](/deploy/)That is the whole bootstrap. SQLite by default; flip SPORA_DB_* in .env for MySQL.
Starts PHP on :8080. (Docker multi-container uses :8081.)
Pick your track
| If you… | Start here |
|---|---|
| Are setting up a host environment (Docker, Apache, shared host) | Deploy |
| Are operating an already-installed Spora (env-vars, security, day-2 ops, backups) | Operators guide → |
| Are developing Spora plugins or projects | Develop → Projects |
| Are using the admin UI to chat | End user guide → |
Looking for the architecture deep-dive? See Concepts.
Project layout
| Repo | Role |
|---|---|
spora-core | PHP framework, plugins, drivers (recipes WIP) |
spora | Skeleton — what you deploy |
spora-frontend | Vue 3 + Vite + Tailwind admin SPA |
spora-plugin-* | Tool plugins (calendar, email, web search, etc.) |
spora-installer | Composer plugin that routes spora-plugin packages |
spora-maker | Local scaffolder (Tools, Controllers, app/App.php) |
Where to next?
- New to Spora? → Getting Started → Operators or pick your track above.
- Building on top of Spora? → Develop → Projects — Spora grows with you.
- Authoring a tool plugin? → Develop → Plugins.
- Running it in production? → Deploy.
- Reading the source? → Reference → Architecture & concepts.