Project notes
Ophelia
A fixture-first deployment control plane for VPS apps, static sites, safe operations, and agent-readable workflows.
Repository snapshot
- 207Commits
- Aug 2026Updated in snapshot
- Apache-2.0License
- Apr 2026Started
- Python 99.7%
- Shell 0.2%
- Makefile 0.1%
- HTML 0.0%
- Go Template 0.0%
Recent commits
Overview
Ophelia turns application manifests into validated runtime bundles, dry-run plans, confirmation-gated applies, redacted receipts, and schema-versioned JSON surfaces. It is built for operators and agents that manage VPS-hosted apps without hand-editing Compose files, Caddy snippets, release records, and deployment state.
Highlights
- 01
Manifest contract
One app-owned declaration for services, routes, lifecycle, data, backups, readiness, and verification.
- 02
Runtime rendering
Deterministic Docker Compose, Caddy snippets, env templates, lock files, and rollback bundles.
- 03
Safety gates
Dry-run plans, production confirmation tokens, redacted receipts, and command-string secret scrubbing.
- 04
Static publishing
First-class static sites: repo-local build roots, immutable releases, served through Caddy, no Docker required.
- 05
Readiness
App movement scoring, host placement checks, restore-drill evidence, and live observations.
- 06
Agent contracts
Command catalog, action registry, JSON schemas, operation envelopes, and LLM entrypoint docs.
What you can run
Documentation & getting started
git clone https://github.com/kylebegeman/ophelia.git && cd ophelia
python3 -m venv .venv && .venv/bin/pip install -e ".[test]"
./cli/ship self-test --json
./cli/ship validate examples/service-app.ophelia.yml
./cli/ship render examples/service-app.ophelia.yml --output-dir ./build/demo