HumanLoop.cl

AI that orchestrates. Humans that execute.

IA que orquesta. Humanos que ejecutan.

🇺🇸 English

🚀 What is HumanLoop?

HumanLoop is a Human-in-the-Loop (HITL) orchestration platform that connects AI agents with human operators for real-world tasks. This is a proof of concept demonstrating how AI can coordinate complex operations while humans maintain autonomy, professional judgment, and responsibility.

💡 The Problem We Solve

Traditional task coordination relies on:

WhatsApp groups and scattered messages
Spreadsheets and manual tracking
Phone calls and unstructured communication
No traceability or scalability

HumanLoop changes this by creating an orchestration layer where:

AI agents plan and coordinate tasks
Human operators decide and execute with full autonomy
The system learns from feedback to improve continuously

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    ORCHESTRATION LAYER                       │
│         HumanLoop Orchestrator + Event Detection             │
├─────────────────────────────────────────────────────────────┤
│                    MCP AGENTS                                │
│    TaskAgent │ RoutingAgent │ ValidationAgent │ FeedbackAgent│
├─────────────────────────────────────────────────────────────┤
│                    SKILLS                                    │
│   DeliverySkill │ LegalSkill │ CleaningServiceSkill │ EventSkill  │
├─────────────────────────────────────────────────────────────┤
│                    HUMAN OPERATORS                           │
│     Autonomous execution + Professional judgment + Feedback  │
└─────────────────────────────────────────────────────────────┘

🛠️ Tech Stack

Technology	Version	Purpose
Next.js	15+	App Router, SSR
React	19	UI Components
TypeScript	5.7+	Type Safety
Tailwind CSS	v4	Styling
Vercel	-	Deployment

📦 Installation

# Clone repository
git clone https://github.com/devjaime/humanloop.git

# Install dependencies
cd humanloop
npm install

# Development server
npm run dev

# Production build
npm run build

🌐 Deploy to Vercel

Connect your repository to Vercel
Vercel will auto-detect Next.js
Automatic deployments on every push to main

📐 Ethical Framework

Principle	Description
Human supervision always	The operator has the final word
Explicit human responsibility	Humans decide, not just execute
AI as assistant, not boss	AI suggests, humans validate
Bidirectional collaboration	Human feedback improves AI
Amplification, not replacement	We enhance human capabilities
Fair compensation	Direct and transparent payment to operators

⚡ Available Skills

HumanLoop includes real-world skills that connect AI orchestration with human operators:

Skill	Command	Description
Business Consultant	`/business-consultant`	Connect with a software engineer for in-person consulting sessions
Cleaning Service	`/cleaning-service`	Professional home and office cleaning with AI scheduling
Gasfiter Service	`/gasfiter-service`	Certified plumbing and gas installation in Chile (SEC)
IoT Security Installer	`/iot-security-installer`	Professional security camera and smart home installation

Example: Business Consulting

/business-consultant
Topic: Explain microservices architecture to investors
Location: Las Condes, Santiago
Duration: 2 hours

Example: Gasfiter Service

/gasfiter-service
Type: reparación
Problem: Fuga de agua en cocina
Location: Las Condes, Santiago
Urgency: urgente

Example: IoT Installation

/iot-security-installer
Service: 4 IP cameras + NVR system
Location: Providencia
Property: Residential house

🎬 Demo Projects & Promotional Videos

Multiple promotional videos created using Remotion:

Demo	Description
`airbnb-cleaning`	Airbnb property cleaning automation demo
`vocari-videos`	Vocational platform promotional videos

# Preview demos
npm run remotion:preview

# Render specific demo
npm run remotion:render -- --props '{"video":"Video1Colegios"}'

🇪🇸 Español

🚀 ¿Qué es HumanLoop?

HumanLoop es una plataforma de orquestación Human-in-the-Loop (HITL) que conecta agentes de IA con operadores humanos para tareas del mundo real. Es un proof of concept que demuestra cómo la IA puede coordinar operaciones complejas mientras los humanos mantienen autonomía, criterio profesional y responsabilidad.

