Welcome to HypLab

Open-source platform for understanding people, testing ideas, and safely rolling out what works—while protecting privacy.

HypLab is a powerful platform that enables organizations to:

• Create and manage detailed personas (B2B and B2C) with 100+ standardized fields
• Generate synthetic people records matching CDP (Customer Data Platform) standards
• Test scenarios with personas to extract insights and recommendations
• Track and validate persona insights with evidence-based metadata

• AI-Powered Persona Creation: Generate realistic personas and people using AI
• Multi-Tenant Architecture: Organization → Workspace hierarchy for agency/client use cases
• Flexible Data Model: 100+ standardized fields with support for custom fields
• Template System: Dynamic templates generated from onboarding data
• Workspace Isolation: Each workspace has its own people, personas, templates, and settings

For End Users

1. Sign Up - Create your account
2. Create Organization - Set up your first organization
3. Complete Onboarding - Answer questions about your use case
4. Generate Templates - System automatically creates 5 templates based on your onboarding
5. Generate People - Create people from templates and start building personas

For detailed instructions, see Getting Started.

For Self-Hosters

If you want to host HypLab yourself:

docker compose -f docker/docker-compose.yml up --build

Services:

• API Server - Express.js backend on port 4096
• Web Interface - Next.js frontend on port 4090
• Documentation - This site on port 4091
• Database - MongoDB on port 27018
• Cache - Redis on port 6380

For detailed setup instructions, see Installation.

User Guides

• Getting Started - Learn the basics
• Core Concepts - Understand the fundamentals
• People - Manage people records
• Personas - Create and manage personas

For Developers

• Prerequisites - Development setup for contributors
• LLM Setup - Configure AI providers
• Telemetry - Observability and monitoring