Skip to main content

Welcome to humuus

humuus is an interactive educational workshop platform that enables real-time collaborative learning experiences. Built with modern web technologies, humuus makes it easy to create, host, and participate in engaging educational workshops.

warning

humuus is currently in active development. Some features may change, and the platform is not yet recommended for production use without consulting the humuus team.

What is humuus?​

humuus is designed to bridge the gap between traditional presentations and interactive learning. Whether you're teaching, doing a quiz session, or facilitating a collaborative classroom activity, humuus provides the tools you need to create engaging, synchronous learning experiences.

Benefits​

  • Easy to Join: Participants can join workshops with simple 4-digit codes - no accounts required
  • Rich Content Types: Mix slides, quizzes, whiteboards, videos, and more in a single workshop
  • Real-time Interaction: See participant responses instantly and adapt your teaching on the fly
  • Host Control: Guide participants through content at your own pace with presenter controls
  • Flexible Content: Create workshops using simple JSON files - no complex CMS required

Quick Start​

Ready to get started? Follow our Installation Guide to set up humuus locally, or jump straight to Creating Your First Workshop.

warning

The local setup from humuus requires a certain enviroment setup. The plattform is not for public use yet. Ask humuus team for missing env-variables & the minIO path.

# Quick start commands
git clone https://github.com/techagogics/humuus.git
cd humuus
pnpm install
pnpm run dev

Visit http://localhost:3000 to see humuus in action!

Architecture at a Glance​

humuus is built on three core technologies:

  • Next.js Frontend: Modern React-based web application with TypeScript
  • Nakama Server: Real-time game server adapted for educational workshops
  • MinIO Storage: Object storage for workshop content and media

This architecture provides:

  • Real-time synchronization between all participants
  • Secure device-based and email authentication
  • Scalable storage for workshop content
  • WebSocket connections for instant updates

Learn more in our Architecture Overview.

Use Cases​

humuus is perfect for:

  • Educational Workshops: Coding bootcamps, training sessions, and tutorial sessions
  • Corporate Training: Onboarding, skill development, and team building
  • Classroom Teaching: Interactive lessons with real-time student participation
  • Conference Workshops: Engage large audiences with interactive content
  • Remote Learning: Facilitate synchronous online learning experiences
  • Team Meetings: Run interactive retrospectives, brainstorming sessions, and collaborative planning

Example Workshop​

Here's what a simple quiz workshop looks like:

{
  "settings": { "name": "Test Workshop", "hostAsPresenter": true },
  "nodes": [
    {
      "type": "Slide",
      "sound": {
        "url": "/sound/plop.wav",
        "volume": 0.5,
        "repeat": false,
        "hostonly": false
      },
      "data": { "headline": "Test Workshop" }
    },
    {
      "type": "Quiz",
      "data": {
        "text": "Test?",
        "url": "Coast.jpg",
        "options": ["True", "False", "False", "False"],
        "answer": [1]
      }
    },
    {
      "type": "Quiz",
      "data": {
        "text": "Test?",
        "url": "Coast.jpg",
        "options": ["True", "False", "False", "False"],
        "answer": [1],
        "answerTime": 20
      }
    },
  ]
}

See Workshop JSON Format for complete documentation.

Community & Support​

Documentation Overview​

Made with 🖤 by the humuus team at techagogics in Kiel