💡 El Problema que Resolvemos

La coordinación tradicional de tareas depende de:

Grupos de WhatsApp y mensajes dispersos
Hojas de cálculo y seguimiento manual
Llamadas telefónicas y comunicación no estructurada
Sin trazabilidad ni escalabilidad

HumanLoop cambia esto creando una capa de orquestación donde:

Los agentes de IA planifican y coordinan tareas
Los operadores humanos deciden y ejecutan con plena autonomía
El sistema aprende del feedback para mejorar continuamente

🏗️ Arquitectura

┌─────────────────────────────────────────────────────────────┐
│                    CAPA DE ORQUESTACIÓN                      │
│         HumanLoop Orchestrator + Detección de Eventos        │
├─────────────────────────────────────────────────────────────┤
│                    AGENTES MCP                               │
│    TaskAgent │ RoutingAgent │ ValidationAgent │ FeedbackAgent│
├─────────────────────────────────────────────────────────────┤
│                    SKILLS                                    │
│   DeliverySkill │ LegalSkill │ DiagnosticSkill │ EventSkill  │
├─────────────────────────────────────────────────────────────┤
│                    OPERADORES HUMANOS                        │
│     Ejecución autónoma + Criterio profesional + Feedback     │
└─────────────────────────────────────────────────────────────┘

🛠️ Stack Tecnológico

Tecnología	Versión	Propósito
Next.js	15+	App Router, SSR
React	19	Componentes UI
TypeScript	5.7+	Tipado Seguro
Tailwind CSS	v4	Estilos
Vercel	-	Despliegue

📦 Instalación

# Clonar repositorio
git clone https://github.com/devjaime/humanloop.git

# Instalar dependencias
cd humanloop
npm install

# Servidor de desarrollo
npm run dev

# Build de producción
npm run build

🌐 Deploy en Vercel

Conecta tu repositorio a Vercel
Vercel detectará automáticamente Next.js
Despliegue automático en cada push a main

📐 Marco Ético

Principio	Descripción
Supervisión humana siempre	El operador tiene la última palabra
Responsabilidad humana explícita	Humanos deciden, no solo ejecutan
IA como asistente, no jefe	La IA sugiere, el humano valida
Colaboración bidireccional	El feedback humano mejora la IA
Amplificación, no reemplazo	Potenciamos capacidades humanas
Compensación justa	Pago directo y transparente al operador

⚡ Skills Disponibles

HumanLoop incluye skills del mundo real que conectan la orquestación de IA con operadores humanos:

Skill	Comando	Descripción
Consultor de Negocios	`/business-consultant`	Conecta con un ingeniero de software para consultoría presencial
Servicio de Limpieza	`/cleaning-service`	Limpieza profesional de hogares y oficinas con IA
Servicio de Gasfitería	`/gasfiter-service`	Plomería y gas certificada en Chile (SEC)
Instalador IoT/Seguridad	`/iot-security-installer`	Instalación profesional de cámaras y dispositivos smart home

Ejemplo: Consultoría de Negocios

/business-consultant
Tema: Explicar arquitectura de microservicios a inversores
Ubicación: Las Condes, Santiago
Duración: 2 horas

Ejemplo: Servicio de Gasfitería

/gasfiter-service
Tipo: reparación
Problema: Fuga de agua en cocina
Ubicación: Las Condes, Santiago
Urgencia: urgente

Ejemplo: Instalación IoT

/iot-security-installer
Servicio: 4 cámaras IP + sistema NVR
Ubicación: Providencia
Propiedad: Casa residencial

🎬 Proyectos Demo y Videos Promocionales

Múltiples videos promocionales creados con Remotion:

Demo	Descripción
`airbnb-cleaning`	Demo de automatización de limpieza para propiedades Airbnb
`vocari-videos`	Videos promocionales para plataforma vocacional

