Open Source Free MIT Licence

Online Exam Platform, Powered by WeChat

A comprehensive online examination system with WeChat integration. Create papers, organize knowledge points, tag questions, and deliver exams seamlessly through WeChat.

Go to dashboard
WeChatExam Screenshot
Features

Why use WeChatExam?

A modern, flexible, and comprehensive platform for creating and managing online examinations.

WeChat Integration

Seamlessly integrate with the WeChat ecosystem. Users can log in, take exams, and receive results directly through WeChat Official Accounts and Mini Programs.

Paper Templates & Snapshots

Create reusable paper templates. When an exam starts, a snapshot freezes the content so every student sees the same questions even if the template is updated later.

MTQL Query Language

Use Mark-to-Query Language (MTQL), a powerful DSL, to filter questions with boolean logic like "(difficulty:hard || source:textbook) && not year:2020" for precise question selection.

Hierarchical Knowledge Points

Organize educational content in a hierarchical tree of categories and knowledge points. Map questions to specific learning objectives and track what each question assesses.

Flexible Tagging System

Group tags by taxonomies like Difficulty, Source, or Year. Apply multiple tags to each question for flexible categorization and advanced filtering.

Exam Records & Analytics

Track every student attempt with detailed answer records. Review individual answers, analyze performance, and identify knowledge gaps across your student base.

OpenID Connect Authentication

Built-in OpenID Connect support for seamless authentication. Integrate with any OIDC provider alongside WeChat login, with automatic role synchronization.

AI-Powered Assistance

Integrated with Ollama for AI-powered question assistance. Get help generating questions, explaining answers, or reviewing exam content.

RBAC Authorization

Fine-grained Role-Based Access Control for managing teachers, students, and administrators with distinct permissions and capabilities.

WeChat Payment

Integrated WeChat Pay (TenpayV3) for monetizing exams. Charge for premium exam access, certifications, or course materials directly through WeChat.

Multiple Database Support

Easily switch between SQLite, MySQL, SQL Server, and in-memory database providers to match your deployment needs from development to production.

Docker-Ready Deployment

Full Docker support with pre-built images on Docker Hub. Deploy with a single command, or use the install script for Ubuntu servers with systemd integration.

How It Works

From Questions to Exams in Minutes

Build your question bank, organize by knowledge points, create paper templates, and deliver exams to students — all within one integrated platform.

1. Build Question Bank

Create questions organized by hierarchical categories and knowledge points. Tag them with taxonomies for advanced filtering.

2. Design Paper Templates

Use MTQL to select questions by tags and knowledge points. Define the exam structure, duration, and scoring rules.

3. Deliver to Students

Publish exams with start/end times. Students access via WeChat or web, answer with frozen snapshots ensuring fairness.

Use Cases

Built for Education

WeChatExam adapts to a wide range of educational and assessment scenarios.

Schools & Universities

Run midterms, finals, and quizzes with structured knowledge point tracking and detailed performance analytics for each student.

Professional Certifications

Create certification exams with time-limited access, randomized question selection, and WeChat Pay integration for exam fees.

Corporate Training

Assess employee knowledge with internal training exams. Track progress over time and identify areas needing additional training investment.

WeChat Mini Programs

Embed exams directly into WeChat Mini Programs. Students take assessments without leaving WeChat, with instant results and sharing capabilities.

Online Courses

Pair with online course platforms to deliver lesson quizzes, chapter tests, and final assessments with automatic grading and feedback.

Surveys & Polls

Beyond exams, use the platform for surveys, polls, and feedback collection with WeChat distribution for high response rates.

FAQ

Frequently asked questions

Here are some of the answers you might be looking for.

Yes, WeChatExam is completely free and open-source under the MIT License. You can use it for personal, educational, and commercial purposes without any cost.
WeChat integration is optional. The platform works fully as a standalone web application. You only need WeChat credentials if you want to enable WeChat login, Mini Program access, or WeChat Pay.
MTQL (Mark-to-Query Language) is a domain-specific language for filtering questions by their tags. You write expressions like "(difficulty:hard && source:textbook) || knowledge_point:calculus" to precisely select which questions appear in a paper. It supports AND, OR, NOT, and parenthesized grouping.
When an exam starts, the system creates an immutable snapshot of the paper and its questions. All students see the exact same content, even if the original paper template or questions are modified later. This guarantees a fair and consistent assessment experience.
You can deploy via Docker with a single command, use the Ubuntu install script for automated systemd setup, or run it manually with the .NET SDK. See the README on GitHub for detailed deployment instructions.

Ready to build your exam platform?

Get started with WeChatExam today. Deploy in minutes with Docker.

View on GitHub Docker Hub