OpenMaic Multi-user fork for school managment

[tajwali]

Hello THU-MAIC team,

We wanted to inform you that we have created a significant fork of OpenMAIC.

We are a small team building an AI-powered classroom platform for Pakistani
schools, and OpenMAIC provided an excellent foundation. We have extended it
significantly with a full multi-user system.

Key additions we've made:

• Full authentication system with 4 roles (admin, teacher, school_student, mature_student)
• Teacher dashboard with student management, course assignments, analytics
• Admin dashboard with user management and platform statistics
• Grade system (Grades 1-12) aligned with Pakistani curriculum
• Cross-device media serving (images and audio stored server-side)
• Course persistence to PostgreSQL/Supabase
• Subject classification and filtering
• Profile management with gender-based TTS voice selection

We have maintained AGPL-3.0 licensing and credit your team prominently.

We also cherry-picked several upstream improvements including:

• Ollama local LLM support
• Custom TTS/ASR providers
• Security fixes (SSRF, anti-framing headers)
• Course rename and ZIP export

Thank you for building OpenMAIC — it is an impressive platform and we hope
our fork contributes back to the community in some way.

Details of the Fork:

Fundamental Divergence
The upstream OpenMAIC is a single-user AI classroom tool — one person generates and views their own courses. new fork is a multi-user school management platform — teachers manage students, assign courses, track progress, and administrators oversee the entire institution.

These are fundamentally different products with different target audiences:

Fundamental Divergence

The upstream OpenMAIC is a single-user AI classroom tool designed for individual course generation. In contrast, New Fork is a multi-user school management platform where teachers manage students, assign courses, and administrators oversee the entire institution.

These represent fundamentally different products with distinct target audiences:

User Base: OpenMAIC is for single users; New Fork supports multiple users with defined roles.

Authentication: OpenMAIC has no system (Access Code only); New Fork features full auth with 4 distinct roles.

Workflow: OpenMAIC is for self-generated content; New Fork enables Teacher-to-Student assignments.

Tracking: OpenMAIC has no progress tracking; New Fork tracks quiz results and completion.

Management: OpenMAIC has no admin panel; New Fork includes a full admin dashboard.

Curriculum: OpenMAIC focuses on Chinese universities; New Fork targets Grades 1-12 in the Pakistani school system.

Storage: OpenMAIC is browser-local; New Fork uses cross-device server-side media serving.

2. Technical Incompatibility

Our core architectural changes conflict with the upstream direction in several critical areas:

• Authentication: Our system utilizes cookies and Supabase GoTrue, whereas upstream relies on simple access codes.

• Storage: Our media storage is server-side to allow for multi-device access; upstream remains browser-local.

• Streaming: Our approach to data streaming differs fundamentally from their implementation.

• Database: We have introduced numerous database tables that do not exist in the upstream schema.

3. Feasibility of Merging

A pull request to the upstream repository is not feasible. It would require the original maintainers to adopt our entire Supabase multi-user architecture, representing a total structural shift that is outside their current roadmap.

Identity of New Fork

New Fork represents a distinct educational platform vision specifically tailored for our needs:

• Designed for Pakistani schools and the KPK curriculum.

• Planned bilingual support for Urdu and English.

• Grade system alignment with Pakistani education standards (Grades 1-12).

• Self-hosted infrastructure to ensure data privacy and local compliance.

Best regards,
Tajwali