# Vista previa de demos
npm run remotion:preview

# Renderizar demo específico
npm run remotion:render -- --props '{"video":"Video1Colegios"}'

📁 Project Structure / Estructura del Proyecto

humanloop/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # Root layout
│   │   ├── page.tsx        # Home page
│   │   ├── blog/           # Blog section
│   │   └── globals.css     # Global styles + Tailwind v4 theme
│   ├── components/
│   │   ├── Navbar.tsx      # Navigation + Language switcher
│   │   ├── Hero.tsx        # Hero section
│   │   ├── HowItWorks.tsx  # HITL flow explanation
│   │   ├── Services.tsx    # Skills/capabilities
│   │   ├── Scenarios.tsx   # Use case examples
│   │   ├── MCPSection.tsx  # Technical architecture
│   │   ├── EthicsFramework.tsx  # Ethical principles
│   │   ├── Pricing.tsx     # Compensation model
│   │   ├── ConceptBanner.tsx    # POC explanation
│   │   └── Footer.tsx      # Footer
│   ├── content/
│   │   ├── en.ts           # English translations
│   │   └── es.ts           # Spanish translations
│   └── context/
│       └── LanguageContext.tsx  # i18n provider
├── skills/
│   ├── business-consultant/
│   │   └── SKILL.md        # Business consulting skill
│   ├── cleaning-service/
│   │   └── SKILL.md        # Cleaning service skill
│   ├── gasfiter-service/
│   │   └── SKILL.md        # Plumbing/gas service skill
│   └── iot-security-installer/
│       └── SKILL.md        # IoT installation skill
├── demos/
│   ├── airbnb-cleaning/    # Airbnb cleaning automation demo
│   └── vocari-videos/      # Vocari.cl promotional videos
├── out/                    # Rendered video output
├── package.json
├── vercel.json             # Vercel configuration
├── render-videos.sh        # Video rendering script
└── README.md

🤝 Contributing / Contribuir

This is a proof of concept. Contributions, issues, and feature requests are welcome!

Este es un proof of concept. ¡Contribuciones, issues y solicitudes de features son bienvenidas!

📄 License / Licencia

MIT License - Educational and demonstrative use.

Licencia MIT - Uso educativo y demostrativo.

Made with AI + Human collaboration in Chile 🇨🇱

Hecho con colaboración IA + Humanos en Chile 🇨🇱

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
data		data
demos		demos
docs		docs
public		public
scrapers		scrapers
skills		skills
src		src
supabase		supabase
.gitignore		.gitignore
.nvmrc		.nvmrc
CLAUDE.md		CLAUDE.md
README.md		README.md
SPEC.md		SPEC.md
TECHNICAL_ROADMAP.md		TECHNICAL_ROADMAP.md
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.mjs		postcss.config.mjs
render-videos.sh		render-videos.sh
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

HumanLoop.cl

🇺🇸 English

🚀 What is HumanLoop?

💡 The Problem We Solve

🏗️ Architecture

🛠️ Tech Stack

📦 Installation

🌐 Deploy to Vercel

📐 Ethical Framework

⚡ Available Skills

Example: Business Consulting

Example: Gasfiter Service

Example: IoT Installation

🎬 Demo Projects & Promotional Videos

🇪🇸 Español

🚀 ¿Qué es HumanLoop?

💡 El Problema que Resolvemos

🏗️ Arquitectura

🛠️ Stack Tecnológico

📦 Instalación

🌐 Deploy en Vercel

📐 Marco Ético

⚡ Skills Disponibles

Ejemplo: Consultoría de Negocios

Ejemplo: Servicio de Gasfitería

Ejemplo: Instalación IoT

🎬 Proyectos Demo y Videos Promocionales

📁 Project Structure / Estructura del Proyecto

🤝 Contributing / Contribuir

📄 License / Licencia

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages