Skip to content

Milena-Tanui/GradeFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 

Repository files navigation

🎓 GradeFlow

AI-Powered Assessment Generation

Automatically generate tailored assessments from course content — in seconds, at scale.

Built with CrewAI Powered by Replit AI Assisted Status


🧠 What is GradeFlow?

GradeFlow is an agentic AI tool built to ingest any course content — raw text, learning objectives, or module summaries — and instantly generate a fully structured, professionally worded assessment aligned with that content.

Every employee is assessed, ensuring evaluations are efficient and genuinely meaningful to each individual's learning journey. The result is a smarter, faster, and more equitable way for organizations to measure what their people know — and identify exactly where growth is needed next.

No LMS required. Just a shareable link your whole team can access instantly.


🎯 The Problem It Solves

Organizations must continuously upskill their workforce to stay competitive — but L&D teams are often stretched thin, tasked with assessing entire workforces while simultaneously managing content creation and reporting.

The manual effort required to write questions, calibrate difficulty, and format deliverables takes hours. GradeFlow eliminates that burden.


⚙️ How It Works

GradeFlow uses a multi-agent architecture powered by CrewAI. Feed it your course content and the agents collaborate to produce a complete, calibrated assessment:

Course Content Input
(raw text, learning objectives, module summaries)
        ↓
  [Agent 1: Content Analyser]
  Reads and interprets the course material,
  identifying key concepts and learning outcomes
        ↓
  [Agent 2: Assessment Builder]
  Generates structured, difficulty-calibrated
  questions aligned to the course content
        ↓
  Fully formatted assessment + shareable link
  delivered in seconds

🎬 Demo Video

A short walkthrough of the GradeFlow build process and how it works.

Watch the Demo


📸 Screenshots

GradeFlow in action — from content input to generated assessment.

Assessment Input Screen

Assessment Input

Generated Assessment Output

Assessment Output

CrewAI Agent Workflow

CrewAI Workflow


🛠️ How It Was Built

Layer Tool Role
🧠 Workflow Design Claude Designed agent logic & generated structured prompts for CrewAI and Replit
🤖 Agent Orchestration CrewAI Defined and orchestrated the multi-agent workflow via prompt
💻 App Interface Replit Built and styled the product frontend and user experience via prompt
🔗 Integration CrewAI API Connected Replit and CrewAI so agents and interface communicate seamlessly

The Build Process:

  1. Used Claude to articulate the workflow logic and generate two structured prompts — one for CrewAI, one for Replit
  2. Pasted the CrewAI prompt to define and orchestrate the multi-agent workflow
  3. Used the Replit prompt to build and style the product interface
  4. Connected both platforms using API credentials from CrewAI, enabling seamless communication between the agents and the frontend
  5. Used Replit's built-in AI assistant to iteratively debug integration issues as they arose

Approach: Low-code — prompt engineering drives the agent intelligence, CrewAI handles orchestration, and Replit powers the full-stack interface.


👥 Who It's Built For

User How GradeFlow Helps
🎓 L&D Managers Generate assessments from course content in seconds instead of hours
🧑‍🏫 Corporate Trainers Stop manually writing questions for every session, cohort, or department
👔 HR Directors & People Ops Get consistent, objective competency data across the entire workforce
🏢 CEOs & Business Leaders Run workforce assessments without a dedicated L&D department

The real-world value: Time, consistency, and scale. When employees are assessed accurately and upskilled efficiently, the whole organization performs better — and GradeFlow makes that possible without adding to anyone's workload.


🚀 Current Status

  • Multi-agent assessment generation workflow
  • CrewAI + Replit integration via API
  • Course content ingestion (text, objectives, summaries)
  • Shareable assessment link output

🔭 Future Vision

The current version of GradeFlow solves the creation problem. The roadmap extends into a fully closed-loop assessment ecosystem:

  • Auto-assignment — distribute assessments directly to individuals or teams without manual link sharing
  • Auto-marking — score submissions and generate personalised results reports highlighting strengths and flagging areas for improvement
  • Performance intelligence — transform GradeFlow from an assessment builder into a complete L&D analytics tool
  • HR system integration — automate scheduling, track progress over time, and surface workforce-wide insights

Beyond corporate L&D, GradeFlow is adaptable to education (schools, universities), healthcare (staff certification), financial services (compliance training), and government workforce development programs.


💡 Built By

Milena Tanui — AI Agent Builder & Automation Architect

"GradeFlow was built using a low-code approach: prompt engineering in Claude to design the agent logic, CrewAI for multi-agent orchestration, and Replit for rapid full-stack development."

GitHub LinkedIn


Part of a growing portfolio of AI agents and automation tools. ⭐ Star this repo if you find it interesting!

About

AI-Powered Assessment Automation for Learning & Development Teams - built with CrewAI abd Replit

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors