📌 1. Introduction

Welcome to Brominon Remote Exams — a comprehensive online examination platform designed for Kenyan schools following both CBC and 8-4-4 curricula. The system features AI-powered exam generation, automatic marking (400 students in 58 seconds), and real-time progress tracking.

Key Features

Brominon turns weeks of marking into seconds. Give teachers their weekends back.

🚀 2. Getting Started

System Requirements

• Browser: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+
• Internet: Minimum 1Mbps for exams, 5Mbps for live classes
• Devices: Desktop, laptop, tablet, smartphone

First Time Login

1. Navigate to your school's exam portal: remote.autobell.uk
2. Click Login (top right)
3. Enter credentials provided by school:
   • Students: firstname@admission_number (e.g., john@2024/001)
   • Teachers: username provided during school setup
   • Admins: username provided during school setup
4. Click Sign In

Password recovery: Contact your school administrator.

👩‍🎓 3. For Students

Student Dashboard

After login you'll see: upcoming exams, recent results, live class sessions, homework, and notifications.

Taking an Exam

1. From dashboard click Upcoming Exams or Take Exam
2. Read instructions carefully
3. Click Start Exam
4. Answer each question (for structured, label parts a, b, c)
5. Click Submit when finished

Exam Rules

• ⏱️ Timed exams — submit before timer expires
• 🔄 Auto-save every 30 seconds
• 📵 No tab switching — may be flagged as cheating
• ✅ One attempt per exam (usually)

Viewing Results

My Results → select exam → view score, correct answers, AI feedback, class average. Results are visible immediately after clicking Submit.

Live Classes

Live Class from dashboard → join scheduled class. Features: audio, whiteboard, chat, screen sharing, see classmates.

👨‍🏫 4. For Teachers

Teacher Dashboard

• 📊 Class performance (average scores by subject)
• 📝 Pending marking (exams waiting for review)
• 🎯 Upcoming exams
• 🤖 AI marking status (real-time progress bar — 400 students in 58s)

Creating Exams — 4 Methods

Method 1: CBC Generate (AI)

Generates CBC-aligned exams following KICD guidelines.

1. Exams → Create New Exam → AI CBC Generator
2. Select Grade/Class. For Senior School (Grade 10–12), type your Stream/Pathway (e.g., STEM, Arts)
3. Choose a Subject from the dynamic list
4. Add Topics manually or click "Suggest AI-powered topics based on subject"
5. Remove any unwanted topics — keep only what you want tested
6. Select Number of Questions (5–30)
7. Choose Question Types (short answer, structured, essay, multiple choice)
8. Optionally select CBC Competencies & Values to test
9. Click "Generate Exam with AI"

What you get: Questions with Bloom's Taxonomy levels, marking scheme included, CBC competencies & values integrated, exportable to Word.

Method 2: 8-4-4 KCSE Generate (AI)

Generates exams following KNEC standards with proper paper structure.

1. Exams → 8-4-4 KCSE Generator
2. Select Subject, Form, and Paper (e.g., Mathematics, Form 3, Paper 1)
3. Choose Topics or use AI suggestions
4. Set Number of Questions and Difficulty
5. Click "Generate KCSE Exam"

Automatic Paper Structure:

• Mathematics: Section I (16 questions, 50 marks) + Section II (8 questions, answer 5, 50 marks)
• Sciences: Short-answer theory questions (80 marks)
• Humanities: Section A (short answer) + Section B & C (essay with choices)

Method 3: Import from File

1. Exams → Create New Exam → Import Exam with AI
2. Upload DOCX, PDF, or TXT — AI extracts Q&A, marks, types, and correct answers
3. Include the marking scheme for accurate auto-marking and student revision
4. Review and edit extracted content, set schedule, Create Exam

Method 4: Manual Creation

1. Exams → Create New Exam → fill details → add questions one by one
2. Click Add, choose question type (Short Answer recommended)
3. Enter the question, then add the model answer (used for AI marking and revision)
4. Set marks per question, schedule the exam, click Create Exam

After Generation (all methods):

• Adjust grade posting details — choose the target grade and set post date/time
• Review each question carefully
• Use Edit to adjust marks, change questions, or update model answers
• Click Create Exam — students will see it with a countdown timer

Managing Exams

View all: Exams → All Exams (filter by status, search).
Edit/Delete: Find exam → click Edit/Delete (deletion removes all submissions).

Marking Exams

AI Marking (automatic for short answers and essays):

1. Go to exam → AI Marking — processes 400 students in just 58 seconds
2. Progress shown with real-time percentage bar

Review AI Marks: exam → AI Review — for each answer: Accept (✅), Adjust (✏️), or Add Feedback (💬). See AI confidence scores. Filter by question or student.

