oll4.com

Public website and open portfolio for OLL4 AI automation systems.

Scope

This repository contains the public oll4.com site code:

• landing page and visual assets
• PHP contact and public Hermes concierge endpoints
• llms.txt and machine-readable public site metadata
• public runtime helpers required by the site

This repository does not include private infrastructure state, secrets, live credentials, internal dashboards, or deployment-only rollback artifacts.

Stack

• HTML/CSS/JavaScript
• PHP endpoints for contact flow and public concierge proxying
• static assets under assets/
• GitHub Actions for validation and tagged releases

Public Agent

The public site assistant is the Hermes concierge runtime:

• default route: gpt-5.4-mini with medium reasoning
• advanced route: gpt-5.4 with high reasoning
• fallback: structured human handoff when the request exceeds public-safe scope
• runtime policy: short-lived sessions, turn limits, same-origin access, rate limiting, and Turnstile checks

Full public-facing technical notes live in docs/HERMES_PUBLIC_AGENT.md.

Local Run

Use PHP's built-in server so the public endpoints work locally:

export OLL4_PUBLIC_AGENT_URL=http://127.0.0.1:8766
export OLL4_TURNSTILE_ENV_FILE="$PWD/private-state/turnstile.env"
php -S 127.0.0.1:8080

Then open http://127.0.0.1:8080.

For local Turnstile-backed form tests, create a local secret file outside git tracking:

• private-state/turnstile.env
• contents: OLL4_TURNSTILE_SECRET=replace-me

If you do not need the live contact or concierge flow, the pages still render without the private runtime.

Professional Release Flow

This repo uses Calendar Versioning in VERSION:

• format: YYYY.MM.DD.N
• example: 2026.06.08.1

Release flow:

1. Make changes on main or a feature branch.
2. Run make validate.
3. Update VERSION and CHANGELOG.md.
4. Merge to main.
5. Create tag v$(cat VERSION).
6. Push the branch and the tag.
7. GitHub Actions validates the repo and publishes a GitHub Release with a bundled source tarball.

Detailed steps live in docs/RELEASING.md.

Commands

make validate
make bundle
make version

Security

Report vulnerabilities privately as described in SECURITY.md.

Do not open public issues for secrets exposure, runtime access paths, or security bypasses.

License

Code in this repository is released under the MIT License.

The implementation was created and edited with assistance from OpenAI Codex and ChatGPT. See NOTICE.md for attribution and bundled third-party notice guidance.

The OLL4 name, logo, and trademarks are not granted by the code license.