Open ICAP.
CLOUDFLARE WORKERS + D1
Deploy under your school's control.
Self-hosted software is FREE: $0 software fee. Your school
pays its own infrastructure costs. Open ICAP is being prepared for an
source-available release under its District Use License. Register your public school district and import its signed receipt before production use.
The repository contains a dependency-free Worker build, a D1 migration,
security tests and local SQLite development. Cloudflare and the school identity provider are configured by the district operator. No production secrets are
included in source.
Local development
npm test
npm run dev
The local server listens on loopback at port 8787. Read the generated
.dev-access-key file and use Operator access key on the login
page. Local records persist in .local-dev.sqlite. Both files
are ignored by Git. The fictional-data demo is available at
/demo.
Production database and identity
Create a D1 database with the intended jurisdiction, set its ID in
wrangler.jsonc and apply all migrations in drizzle/ through Wrangler migrations.
Provision the district, school and administrator membership with the
documented SQL in the repository. The app denies access until identity,
membership and database are configured.
For school sign-in, put the app behind Cloudflare Access, connect the
district IdP, require MFA and configure
ACCESS_TEAM_DOMAIN and ACCESS_AUD. Membership
subjects use the verified issuer and subject. Microsoft can be connected
through this identity boundary later.
Temporary operator access
Set a randomly generated token of at least 48 characters as the
BOOTSTRAP_TOKEN secret, configure
BOOTSTRAP_MEMBERSHIP_ID and explicitly set
ENABLE_BOOTSTRAP=true. Sessions last 30 minutes and require
active membership. Rotating the token invalidates existing operator
sessions. Disable this mode after school identity is available. Never put
the token in source, a URL or browser JavaScript.
Register the district license
Read the District Use License. Obtain a signed district receipt from Advocate and import it at District license setup after provisioning named administrator access. Apply every migration through 0007_school_admin_roles.sql. Production requires DISTRICT_LICENSE_MODE=required, the receipt’s DISTRICT_LICENSE_REGISTRATION_ID, and DISTRICT_LICENSE_JURISDICTION. Your own cloud account is permitted; a hosted subscription and Stripe configuration are not required.
Verification happens locally. Retain the receipt and accepted license with your deployment records. There are no routine licensing network calls. Account setup and scoped record retrieval remain available while a receipt is missing.
Privacy in both AI modes
Full AI and Safe AI exclude student names, real IDs and identifying text from model prompts. Both can receive approved requirement statuses under temporary labels such as “Student 003.” Original questions, notes, uploaded evidence, filenames and the alias-to-name mapping stay in ICAP. After inference, the UI can restore names only for authorized staff with student details revealed.
Optional Safe AI
PII means personally identifiable information, such as student names, student IDs, or other details that identify a student.
Model sourced from Hugging Face · New YorkModel: SmolLM2-135M-Instruct
Safe AI provides basic search and planning help using a model developed by Hugging Face. Deploy the separate private Cloudflare service described in safe-ai/README.md and verify its isolation before enabling it in the Account controls. The model runs with internet access disabled and no external AI fallback. Questions and records are not sent to Hugging Face. Staff review all responses and make student decisions.
Before using real education records
Complete district/vendor agreements and a deployment-specific notice. Set
school access, service purpose, retention/holds, secure export delivery,
backups and tested restore/deletion procedures. Disable public Worker
preview origins, protect the custom domain, limit Cloudflare account
access and establish incident response. Perform an independent
access-control and operational review. Code checks are not a legal
compliance certification.
Research and source crosswalk ·
Explore the fictional-data workspace