Manual Marking: exam → Manual Mark → select question → mark student answers → Save and Next.

Analytics & Reports

• Analytics: Score distribution, question-level analysis, class average, absentee list (send SMS to parents).
• Export: Results to Excel or PDF.

🏫 5. For School Administrators

Admin Dashboard

• 🏫 School overview — stats at a glance
• 👥 User management — add/edit users
• 📊 Usage reports (credit consumption)
• 💰 Credit balance (AI and SMS credits)

User Management

Add individually: Users → Add User → select role (Student or Teacher), fill details (username auto‑generated for students).

Bulk import: Users → Import Users → download template, fill data (no username/password columns needed), upload → review results. System auto-generates student credentials: firstname@admission_number.

Manage users: filter by role/grade/stream/status, edit info, activate/deactivate, reset password, view full details.

Grade Management

View/Add/Edit grades. Promote students at year end: Grades → Promote → choose whole school or specific grade → confirm. Automatically creates next grade if it doesn't exist, preserves all student accounts and history.

Credits Management

View balances. Purchase: Credits → Purchase Credits → select type (SMS/AI), enter amount, complete M‑Pesa (instant top-up). Manual addition available for offline payments.

Exam Monitoring

Exams → view all exams across teachers, filter by status or teacher, click any to see details/analytics/submissions.

Reports

Reports → select date range → usage statistics, credit usage, user growth.

⚙️ 6. For Super Admins

Full system configuration: manage schools, global credit pools, audit logs, system‑wide AI model settings. Contact Autobell support for super admin access.

📝 7. Exam Taking Guide

Before exam: check device, internet connection, and browser compatibility. Use Chrome for best results.

During exam: answer clearly; label structured parts (a, b, c). Answers auto-save every 30 seconds.

After exam: for AI‑marked exams, see your revision guide immediately. Review model answers for questions you got wrong.

🤖 8. AI Marking System

The Brominon AI marking engine processes 400 students in 58 seconds — the fastest school exam marking engine in Kenya.

How AI Marking Works

• Compares student answers against model answers
• Awards partial credit for partially correct answers
• Provides specific feedback explaining why marks were awarded
• Processes submissions in batches with real-time progress display
• Uses multiple AI providers — if one is unavailable, automatically falls back to another (no data lost)
• Failed batches are automatically retried up to 3 times with increasing delays

Teacher Review Process

After AI completes marking, teachers review via AI Review: accept AI marks (✅), adjust marks (✏️), or add comments (💬). See AI confidence scores for each mark. Marks become final after teacher approval.

📊 9. CBC Competency Analytics

Track student progress against the 7 Core Competencies of the CBC curriculum with AI-generated qualitative reports.

How It Works

• Every question is mapped to CBC competencies based on Bloom's Taxonomy level
• The system calculates percentage scores per competency across all exams
• Students are ranked by overall competency performance
• AI generates professional qualitative progress reports for any student (Ministry-compliant format)

Viewing Competency Data

1. Click "Competency Analytics" in the sidebar
2. Select a Grade from the grade pills at the top
3. View the Class Competency Overview with color-coded progress bars
4. Scroll to Student Rankings and click "AI Report" on any student
5. AI generates a report with strengths, areas for growth, and next steps

Proficiency Levels

📐 10. AI Lesson Planner & Scheme of Work

Generate KICD-compliant lesson plans and schemes of work in seconds using AI.

Lesson Plans

1. Click "Lesson Planner" in the sidebar
2. Select CBC or 8-4-4 using the toggle switch
3. Choose Subject, Grade/Form, and Paper
4. Enter a Topic (e.g., "Gas Laws", "Quadratic Equations")
5. Click "Generate Lesson Plan"

The AI generates a complete lesson plan with: learning objectives, key vocabulary, materials list, step-by-step procedure (teacher & learner activities), active learning strategies, assessment methods, and differentiation for diverse learners.

Scheme of Work

1. Select your subject and grade as above
2. Click "Generate Scheme of Work"

Generates a term-long breakdown with: weekly topics, sub-topics, objectives, activities, resources, and assessment for each week.

📚 11. Posting Homework & Assignments

How to Post Homework

1. Click "Homework" in the sidebar
2. Click "Post Homework" to open the form
3. Enter the Title and select a Grade
4. Add Instructions/Message (e.g., "Complete using log books, due Friday")
5. Optionally attach a PDF, Word, or TXT file (max 10MB)
6. Click "Post Homework"

What Students See: Students see only homework posted to their grade. They can download attached files and view your instructions from their dashboard.

🎥 12. Live Classes

Conduct real-time online classes with video, audio, screen sharing, and interactive whiteboard.

Starting a Live Class

1. Go to your Teacher Dashboard
2. Look for the "Live Teaching" section (purple banner)
3. Select your grade from the dropdown under "Quick Start"
4. Click "Start Live Class Now"
5. Students in that grade are automatically notified and can join from their dashboard

During Class Features

• Video/Audio — Toggle your camera and microphone
• Screen Share — Show presentations or demonstrations
• Whiteboard — Draw and annotate in real-time
• Chat — Text-based discussion with students
• Attendance — Automatically tracked for every session

🎓 13. AI Tutor for Students (CBC)

Students have access to an AI-powered tutor (ChatBrominon) at chatbrominon.autobell.uk.

Features

• Virtual labs powered by PhET and Geogebra simulations
• Interactive CBC-aligned tutoring sessions
• Available 24/7 for self-paced learning
• Smart teaching panel with interactive experiments

📈 14. Viewing Results & Analytics

Accessing Results

1. Go to "Exams" and click on an exam
2. Click "View Results"
3. See individual student scores, total marks, and AI confidence levels
4. Export results to Excel or PDF

Analytics View

• Score distribution across the class
• Question-level analysis (identify difficult questions)
• Class average comparison
• Absentee list — send SMS notifications to parents directly

Students see results immediately after clicking Submit — they can view scores, correct answers, and detailed feedback right away.

📥 15. Importing Students via Excel

Bulk-import students using an Excel file. Usernames and passwords are auto-generated — you don't need to provide them.

Required Excel Columns

👥 16. Managing Students

Adding Individual Students

Go to Students → Add Student and fill in:

• Username & Password — Login credentials
• Grade & Stream — Class assignment
• Admission Number — Unique identifier
• Parent Phone — For SMS communication (also used as password if importing)

Promoting Students

At the end of the academic year, use "Promote Students" to move students to the next grade level. This automatically:

• Creates the next grade if it doesn't exist
• Updates all selected students to the new grade
• Preserves student accounts and full history

🔑 17. Student Login Credentials

How Students Log In

Students log in at: remote.autobell.uk/auth/login

Password Reset

If a student forgets their password:

1. Go to Manage Users (admin access required)
2. Find the student and click Edit
3. Enter a new password and save
4. Share the new password with the student

🔧 18. Troubleshooting

• Can't log in? Verify username format (firstname@admission) or contact admin.
• Exam not loading? Refresh page, check internet connection, use Chrome or Firefox.
• AI marking in progress? The engine processes 400 students in 58 seconds — check the real-time progress bar.
• AI marking failed? The system auto-retries up to 3 times with backup providers. No data is lost.
• Live class audio issues? Check microphone permissions in your browser settings.
• Forgot password? Only school admin can reset passwords — contact them directly.
• File upload failed? Max file size is 10MB. Supported formats: DOCX, PDF, TXT.

❓ 19. Frequently Asked Questions

• Q: How fast is the AI marking engine?
  A: The Brominon marking engine processes 400 students in 58 seconds — the fastest school exam marking engine in Kenya.
• Q: How many AI markings per tier?
  A: Standard: 5,000/year, Premium: 12,000/year, Enterprise: 25,000/year.
• Q: Can I combine AI and manual marking?
  A: Yes — AI marks automatically, then the teacher reviews, adjusts if needed, and approves.
• Q: Do students see results instantly?
  A: Yes — results are visible immediately after students click Submit.
• Q: Can I edit questions after generating an exam?
  A: Yes! After AI generation, you're taken to an edit page where you can modify any question, adjust marks, change Bloom's levels, edit answers, or delete questions before saving.
• Q: What if the AI generates incorrect content?
  A: AI-generated content should always be reviewed before use. The edit page lets you correct errors. For 8-4-4 exams, the system enforces syllabus boundaries.
• Q: Can I export exams to print?
  A: Yes! Click "Export to Word" — download the Question Paper (for students) or Marking Scheme (for teachers).
• Q: What happens if AI marking fails mid-way?
  A: The system auto-retries up to 3 times with increasing delays. Backup providers kick in automatically. No student answers are lost.
• Q: Is there a mobile app?
  A: The responsive web app works on all devices — phones, tablets, laptops. No app installation needed.
• Q: Internet requirements?
  A: Minimum 1Mbps for exams, 5Mbps for live classes.
• Q: How do students log in?
  A: Username: firstname@admission_number. Password: parent phone number (provided by school).
• Q: What is the cost?
  A: Standard (≤600 students) KES 40k/year, Premium (601–1200) KES 50k/year, Enterprise (1201+) KES 60k/year. All tiers include the Interactive Smart Board and Automatic Revision Hub.