Integrators · AI agents · local lab
Developers & agents
circaevum.com is the public Graphics Library — auth-free 3D time visualization. Login and calendar sync live on app.circaevum.com.
Machine-readable entry: llms.txt · FOR-AGENTS.md · agent readiness scan
AI agents — read in this order
- llms.txt — site map and discovery URLs (start here)
- FOR-AGENTS.md — full reference: paths, embed API, postMessage, OAuth optional
- Agent Skills index —
circaevum-gl-embed,circaevum-site,circaevum-developers
No content negotiation on / without Cloudflare — fetch /index.md or FOR-AGENTS.md directly.
Modular: embed the GL with your auth, or plug into Circaevum accounts — see integration paths.
Integration paths
Pick what you need. Systems are independent.
| Path | Use when | Auth |
|---|---|---|
| A — GL + your auth | You want the 3D viewer only | Yours — GL is auth-free |
| B — Circaevum account | Calendars, Nakama storage, Garmin | app.circaevum.com + Nakama |
| C — Reference wrapper | Copy Yin-portal iframe pattern | Nakama (swap for yours) |
| D — Local lab | Muse / ESP32 / OSC on LAN | Local only |
Path A: iframe ?viewer=1 → your login →
CIRCAEVUM_INGEST_EVENTS. No OAuth on circaevum.com required.
Full detail: FOR-AGENTS.md
Discovery (agents & crawlers)
| Resource | URL |
|---|---|
| Start — LLM site map | /llms.txt (read first) |
| Full agent reference | /docs/FOR-AGENTS.md (read second) |
| Homepage (markdown) | /index.md |
| API catalog (RFC 9727) | /.well-known/api-catalog |
| Agent Skills | /.well-known/agent-skills/index.json |
| Sitemap | /sitemap.xml |
| robots.txt | /robots.txt (Content-Signal + AI bot rules) |
Embed API
Load the viewer in an iframe or new window:
https://circaevum.com/index.html?viewer=1After load, use the public GL helpers (see API.md):
const gl = window.getGL();
gl.ingestEvents('my-layer', events, { layerStyles: {} });Source: circaevum-gl.js · Wrapper guide: VIEWER-AND-WRAPPER.md
postMessage (iframe)
Wait for CIRCAEVUM_READY from the iframe, then send:
CIRCAEVUM_INGEST_EVENTS—{ layerId, events, options? }CIRCAEVUM_CLEAR_EVENTS—{ layerId }CIRCAEVUM_FIT_VIEW—{ focus, zoom }CIRCAEVUM_OPEN_EVENT_LIST
Full table: FOR-AGENTS.md
OSC lab streams (local)
For Muse, ESP32, or other sensors on your LAN: stream via Open Sound Control (UDP), record to CSV locally, or bridge into a custom viewer. Nothing is uploaded by circaevum.com.
| Address | Data |
|---|---|
/eeg | EEG floats (µV), multi-channel |
/ppg, /optics | Biometric optics |
/acc, /gyro | IMU |
/drlref | Electrode quality |
/thermistor | Temperature |
Muse iOS example sends /eeg over OSC (default port 7000). A Python python-osc recorder can write one CSV per stream under a dated session folder.
MCP
No MCP server on circaevum.com. There is no live Model Context Protocol endpoint on this static site.
Available instead:
- Agent Skills index — SKILL.md documents for coding agents
- API catalog — doc linkset (RFC 9727)
- FOR-AGENTS.md — full integrator reference
Account & OAuth (Path B — optional)
Only if you use Circaevum-managed accounts. For GL + your own auth, skip this block.
Nakama login, calendars, and Garmin Connect: app.circaevum.com. OAuth/OIDC discovery on this origin:
- oauth-authorization-server (RFC 8414)
- openid-configuration
- oauth-protected-resource (RFC 9728)
- auth.md — agent registration guide
Storage contracts: circaevum-spec.
Open source
- three-circa — this site
- API.md — GL reference
- AGENT-READINESS.md — deploy & Cloudflare checklist