cassproject/cass repository overview

⁠CaSS

Competency and Skills System — Open-source competency framework management, assertion tracking, and learner profile computation.

⁠Overview

CaSS enables organizations across education, training, and workforce development to author competency frameworks, record assertions of individual competency attainment, compute learner profiles, and exchange competency data with external systems via standards-based protocol adapters.

The system is composed of:

• CaSS Server — A Node.js/Express application providing the REST API, data persistence (via Elasticsearch), and protocol adapters.
• CaSS Library — A JavaScript SDK (cassproject⁠) providing data models, cryptographic identity management, and an interoperability layer for web applications.
• CaSS Editor — A Vue.js single-page application for framework authoring, crosswalks, import/export, and user management.
• Protocol Adapters — Pluggable cartridges providing standards-based interoperability (xAPI, CTDL-ASN, IMS CASE, Open Badges 2.0, ASN, MCP, and more).

⁠Quick Start

⁠Docker (Recommended)

Docker images for standalone and distributed deployments are available on Docker Hub:

Use the provided Docker Compose files for common configurations:

docker compose up -d

See DEPLOYMENT.md⁠ for detailed Docker, Kubernetes, and production deployment guidance.

⁠Local Development

git clone --recurse-submodules https://github.com/cassproject/CASS
cd CASS
npm install
npm run dev        # Starts server with auto-restart on save

Prerequisites: Docker (pulls and runs Elasticsearch on port 9200).

⁠Running Tests

npm test           # Runs the full test suite (do not run alongside npm run dev)

⁠Generating API Documentation

npm run docs       # Output deposited in /docs

⁠Production

Use containerized builds. See the Docker Compose files in the repository root for examples.

⁠Post-Installation

To support open linked data, objects created in CaSS should have public, reliable URLs:

1. Assign the server a domain name.
2. Enable HTTPS (see CONFIGURATION.md⁠).
3. (Optional) Use a reverse proxy to control the endpoint.

⁠FIPS 140-3 Support

FIPS is supported both client-side and server-side. It is recommended to use the Docker container builds for FIPS compliance.

Source: OpenSSL FIPS 140-3 Announcement⁠

⁠Documentation

⁠External Documentation

⁠License

Apache License 2.0⁠