Skip to main content
Humancheck Open Source is the core package that you can self-host for complete control over your data, deployment, and customization.

Installation

Install the core package:
Or install from source:

Base URL

When self-hosting, use your own base URL:

Features

Core HITL Functionality

  • Review Management: Create, track, and manage review requests
  • Decision Making: Approve, reject, or modify actions
  • Feedback System: Rate and comment on reviews
  • Attachments: Upload and preview files (images, documents, code)
  • Framework Adapters: REST API, MCP, LangChain, Mastra
  • Basic Routing: Simple config-based routing rules (YAML)
  • Connectors: Slack, Email, Webhook notifications
  • Dashboard: Streamlit-based review interface
  • Statistics: Basic review analytics

Self-Hosted Benefits

  • Full Control: Complete control over data and deployment
  • Customizable: Modify and extend as needed
  • Open Source: MIT licensed
  • No Vendor Lock-in: Your data, your infrastructure

Getting Started

1. Install

2. Initialize Configuration

This creates a humancheck.yaml configuration file.

3. Start the Services

This launches:

4. Make Your First Request

Configuration

Edit humancheck.yaml to customize:

Deployment

Docker Deployment

Production Deployment

For production, we recommend:
  1. Use PostgreSQL instead of SQLite
  2. Enable authentication with API keys
  3. Set up reverse proxy (nginx, Traefik, etc.)
  4. Configure SSL/TLS certificates
  5. Set up monitoring and logging

Self-Hosting Options

Docker

Deploy using Docker containers

Kubernetes

Deploy on Kubernetes clusters

Cloud VMs

Deploy on AWS, GCP, Azure VMs

On-Premise

Deploy on your own infrastructure

Customization

Since you’re self-hosting, you can:
  • Modify the source code
  • Add custom adapters
  • Create custom connectors
  • Extend the dashboard
  • Add custom routing logic
  • Integrate with your auth system

Differences from Platform

For advanced features like multi-tenancy, organizations, teams, dozens of built-in connectors, no-code integrations (n8n, Zapier, Gumloop), multi-user approval workflows, advanced webhooks, evals, and OAuth connectors, check out Humancheck Platform.

Configuration

Configure routing and reviewers in humancheck.yaml:

Next Steps