OCRA (Online Conservation-Restoration Annotator) is a collaborative full-stack platform for the structured documentation, analysis, and semantic enrichment of two- and three-dimensional representations of tangible cultural heritage assets. It supports 3D mesh representations, 2D images, and relightable/RTI models.
OCRA is developed by the Visual Computing Lab, ISTI-CNR as a Vertical Application of the ECHOES project and is designed to interoperate with the European Collaborative Cloud for Cultural Heritage (ECCCH). It combines collaborative annotation, semantic enrichment, and publication of Heritage Digital Twin data to ECCCH.
OCRA is under active development. The current codebase is a pre-release research platform: its architecture, workflows, APIs, and data models may evolve as development and validation activities within ECHOES continue.
- Active development repository: cnr-isti-vclab/OCRA
- Github pages: cnr-isti-vclab.github.io/OCRA
- Official ECHOES GitHub organization: ECHOES-ECCCH
Stable OCRA releases, tags, documentation, and release notes are intended to be made visible through the ECHOES GitHub organization in accordance with the ECHOES Git Repository Management Policy.
- Frontend: React + TypeScript (Vite), Bootstrap UI — dev server on
:3001. - Backend: Node.js + Express; Prisma + PostgreSQL for application data (users, sessions, projects) — API on
:3002. - Audit store: MongoDB 7.0 (audit events including login/logout/file uploads stored in Mongo collection). Backend uses Prisma only to enrich audit documents with user info (read-only).
- Authentication: OpenID Connect Authorization Code + PKCE through EGI Check-in.
-
Clone and enter the repository:
git clone https://github.com/cnr-isti-vclab/OCRA.git cd OCRA -
Create the ignored local EGI configuration and set the client secret issued by the Federation Registry:
cp .env.egi-demo.example .env.egi-demo
-
Start services with Docker Compose:
docker compose --env-file .env.egi-demo up --build -d app
-
Open the application:
- Frontend:
http://localhost:3001 - Backend API:
http://localhost:3002
- Frontend:
Notes:
- Audit logs (login/logout/file uploads) are stored in MongoDB; all authenticated users can view audit events (filtered by permissions).
- If you change the Prisma schema, run
npx prisma generateinbackend/to regenerate the client. - For local development without Docker, use the
frontendandbackendpackage.json scripts directly. - For production deployment, see DEPLOYMENT_GUIDE.md.
The Vocabularies page includes an experimental Getty Art & Architecture Thesaurus explorer backed by OCRA's provider-neutral vocabulary API. Search is debounced and cached; selected concepts are identified by their canonical Getty URI. This area does not yet modify annotations, and the existing local TTL spike is retained. See Getty AAT external vocabulary.
- Technical documentation index
- Architecture
- Workflows
- Development workflows
- Local development setup (bare services)
- Deployment guide
- OCRA: cnr-isti-vclab/OCRA
- ThreePresenter: cnr-isti-vclab/ThreePresenter — 3D viewer.
- OpenLIME: cnr-isti-vclab/openlime (
ocra-integrationbranch) — 2D and RTI viewer.
OCRA is released under the MIT License.
This work has been developed in the context of the ECHOES project — European Cloud for Heritage OpEn Science, funded by the European Union under Grant Agreement No. 101157364, with the support of UK Research and Innovation (UKRI) under the UK Government’s Horizon Europe funding guarantee No. 10110142 and No. 10110466.
Views and opinions expressed are those of the author(s) only and do not necessarily reflect those of the European Union or the granting authority. Neither the European Union nor the granting authority can be held responsible for them.